2007-08-03 16:10:04 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8" ?>
|
|
|
|
|
2008-02-28 02:07:21 +00:00
|
|
|
<node name="/" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
|
2007-08-03 16:10:04 +00:00
|
|
|
|
2010-08-07 05:07:44 +00:00
|
|
|
<interface name="org.freedesktop.NetworkManager.Settings.Connection">
|
2008-02-28 02:07:21 +00:00
|
|
|
<tp:docstring>
|
|
|
|
Represents a single network connection configuration.
|
|
|
|
</tp:docstring>
|
2008-08-27 02:57:21 +00:00
|
|
|
|
|
|
|
<method name="Update">
|
|
|
|
<tp:docstring>
|
2013-04-12 21:09:29 +00:00
|
|
|
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.
|
2008-08-27 02:57:21 +00:00
|
|
|
</tp:docstring>
|
2011-01-26 17:38:12 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_update"/>
|
2008-08-27 02:57:21 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
|
|
|
|
<arg name="properties" type="a{sa{sv}}" direction="in">
|
2008-02-28 02:07:21 +00:00
|
|
|
<tp:docstring>
|
2011-01-26 16:17:07 +00:00
|
|
|
New connection settings, properties, and (optionally) secrets.
|
2008-02-28 02:07:21 +00:00
|
|
|
</tp:docstring>
|
2008-08-27 02:57:21 +00:00
|
|
|
</arg>
|
2008-02-28 02:07:21 +00:00
|
|
|
</method>
|
2007-08-03 16:10:04 +00:00
|
|
|
|
2013-04-12 21:09:29 +00:00
|
|
|
<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
|
2014-03-25 16:40:47 +00:00
|
|
|
and may sent to a Secret Agent for storage, depending on the
|
2013-04-12 21:09:29 +00:00
|
|
|
flags associated with each secret.
|
2013-05-23 22:05:40 +00:00
|
|
|
|
|
|
|
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).
|
2013-04-12 21:09:29 +00:00
|
|
|
</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>
|
|
|
|
|
2008-08-27 02:57:21 +00:00
|
|
|
<method name="Delete">
|
|
|
|
<tp:docstring>
|
|
|
|
Delete the connection.
|
|
|
|
</tp:docstring>
|
2011-01-26 17:38:12 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_delete"/>
|
2008-05-09 06:33:30 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
|
2008-08-27 02:57:21 +00:00
|
|
|
</method>
|
2008-04-22 14:48:02 +00:00
|
|
|
|
2008-02-28 02:07:21 +00:00
|
|
|
<method name="GetSettings">
|
|
|
|
<tp:docstring>
|
2011-01-26 16:17:07 +00:00
|
|
|
Get the settings maps describing this network configuration.
|
|
|
|
This will never include any secrets required for connection
|
|
|
|
to the network, as those are often protected. Secrets must
|
|
|
|
be requested separately using the GetSecrets() call.
|
2008-02-28 02:07:21 +00:00
|
|
|
</tp:docstring>
|
2011-01-26 17:38:12 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_get_settings"/>
|
2011-03-04 18:51:05 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
|
2008-02-28 02:07:21 +00:00
|
|
|
<arg name="settings" type="a{sa{sv}}" direction="out" tp:type="String_String_Variant_Map_Map">
|
|
|
|
<tp:docstring>
|
|
|
|
The nested settings maps describing this object.
|
|
|
|
</tp:docstring>
|
|
|
|
</arg>
|
|
|
|
</method>
|
2007-08-03 16:10:04 +00:00
|
|
|
|
2008-02-28 02:07:21 +00:00
|
|
|
<method name="GetSecrets">
|
|
|
|
<tp:docstring>
|
2011-01-26 16:17:07 +00:00
|
|
|
Get the secrets belonging to this network configuration. Only
|
|
|
|
secrets from persistent storage or a Secret Agent running in
|
|
|
|
the requestor's session will be returned. The user will never
|
|
|
|
be prompted for secrets as a result of this request.
|
2008-02-28 02:07:21 +00:00
|
|
|
</tp:docstring>
|
2011-01-26 17:38:12 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_get_secrets"/>
|
2008-02-28 02:07:21 +00:00
|
|
|
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
|
|
|
|
<arg name="setting_name" type="s" direction="in">
|
|
|
|
<tp:docstring>
|
2011-01-26 16:17:07 +00:00
|
|
|
Name of the setting to return secrets for. If empty, all
|
|
|
|
all secrets will be returned.
|
2008-02-28 02:07:21 +00:00
|
|
|
</tp:docstring>
|
|
|
|
</arg>
|
2007-10-19 04:55:05 +00:00
|
|
|
|
2008-03-17 19:37:23 +00:00
|
|
|
<arg name="secrets" type="a{sa{sv}}" direction="out" tp:type="String_String_Variant_Map_Map">
|
2008-02-28 02:07:21 +00:00
|
|
|
<tp:docstring>
|
2011-01-26 16:17:07 +00:00
|
|
|
Nested settings maps containing secrets.
|
2008-02-28 02:07:21 +00:00
|
|
|
</tp:docstring>
|
|
|
|
</arg>
|
|
|
|
</method>
|
2007-08-03 16:10:04 +00:00
|
|
|
|
2014-09-11 08:07:47 +00:00
|
|
|
<method name="ClearSecrets">
|
|
|
|
<tp:docstring>
|
|
|
|
Clear the secrets belonging to this network connection profile.
|
|
|
|
</tp:docstring>
|
|
|
|
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_connection_clear_secrets"/>
|
|
|
|
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
|
|
|
|
</method>
|
|
|
|
|
2013-05-01 19:44:11 +00:00
|
|
|
<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>
|
|
|
|
|
2011-01-26 16:17:07 +00:00
|
|
|
<signal name="Updated">
|
|
|
|
<tp:docstring>
|
|
|
|
Emitted when any settings or permissions change. When handling
|
|
|
|
this signal, clients should re-read the connection using the
|
|
|
|
GetSettings method to get the changes and to ensure the client
|
|
|
|
still has permission to access the connection.
|
|
|
|
</tp:docstring>
|
|
|
|
</signal>
|
|
|
|
|
|
|
|
<signal name="Removed">
|
|
|
|
<tp:docstring>
|
|
|
|
Emitted when this connection is no longer available. This
|
|
|
|
happens when the connection is deleted or if it is no longer
|
2013-11-26 15:45:21 +00:00
|
|
|
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.
|
2011-01-26 16:17:07 +00:00
|
|
|
</tp:docstring>
|
|
|
|
</signal>
|
|
|
|
|
2013-04-11 23:53:54 +00:00
|
|
|
<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>
|
|
|
|
|
2014-01-27 16:26:08 +00:00
|
|
|
<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>
|
|
|
|
|
2008-02-28 02:07:21 +00:00
|
|
|
</interface>
|
2007-08-03 16:10:04 +00:00
|
|
|
|
|
|
|
</node>
|