From d6201f5d8daada3d64a0a3e0038e14eebec683ce Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Wed, 3 Aug 2016 22:59:23 +0200 Subject: Imported Upstream version 1.2.4 --- docs/api/Makefile.in | 1 + docs/api/html/NetworkManager.conf.html | 29 +++++++++++++---- docs/api/html/NetworkManager.devhelp2 | 3 ++ docs/api/html/NetworkManager.html | 29 ++++++++++++++--- ...s-org.freedesktop.NetworkManager.IP4Config.html | 10 ++++++ ...s-org.freedesktop.NetworkManager.IP6Config.html | 10 ++++++ .../html/gdbus-org.freedesktop.NetworkManager.html | 38 ++++++++++++++++++++++ docs/api/html/index.html | 2 +- docs/api/html/index.sgml | 3 ++ docs/api/html/ix01.html | 6 ++++ docs/api/html/nm-settings.html | 12 +++++++ docs/api/html/nmcli-examples.html | 3 +- docs/api/html/ref-settings.html | 12 +++++++ docs/api/settings-spec.xml | 2 ++ docs/api/version.xml | 2 +- 15 files changed, 148 insertions(+), 14 deletions(-) (limited to 'docs/api') diff --git a/docs/api/Makefile.in b/docs/api/Makefile.in index 7407f4fa..bc388a41 100644 --- a/docs/api/Makefile.in +++ b/docs/api/Makefile.in @@ -274,6 +274,7 @@ NEWT_LIBS = @NEWT_LIBS@ NM = @NM@ NMEDIT = @NMEDIT@ NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT = @NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT@ +NM_CONFIG_DEFAULT_DNS_RC_MANAGER = @NM_CONFIG_DEFAULT_DNS_RC_MANAGER@ NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT = @NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT@ NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT = @NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT@ NM_MAJOR_VERSION = @NM_MAJOR_VERSION@ diff --git a/docs/api/html/NetworkManager.conf.html b/docs/api/html/NetworkManager.conf.html index 0c05211a..828776ff 100644 --- a/docs/api/html/NetworkManager.conf.html +++ b/docs/api/html/NetworkManager.conf.html @@ -64,6 +64,10 @@ This file is not intended to be modified by the user, but it is read last and can shadow user configuration from NetworkManager.conf.

+

+ Certain settings from the configuration can be reloaded at runtime either by sending SIGHUP signal or via + D-Bus' Reload call. +

File Format

@@ -296,7 +300,8 @@ no-auto-default=* configuration with DNSSEC support. The /etc/resolv.conf will be managed by dnssec-trigger daemon.

none: NetworkManager will not - modify resolv.conf.

+ modify resolv.conf. This implies rc-manager + unmanaged

@@ -304,17 +309,25 @@ no-auto-default=*

Set the resolv.conf management mode. The default value depends on how NetworkManager - was built. Regardless of this setting, NetworkManager will + was built, whereas this version of NetworkManager was build with + a default of "symlink". + Regardless of this setting, NetworkManager will always write resolv.conf to its runtime state directory.

-

none: NetworkManager will symlink +

symlink: NetworkManager will symlink /etc/resolv.conf to its private resolv.conf file in the runtime state directory.

file: NetworkManager will write - /etc/resolv.conf as file.

+ /etc/resolv.conf as file. If it finds + a symlink, it will follow the symlink and update the target + instead.

resolvconf: NetworkManager will run resolvconf to update the DNS configuration.

netconfig: NetworkManager will run netconfig to update the DNS configuration.

+

unmanaged: don't touch + resolv.conf.

+

none: deprecated alias for + symlink.

@@ -363,7 +376,7 @@ no-auto-default=*

path

The location where keyfiles are read and stored. - This defaults to "/etc/NetworkManager/conf.d". + This defaults to "${prefix}/etc/NetworkManager/conf.d".

@@ -649,8 +662,10 @@ ipv6.ip6-privacy=1 considered even if the property in question is not present. In the example above, if [connection-wifi-wlan0] would have stop-match set to yes, - its ipv6.ip6-privacy value would be - unspecified. + the device wlan0 would have ipv6.ip6-privacy + property unspecified. That is, the search for the property would not continue + in the connection sections [connection-wifi-other] + or [connection].

diff --git a/docs/api/html/NetworkManager.devhelp2 b/docs/api/html/NetworkManager.devhelp2 index 850ff2e2..c0e6a7af 100644 --- a/docs/api/html/NetworkManager.devhelp2 +++ b/docs/api/html/NetworkManager.devhelp2 @@ -61,6 +61,7 @@ + @@ -317,6 +318,7 @@ + @@ -328,6 +330,7 @@ + diff --git a/docs/api/html/NetworkManager.html b/docs/api/html/NetworkManager.html index 835a7e66..5467a3a8 100644 --- a/docs/api/html/NetworkManager.html +++ b/docs/api/html/NetworkManager.html @@ -436,26 +436,47 @@ The signal causes a reload of NetworkManager's configuration. Note that not all configuration parameters can be changed at runtime and therefore some changes may be applied only after - the next restart of the daemon. The signal also forces a - rewrite of DNS configuration. + the next restart of the daemon. + A SIGHUP also involves further reloading actions, like doing + a DNS update and restarting the DNS plugin. The latter can be + useful for example when using the dnsmasq plugin and changing + its configuration in /etc/NetworkManager/dnsmasq.d. However, + it also means this will shortly interrupt name resolution. + In the future, there may be further actions added. + A SIGHUP means to update NetworkManager configuration and reload + everything that is supported. Note that this does not reload + connections from disk. For that there is a D-Bus API and + nmcli's reload action

SIGUSR1

- The signal forces a rewrite of DNS configuration. + The signal forces a rewrite of DNS configuration. Contrary to + SIGHUP, this does not restart the DNS plugin and will not interrupt + name resolution. + In the future, further actions may be added. A SIGUSR1 + means to write out data like resolv.conf, or refresh a cache. + It is a subset of what is done for SIGHUP without reloading + configuration from disk.

SIGUSR2

- The signal has no effect at the moment. + The signal has no effect at the moment but is reserved for future + use.

+

+ An alternative to a signal to reload configuration is the Reload D-Bus call. + It allows for more fine-grained selection of what to reload, it only returns + after the reload is complete, and it is guarded by PolicyKit. +

DEBUGGING

diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html index fd291730..5f2615cf 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html @@ -51,6 +51,7 @@ Domains readable as Searches readable as DnsOptions readable as +DnsPriority readable i WinsServers readable au
@@ -173,6 +174,15 @@ DnsOptions readable as
+

The "DnsPriority" property

+
+DnsPriority  readable   i
+
+

The relative priority of DNS servers. +

+
+
+

The "WinsServers" property

 WinsServers  readable   au
diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP6Config.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP6Config.html
index 9bd4562a..65995603 100644
--- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP6Config.html
+++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP6Config.html
@@ -51,6 +51,7 @@
 Domains      readable   as
 Searches     readable   as
 DnsOptions   readable   as
+DnsPriority  readable   i
@@ -165,6 +166,15 @@ DnsOptions readable as resolv.conf(5) manual page for the list of supported options.

+
+
+

The "DnsPriority" property

+
+DnsPriority  readable   i
+
+

The relative priority of DNS servers. +

+
diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.html index c72f1e26..f97d5301 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.html @@ -36,6 +36,7 @@

Methods

+Reload                   (IN  u         flags);
 GetDevices               (OUT ao        devices);
 GetAllDevices            (OUT ao        devices);
 GetDeviceByIpIface       (IN  s         iface,
@@ -102,6 +103,43 @@
 

 
Method Details

 

+
The Reload() method

+
+Reload (IN  u flags);
+

+
        Reload NetworkManager's configuration and perform certain updates, like flushing a cache or
+        rewriting external state to disk. This is similar to sending SIGHUP to NetworkManager but it
+        allows for more fine-grained control over what to reload (see flags). It also allows
+        non-root access via PolicyKit and contrary to signals it is synchronous.
+

+
        No flags (0x00) means to reload everything that is supported which is identical to
+        sending a SIGHUP.
+        (0x01) means to reload the NetworkManager.conf configuration from disk. Note that this
+        does not include connections, which can be reloaded via Setting's ReloadConnections.
+        (0x02) means to update DNS configuration, which usually involves writing /etc/resolv.conf
+        anew.
+        (0x04) means to restart the DNS plugin. This is for example useful when using
+        dnsmasq plugin, which uses additional configuration in /etc/NetworkManager/dnsmasq.d.
+        If you edit those files, you can restart the DNS plugin. This action shortly interrupts
+        rename resolution.
+        Note that flags may affect each other. For example, restarting the DNS plugin (0x04)
+        implicitly updates DNS too (0x02). Or when reloading the configuration (0x01), changes
+        to DNS setting also cause a DNS update (0x02). However, (0x01) does not involve restarting
+        the DNS plugin (0x02), unless an entirely different plugin is selected.
+

+

++++
+
+
+
+
+




IN u flags:
optional flags to specify which parts shall be reloaded.

+

+

+

 
The GetDevices() method

 
 GetDevices (OUT ao devices);
diff --git a/docs/api/html/index.html b/docs/api/html/index.html
index 15870791..59c5412e 100644
--- a/docs/api/html/index.html
+++ b/docs/api/html/index.html
@@ -14,7 +14,7 @@
 

 

 

-
Version 1.2.2
+
Version 1.2.4
 

 
Copyright © 2012, 2013, 2014, 2015, 2016 The NetworkManager Authors

 

diff --git a/docs/api/html/index.sgml b/docs/api/html/index.sgml
index 49e4a4c1..3ffc813b 100644
--- a/docs/api/html/index.sgml
+++ b/docs/api/html/index.sgml
@@ -53,6 +53,7 @@
 
 
 
+
 
 
 
@@ -430,6 +431,7 @@
 
 
 
+
 
 
 
@@ -445,6 +447,7 @@
 
 
 
+
 
 
 
diff --git a/docs/api/html/ix01.html b/docs/api/html/ix01.html
index c74a0c5f..9b0fe805 100644
--- a/docs/api/html/ix01.html
+++ b/docs/api/html/ix01.html
@@ -350,6 +350,8 @@
 
 
org.freedesktop.NetworkManager.IP4Config:DnsOptions, The "DnsOptions" property
 

+
org.freedesktop.NetworkManager.IP4Config:DnsPriority, The "DnsPriority" property
+

 
org.freedesktop.NetworkManager.IP4Config:Domains, The "Domains" property
 

 
org.freedesktop.NetworkManager.IP4Config:Gateway, The "Gateway" property
@@ -374,6 +376,8 @@
 

 
org.freedesktop.NetworkManager.IP6Config:DnsOptions, The "DnsOptions" property
 

+
org.freedesktop.NetworkManager.IP6Config:DnsPriority, The "DnsPriority" property
+

 
org.freedesktop.NetworkManager.IP6Config:Domains, The "Domains" property
 

 
org.freedesktop.NetworkManager.IP6Config:Gateway, The "Gateway" property
@@ -573,6 +577,8 @@
 

 
org.freedesktop.NetworkManager.GetPermissions(), The GetPermissions() method
 

+
org.freedesktop.NetworkManager.Reload(), The Reload() method
+

 
org.freedesktop.NetworkManager.SetLogging(), The SetLogging() method
 

 
org.freedesktop.NetworkManager.Sleep(), The Sleep() method
diff --git a/docs/api/html/nm-settings.html b/docs/api/html/nm-settings.html
index b677ece9..4b300bc7 100644
--- a/docs/api/html/nm-settings.html
+++ b/docs/api/html/nm-settings.html
@@ -1128,6 +1128,12 @@
 Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties.
 
 
+dns-priority
+int32
+0
+DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf.  A lower value means that servers will be on top of the file.  Zero selects the default value, which is 50 for VPNs and 100 for other connections.  When multiple devices have configurations with the same priority, the one with an active default route will be preferred.  Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used.
+
+
 dns-search
 array of string
 []
@@ -1267,6 +1273,12 @@
 Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties.
 
 
+dns-priority
+int32
+0
+DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf.  A lower value means that servers will be on top of the file.  Zero selects the default value, which is 50 for VPNs and 100 for other connections.  When multiple devices have configurations with the same priority, the one with an active default route will be preferred.  Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used.
+
+
 dns-search
 array of string
 []
diff --git a/docs/api/html/nmcli-examples.html b/docs/api/html/nmcli-examples.html
index 3e9d0b52..41c3cac7 100644
--- a/docs/api/html/nmcli-examples.html
+++ b/docs/api/html/nmcli-examples.html
@@ -127,7 +127,8 @@ org.freedesktop.NetworkManager.wifi.share.protected       yes
 org.freedesktop.NetworkManager.wifi.share.open            yes
 org.freedesktop.NetworkManager.settings.modify.system     yes
 org.freedesktop.NetworkManager.settings.modify.own        yes
-org.freedesktop.NetworkManager.settings.modify.hostname   auth

+org.freedesktop.NetworkManager.settings.modify.hostname   auth
+org.freedesktop.NetworkManager.reload                     no

This command shows configured polkit permissions for various NetworkManager operations. These permissions or actions (using polkit language) are configured diff --git a/docs/api/html/ref-settings.html b/docs/api/html/ref-settings.html index ab610728..fe268fe0 100644 --- a/docs/api/html/ref-settings.html +++ b/docs/api/html/ref-settings.html @@ -1083,6 +1083,12 @@ Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties. +

dns-priority
+
int32
+
0
+DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf. A lower value means that servers will be on top of the file. Zero selects the default value, which is 50 for VPNs and 100 for other connections. When multiple devices have configurations with the same priority, the one with an active default route will be preferred. Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used. + + 
dns-search
array of string
[]
@@ -1223,6 +1229,12 @@ Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties. +
dns-priority
+
int32
+
0
+DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf. A lower value means that servers will be on top of the file. Zero selects the default value, which is 50 for VPNs and 100 for other connections. When multiple devices have configurations with the same priority, the one with an active default route will be preferred. Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used. + + 
dns-search
array of string
[]
diff --git a/docs/api/settings-spec.xml b/docs/api/settings-spec.xml index 8bcbf25e..22398ad1 100644 --- a/docs/api/settings-spec.xml +++ b/docs/api/settings-spec.xml @@ -158,6 +158,7 @@ dhcp-timeoutint320A timeout for a DHCP transaction in seconds. dnsarray of uint32[]Array of IP addresses of DNS servers (as network-byte-order integers) dns-optionsarray of string[]Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties. + dns-priorityint320DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf. A lower value means that servers will be on top of the file. Zero selects the default value, which is 50 for VPNs and 100 for other connections. When multiple devices have configurations with the same priority, the one with an active default route will be preferred. Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used. dns-searcharray of string[]Array of DNS search domains. gatewaystringThe gateway associated with this configuration. This is only meaningful if "addresses" is also set. ignore-auto-dnsbooleanFALSEWhen "method" is set to "auto" and this property to TRUE, automatically configured nameservers and search domains are ignored and only nameservers and search domains specified in the "dns" and "dns-search" properties, if any, are used. @@ -180,6 +181,7 @@ dhcp-timeoutint320A timeout for a DHCP transaction in seconds. dnsarray of byte array[]Array of IP addresses of DNS servers (in network byte order) dns-optionsarray of string[]Array of DNS options. NULL means that the options are unset and left at the default. In this case NetworkManager will use default options. This is distinct from an empty list of properties. + dns-priorityint320DNS priority. The relative priority to be used when determining the order of DNS servers in resolv.conf. A lower value means that servers will be on top of the file. Zero selects the default value, which is 50 for VPNs and 100 for other connections. When multiple devices have configurations with the same priority, the one with an active default route will be preferred. Note that when using dns=dnsmasq the order is meaningless since dnsmasq forwards queries to all known servers at the same time. Negative values have the special effect of excluding other configurations with a greater priority value; so in presence of at least a negative priority, only DNS servers from configurations with the lowest priority value will be used. dns-searcharray of string[]Array of DNS search domains. gatewaystringThe gateway associated with this configuration. This is only meaningful if "addresses" is also set. ignore-auto-dnsbooleanFALSEWhen "method" is set to "auto" and this property to TRUE, automatically configured nameservers and search domains are ignored and only nameservers and search domains specified in the "dns" and "dns-search" properties, if any, are used. diff --git a/docs/api/version.xml b/docs/api/version.xml index 23aa8390..e8ea05db 100644 --- a/docs/api/version.xml +++ b/docs/api/version.xml @@ -1 +1 @@ -1.2.2 +1.2.4 -- cgit 1.3.0-6-gf8a5