summary refs log tree commit diff
path: root/introspection/nm-manager.xml
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2016-08-03 22:59:23 +0200
committerMichael Biebl <biebl@debian.org>2016-08-03 22:59:23 +0200
commitd6201f5d8daada3d64a0a3e0038e14eebec683ce (patch)
tree035500728cc23e7ee5368c3fd605270265a077f7 /introspection/nm-manager.xml
parent73e152af6e3fb4f5848bfb8394484026ff119003 (diff)
Imported Upstream version 1.2.4 upstream/1.2.4
Diffstat (limited to 'introspection/nm-manager.xml')
-rw-r--r--introspection/nm-manager.xml28
1 files changed, 28 insertions, 0 deletions
diff --git a/introspection/nm-manager.xml b/introspection/nm-manager.xml
index e5cb23a5..ea368ba3 100644
--- a/introspection/nm-manager.xml
+++ b/introspection/nm-manager.xml
@@ -4,6 +4,34 @@
     <annotation name="org.gtk.GDBus.C.Name" value="Manager"/>
 
     <!--
+        Reload:
+        @flags: optional flags to specify which parts shall be reloaded.
+
+        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.
+    -->
+    <method name="Reload">
+      <arg name="flags" type="u" direction="in"/>
+    </method>
+
+    <!--
         GetDevices:
         @devices: List of object paths of network devices known to the system. This list does not include device placeholders (see GetAllDevices()).