diff options
Diffstat (limited to 'introspection/nm-settings-connection.xml')
| -rw-r--r-- | introspection/nm-settings-connection.xml | 63 |
1 files changed, 57 insertions, 6 deletions
diff --git a/introspection/nm-settings-connection.xml b/introspection/nm-settings-connection.xml index 9089b009a..b5bd2cd0e 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> |