Imported Upstream version 0.9.10.0 upstream/0.9.10.0

1 files changed, 57 insertions, 6 deletions

diff --git a/introspection/nm-settings-connection.xml b/introspection/nm-settings-connection.xml
index 9089b009..b5bd2cd0 100644
--- a/introspection/nm-settings-connection.xml
+++ b/introspection/nm-settings-connection.xml
@@ -9,10 +9,11 @@
 
         <method name="Update">
           <tp:docstring>
-            Update the connection with new settings and properties, replacing
-            all previous settings and properties.  Secrets may be part of the
-            update request, and will be either stored in persistent storage or
-            given to a Secret Agent for storage, depending on the request.
+            Update the connection with new settings and properties (replacing
+            all previous settings and properties) and save the connection to
+            disk.  Secrets may be part of the update request, and will be either
+            stored in persistent storage or sent to a Secret Agent for storage,
+            depending on the flags associated with each secret.
           </tp:docstring>
           <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_update"/>
           <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
@@ -23,6 +24,28 @@
           </arg>
         </method>
 
+        <method name="UpdateUnsaved">
+          <tp:docstring>
+            Update the connection with new settings and properties (replacing
+            all previous settings and properties) but do not immediately save
+            the connection to disk.  Secrets may be part of the update request
+            and may sent to a Secret Agent for storage, depending on the
+            flags associated with each secret.
+
+            Use the 'Save' method to save these changes to disk. Note
+            that unsaved changes will be lost if the connection is
+            reloaded from disk (either automatically on file change or
+            due to an explicit ReloadConnections call).
+          </tp:docstring>
+          <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_update_unsaved"/>
+          <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
+          <arg name="properties" type="a{sa{sv}}" direction="in">
+            <tp:docstring>
+              New connection settings, properties, and (optionally) secrets.
+            </tp:docstring>
+          </arg>
+        </method>
+
         <method name="Delete">
           <tp:docstring>
             Delete the connection.
@@ -70,6 +93,15 @@
             </arg>
         </method>
 
+        <method name="Save">
+            <tp:docstring>
+                Saves a "dirty" connection (that had previously been
+                updated with UpdateUnsaved) to persistent storage.
+            </tp:docstring>
+            <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_save"/>
+            <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
+        </method>
+
         <signal name="Updated">
             <tp:docstring>
                 Emitted when any settings or permissions change.  When handling
@@ -83,9 +115,28 @@
             <tp:docstring>
                 Emitted when this connection is no longer available.  This
                 happens when the connection is deleted or if it is no longer
-                accessable by any of the system's logged-in users.  After
-                receipt of this signal, the object no longer exists.
+                accessible by any of the system's logged-in users.  After
+                receipt of this signal, the object no longer exists.  Also
+                see the Settings.ConnectionRemoved signal.
+            </tp:docstring>
+        </signal>
+
+        <property name="Unsaved" type="b" access="read">
+            <tp:docstring>
+                If set, indicates that the in-memory state of the
+                connection does not match the on-disk state. This flag
+                will be set when UpdateUnsaved() is called or when any
+                connection details change, and cleared when the connection
+                is saved to disk via Save() or from internal operations.
             </tp:docstring>
+        </property>
+
+        <signal name="PropertiesChanged">
+            <arg name="properties" type="a{sv}" tp:type="String_Variant_Map">
+                <tp:docstring>
+                    A dictionary mapping property names to variant boxed values.
+                </tp:docstring>
+            </arg>
         </signal>
 
     </interface>