|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
|
|
Packit Service |
b23acc |
]>
|
|
Packit Service |
b23acc |
<refentry id="gdbus-org.freedesktop.NetworkManager.Settings">
|
|
Packit Service |
b23acc |
<refmeta> <refentrytitle role="top_of_page" id="gdbus-interface-org-freedesktop-NetworkManager-Settings.top_of_page">org.freedesktop.NetworkManager.Settings</refentrytitle>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-interface-org-freedesktop-NetworkManager-Settings.top_of_page"><primary sortas=".Settings">org.freedesktop.NetworkManager.Settings</primary></indexterm>
|
|
Packit Service |
b23acc |
</refmeta> <refnamediv> <refname>org.freedesktop.NetworkManager.Settings</refname> <refpurpose>Connection Settings Profile Manager</refpurpose> </refnamediv> <refsynopsisdiv role="synopsis">
|
|
Packit Service |
b23acc |
<title role="synopsis.title">Methods</title>
|
|
Packit Service |
b23acc |
<synopsis>
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.ListConnections">ListConnections</link> (OUT ao connections);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.GetConnectionByUuid">GetConnectionByUuid</link> (IN s uuid,
|
|
Packit Service |
b23acc |
OUT o connection);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection">AddConnection</link> (IN a{sa{sv}} connection,
|
|
Packit Service |
b23acc |
OUT o path);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnectionUnsaved">AddConnectionUnsaved</link> (IN a{sa{sv}} connection,
|
|
Packit Service |
b23acc |
OUT o path);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection2">AddConnection2</link> (IN a{sa{sv}} settings,
|
|
Packit Service |
b23acc |
IN u flags,
|
|
Packit Service |
b23acc |
IN a{sv} args,
|
|
Packit Service |
b23acc |
OUT o path,
|
|
Packit Service |
b23acc |
OUT a{sv} result);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.LoadConnections">LoadConnections</link> (IN as filenames,
|
|
Packit Service |
b23acc |
OUT b status,
|
|
Packit Service |
b23acc |
OUT as failures);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.ReloadConnections">ReloadConnections</link> (OUT b status);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings.SaveHostname">SaveHostname</link> (IN s hostname);
|
|
Packit Service |
b23acc |
</synopsis>
|
|
Packit Service |
b23acc |
</refsynopsisdiv>
|
|
Packit Service |
b23acc |
<refsect1 role="signal_proto">
|
|
Packit Service |
b23acc |
<title role="signal_proto.title">Signals</title>
|
|
Packit Service |
b23acc |
<synopsis>
|
|
Packit Service |
b23acc |
<link linkend="gdbus-signal-org-freedesktop-NetworkManager-Settings.PropertiesChanged">PropertiesChanged</link> (a{sv} properties);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-signal-org-freedesktop-NetworkManager-Settings.NewConnection">NewConnection</link> (o connection);
|
|
Packit Service |
b23acc |
<link linkend="gdbus-signal-org-freedesktop-NetworkManager-Settings.ConnectionRemoved">ConnectionRemoved</link> (o connection);
|
|
Packit Service |
b23acc |
</synopsis>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
<refsect1 role="properties">
|
|
Packit Service |
b23acc |
<title role="properties.title">Properties</title>
|
|
Packit Service |
b23acc |
<synopsis>
|
|
Packit Service |
b23acc |
<link linkend="gdbus-property-org-freedesktop-NetworkManager-Settings.Connections">Connections</link> readable ao
|
|
Packit Service |
b23acc |
<link linkend="gdbus-property-org-freedesktop-NetworkManager-Settings.Hostname">Hostname</link> readable s
|
|
Packit Service |
b23acc |
<link linkend="gdbus-property-org-freedesktop-NetworkManager-Settings.CanModify">CanModify</link> readable b
|
|
Packit Service |
b23acc |
</synopsis>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
<refsect1 role="desc" id="gdbus-interface-org-freedesktop-NetworkManager-Settings">
|
|
Packit Service |
b23acc |
<title role="desc.title">Description</title>
|
|
Packit Service |
b23acc |
<para> The Settings interface allows clients to view and administrate the
|
|
Packit Service |
b23acc |
connections stored and used by NetworkManager.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
<refsect1 role="details" id="gdbus-methods-org.freedesktop.NetworkManager.Settings">
|
|
Packit Service |
b23acc |
<title role="details.title">Method Details</title>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.ListConnections">
|
|
Packit Service |
b23acc |
<title>The ListConnections() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.ListConnections"><primary sortas=".Settings.ListConnections">org.freedesktop.NetworkManager.Settings.ListConnections()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
ListConnections (OUT ao connections);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> List the saved network connections known to NetworkManager.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT ao <parameter>connections</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>List of connections.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.GetConnectionByUuid">
|
|
Packit Service |
b23acc |
<title>The GetConnectionByUuid() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.GetConnectionByUuid"><primary sortas=".Settings.GetConnectionByUuid">org.freedesktop.NetworkManager.Settings.GetConnectionByUuid()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
GetConnectionByUuid (IN s uuid,
|
|
Packit Service |
b23acc |
OUT o connection);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Retrieve the object path of a connection, given that connection's UUID.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN s <parameter>uuid</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>The UUID to find the connection object path for.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT o <parameter>connection</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>The connection's object path.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection">
|
|
Packit Service |
b23acc |
<title>The AddConnection() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection"><primary sortas=".Settings.AddConnection">org.freedesktop.NetworkManager.Settings.AddConnection()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
AddConnection (IN a{sa{sv}} connection,
|
|
Packit Service |
b23acc |
OUT o path);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Add new connection and save it to disk. This operation does not start the
|
|
Packit Service |
b23acc |
network connection unless (1) device is idle and able to connect to the
|
|
Packit Service |
b23acc |
network described by the new connection, and (2) the connection is allowed
|
|
Packit Service |
b23acc |
to be started automatically.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN a{sa{sv}} <parameter>connection</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Connection settings and properties.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT o <parameter>path</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Object path of the new connection that was just added.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnectionUnsaved">
|
|
Packit Service |
b23acc |
<title>The AddConnectionUnsaved() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnectionUnsaved"><primary sortas=".Settings.AddConnectionUnsaved">org.freedesktop.NetworkManager.Settings.AddConnectionUnsaved()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
AddConnectionUnsaved (IN a{sa{sv}} connection,
|
|
Packit Service |
b23acc |
OUT o path);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Add new connection but do not save it to disk immediately. This operation
|
|
Packit Service |
b23acc |
does not start the network connection unless (1) device is idle and able
|
|
Packit Service |
b23acc |
to connect to the network described by the new connection, and (2) the
|
|
Packit Service |
b23acc |
connection is allowed to be started automatically. Use the 'Save' method
|
|
Packit Service |
b23acc |
on the connection to save these changes to disk.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN a{sa{sv}} <parameter>connection</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Connection settings and properties.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT o <parameter>path</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Object path of the new connection that was just added.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection2">
|
|
Packit Service |
b23acc |
<title>The AddConnection2() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.AddConnection2"><primary sortas=".Settings.AddConnection2">org.freedesktop.NetworkManager.Settings.AddConnection2()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
AddConnection2 (IN a{sa{sv}} settings,
|
|
Packit Service |
b23acc |
IN u flags,
|
|
Packit Service |
b23acc |
IN a{sv} args,
|
|
Packit Service |
b23acc |
OUT o path,
|
|
Packit Service |
b23acc |
OUT a{sv} result);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> "0x1" (to-disk),
|
|
Packit Service |
b23acc |
"0x2" (in-memory),
|
|
Packit Service |
b23acc |
"0x20" (block-autoconnect).
|
|
Packit Service |
b23acc |
Unknown flags cause the call to fail.
|
|
Packit Service |
b23acc |
<parameter>args</parameter>: optional arguments dictionary, for extensibility. Currently no
|
|
Packit Service |
b23acc |
arguments are accepted. Specifying unknown keys causes the call
|
|
Packit Service |
b23acc |
to fail.
|
|
Packit Service |
b23acc |
<parameter>path</parameter>: Object path of the new connection that was just added.
|
|
Packit Service |
b23acc |
<parameter>result</parameter>: output argument, currently no additional results are returned.
|
|
Packit Service |
b23acc |
</para><para> Add a new connection profile.
|
|
Packit Service |
b23acc |
</para><para> Either the flags 0x1 (to-disk) or 0x2 (in-memory) must be specified.
|
|
Packit Service |
b23acc |
The effect is whether to behave like AddConnection or AddConnectionUnsaved.
|
|
Packit Service |
b23acc |
If 0x20 (block-autoconnect) is specified, autoconnect for the new profile
|
|
Packit Service |
b23acc |
is blocked from the beginnin. Otherwise, the profile might automatically
|
|
Packit Service |
b23acc |
connect if a suitable device is around.
|
|
Packit Service |
b23acc |
</para><para> AddConnection2 is a extensible alternative to AddConnection, and AddConnectionUnsaved.
|
|
Packit Service |
b23acc |
The new variant can do everything that the older variants could, and more.
|
|
Packit Service |
b23acc |
</para><para> Since: 1.20
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN a{sa{sv}} <parameter>settings</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>New connection settings, properties, and (optionally) secrets.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN u <parameter>flags</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>optional flags argument. Currently the following flags are supported:</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN a{sv} <parameter>args</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para></para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT o <parameter>path</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para></para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT a{sv} <parameter>result</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para></para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.LoadConnections">
|
|
Packit Service |
b23acc |
<title>The LoadConnections() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.LoadConnections"><primary sortas=".Settings.LoadConnections">org.freedesktop.NetworkManager.Settings.LoadConnections()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
LoadConnections (IN as filenames,
|
|
Packit Service |
b23acc |
OUT b status,
|
|
Packit Service |
b23acc |
OUT as failures);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Note that before 1.20, NetworkManager had a bug and this <parameter>status</parameter> value was wrong. It is better to assume success if the method does not return with a D-Bus error. On top of that, you can look at <parameter>failures</parameter> to know whether any of the requested files failed.
|
|
Packit Service |
b23acc |
<parameter>failures</parameter>: Paths of connection files that could not be loaded.
|
|
Packit Service |
b23acc |
</para><para> Loads or reloads the indicated connections from disk. You should call this
|
|
Packit Service |
b23acc |
after making changes directly to an on-disk connection file to make sure
|
|
Packit Service |
b23acc |
that NetworkManager sees the changes.
|
|
Packit Service |
b23acc |
As with AddConnection(), this operation does not necessarily
|
|
Packit Service |
b23acc |
start the network connection.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN as <parameter>filenames</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Array of paths to on-disk connection profiles in directories monitored by NetworkManager.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT b <parameter>status</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Success or failure of the operation as a whole. True if NetworkManager at least tried to load the indicated connections, even if it did not succeed. False if an error occurred before trying to load the connections (eg, permission denied).</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT as <parameter>failures</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para></para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.ReloadConnections">
|
|
Packit Service |
b23acc |
<title>The ReloadConnections() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.ReloadConnections"><primary sortas=".Settings.ReloadConnections">org.freedesktop.NetworkManager.Settings.ReloadConnections()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
ReloadConnections (OUT b status);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Tells NetworkManager to reload all connection files from disk, including
|
|
Packit Service |
b23acc |
noticing any added or deleted connection files.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>OUT b <parameter>status</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>This always returns <constant>TRUE</constant>.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings.SaveHostname">
|
|
Packit Service |
b23acc |
<title>The SaveHostname() method</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings.SaveHostname"><primary sortas=".Settings.SaveHostname">org.freedesktop.NetworkManager.Settings.SaveHostname()</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
SaveHostname (IN s hostname);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Save the hostname to persistent configuration.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>IN s <parameter>hostname</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>The hostname to save to persistent configuration. If blank, the persistent hostname is cleared.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
<refsect1 role="details" id="gdbus-signals-org.freedesktop.NetworkManager.Settings">
|
|
Packit Service |
b23acc |
<title role="details.title">Signal Details</title>
|
|
Packit Service |
b23acc |
<refsect2 role="signal" id="gdbus-signal-org-freedesktop-NetworkManager-Settings.PropertiesChanged">
|
|
Packit Service |
b23acc |
<title>The "PropertiesChanged" signal</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-signal-org-freedesktop-NetworkManager-Settings.PropertiesChanged"><primary sortas=".Settings::PropertiesChanged">org.freedesktop.NetworkManager.Settings::PropertiesChanged</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
PropertiesChanged (a{sv} properties);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>a{sv} <parameter>properties</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>A dictionary mapping property names to variant boxed values</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="signal" id="gdbus-signal-org-freedesktop-NetworkManager-Settings.NewConnection">
|
|
Packit Service |
b23acc |
<title>The "NewConnection" signal</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-signal-org-freedesktop-NetworkManager-Settings.NewConnection"><primary sortas=".Settings::NewConnection">org.freedesktop.NetworkManager.Settings::NewConnection</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
NewConnection (o connection);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Emitted when a new connection has been added after NetworkManager has
|
|
Packit Service |
b23acc |
started up and initialized. This signal is not emitted for connections
|
|
Packit Service |
b23acc |
read while starting up, because NetworkManager's D-Bus service is only
|
|
Packit Service |
b23acc |
available after all connections have been read, and to prevent spamming
|
|
Packit Service |
b23acc |
listeners with too many signals at one time. To retrieve the initial
|
|
Packit Service |
b23acc |
connection list, call the ListConnections() method once, and then listen
|
|
Packit Service |
b23acc |
for individual Settings.NewConnection and Settings.Connection.Deleted
|
|
Packit Service |
b23acc |
signals for further updates.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>o <parameter>connection</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Object path of the new connection.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="signal" id="gdbus-signal-org-freedesktop-NetworkManager-Settings.ConnectionRemoved">
|
|
Packit Service |
b23acc |
<title>The "ConnectionRemoved" signal</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-signal-org-freedesktop-NetworkManager-Settings.ConnectionRemoved"><primary sortas=".Settings::ConnectionRemoved">org.freedesktop.NetworkManager.Settings::ConnectionRemoved</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
ConnectionRemoved (o connection);
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> Emitted when a connection is no longer available. This happens when the
|
|
Packit Service |
b23acc |
connection is deleted or if it is no longer accessible by any of the
|
|
Packit Service |
b23acc |
system's logged-in users. After receipt of this signal, the connection no
|
|
Packit Service |
b23acc |
longer exists and cannot be used. Also see the Settings.Connection.Removed
|
|
Packit Service |
b23acc |
signal.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
<variablelist role="params">
|
|
Packit Service |
b23acc |
<varlistentry>
|
|
Packit Service |
b23acc |
<term><literal>o <parameter>connection</parameter></literal>:</term>
|
|
Packit Service |
b23acc |
<listitem><para>Object path of the removed connection.</para></listitem>
|
|
Packit Service |
b23acc |
</varlistentry>
|
|
Packit Service |
b23acc |
</variablelist>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
<refsect1 role="details" id="gdbus-properties-org.freedesktop.NetworkManager.Settings">
|
|
Packit Service |
b23acc |
<title role="details.title">Property Details</title>
|
|
Packit Service |
b23acc |
<refsect2 role="property" id="gdbus-property-org-freedesktop-NetworkManager-Settings.Connections">
|
|
Packit Service |
b23acc |
<title>The "Connections" property</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-property-org-freedesktop-NetworkManager-Settings.Connections"><primary sortas=".Settings:Connections">org.freedesktop.NetworkManager.Settings:Connections</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
Connections readable ao
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> List of object paths of available network connection profiles.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="property" id="gdbus-property-org-freedesktop-NetworkManager-Settings.Hostname">
|
|
Packit Service |
b23acc |
<title>The "Hostname" property</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-property-org-freedesktop-NetworkManager-Settings.Hostname"><primary sortas=".Settings:Hostname">org.freedesktop.NetworkManager.Settings:Hostname</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
Hostname readable s
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> The machine hostname stored in persistent configuration.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
<refsect2 role="property" id="gdbus-property-org-freedesktop-NetworkManager-Settings.CanModify">
|
|
Packit Service |
b23acc |
<title>The "CanModify" property</title>
|
|
Packit Service |
b23acc |
<indexterm zone="gdbus-property-org-freedesktop-NetworkManager-Settings.CanModify"><primary sortas=".Settings:CanModify">org.freedesktop.NetworkManager.Settings:CanModify</primary></indexterm>
|
|
Packit Service |
b23acc |
<programlisting>
|
|
Packit Service |
b23acc |
CanModify readable b
|
|
Packit Service |
b23acc |
</programlisting>
|
|
Packit Service |
b23acc |
<para> If true, adding and modifying connections is supported.
|
|
Packit Service |
b23acc |
</para>
|
|
Packit Service |
b23acc |
</refsect2>
|
|
Packit Service |
b23acc |
</refsect1>
|
|
Packit Service |
b23acc |
</refentry>
|
|
Packit Service |
b23acc |
|