diff options
Diffstat (limited to 'docs/libnm/html/NMSettingConnection.html')
| -rw-r--r-- | docs/libnm/html/NMSettingConnection.html | 600 |
1 files changed, 34 insertions, 566 deletions
diff --git a/docs/libnm/html/NMSettingConnection.html b/docs/libnm/html/NMSettingConnection.html index 9a77adbe..26337e4b 100644 --- a/docs/libnm/html/NMSettingConnection.html +++ b/docs/libnm/html/NMSettingConnection.html @@ -16,8 +16,7 @@ <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#NMSettingConnection.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> - <a href="#NMSettingConnection.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> - <a href="#NMSettingConnection.properties" class="shortcut">Properties</a></span> + <a href="#NMSettingConnection.object-hierarchy" class="shortcut">Object Hierarchy</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="ch03.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> @@ -323,152 +322,6 @@ </table></div> </div> <div class="refsect1"> -<a name="NMSettingConnection.properties"></a><h2>Properties</h2> -<div class="informaltable"><table class="informaltable" border="0"> -<colgroup> -<col width="150px" class="properties_type"> -<col width="300px" class="properties_name"> -<col width="200px" class="properties_flags"> -</colgroup> -<tbody> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--auth-retries" title="The “auth-retries” property">auth-retries</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect" title="The “autoconnect” property">autoconnect</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-priority" title="The “autoconnect-priority” property">autoconnect-priority</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-retries" title="The “autoconnect-retries” property">autoconnect-retries</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a class="link" href="NMSettingConnection.html#NMSettingConnectionAutoconnectSlaves" title="enum NMSettingConnectionAutoconnectSlaves"><span class="type">NMSettingConnectionAutoconnectSlaves</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-slaves" title="The “autoconnect-slaves” property">autoconnect-slaves</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--gateway-ping-timeout" title="The “gateway-ping-timeout” property">gateway-ping-timeout</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--id" title="The “id” property">id</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--interface-name" title="The “interface-name” property">interface-name</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--lldp" title="The “lldp” property">lldp</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--llmnr" title="The “llmnr” property">llmnr</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--master" title="The “master” property">master</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--mdns" title="The “mdns” property">mdns</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a class="link" href="libnm-nm-dbus-interface.html#NMMetered" title="enum NMMetered"><span class="type">NMMetered</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--metered" title="The “metered” property">metered</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--mud-url" title="The “mud-url” property">mud-url</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--multi-connect" title="The “multi-connect” property">multi-connect</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property">permissions</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--read-only" title="The “read-only” property">read-only</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--secondaries" title="The “secondaries” property">secondaries</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--slave-type" title="The “slave-type” property">slave-type</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--stable-id" title="The “stable-id” property">stable-id</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--timestamp" title="The “timestamp” property">timestamp</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--type" title="The “type” property">type</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--uuid" title="The “uuid” property">uuid</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"><span class="type">int</span></td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--wait-device-timeout" title="The “wait-device-timeout” property">wait-device-timeout</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<span class="type">char</span> *</td> -<td class="property_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection--zone" title="The “zone” property">zone</a></td> -<td class="property_flags">Read / Write</td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect1"> <a name="NMSettingConnection.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> @@ -608,10 +461,6 @@ <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="NMSettingConnection.html#NMSettingConnectionLlmnr" title="enum NMSettingConnectionLlmnr">NMSettingConnectionLlmnr</a></td> </tr> -<tr> -<td class="datatype_keyword"> </td> -<td class="function_name"><a class="link" href="NMSettingConnection.html#NMSettingConnection-struct" title="NMSettingConnection">NMSettingConnection</a></td> -</tr> </tbody> </table></div> </div> @@ -622,9 +471,6 @@ <span class="lineart">├──</span> NMSettingConnectionLldp <span class="lineart">├──</span> NMSettingConnectionLlmnr <span class="lineart">╰──</span> NMSettingConnectionMdns - <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> - <span class="lineart">╰──</span> <a class="link" href="NMSetting.html" title="NMSetting">NMSetting</a> - <span class="lineart">╰──</span> NMSettingConnection </pre> </div> <div class="refsect1"> @@ -651,7 +497,7 @@ nm_setting_connection_new (<em class="parameter"><code><span class="type">void</ <a name="nm-setting-connection-get-id"></a><h3>nm_setting_connection_get_id ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_id (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--id" title="The “id” property"><span class="type">“id”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--id"><span class="type">“id”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-id.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -677,7 +523,7 @@ nm_setting_connection_get_id (<em class="parameter"><code><a class="link" href=" <a name="nm-setting-connection-get-uuid"></a><h3>nm_setting_connection_get_uuid ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_uuid (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--uuid" title="The “uuid” property"><span class="type">“uuid”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--uuid"><span class="type">“uuid”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-uuid.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -703,7 +549,7 @@ nm_setting_connection_get_uuid (<em class="parameter"><code><a class="link" href <a name="nm-setting-connection-get-stable-id"></a><h3>nm_setting_connection_get_stable_id ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_stable_id (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--stable-id" title="The “stable-id” property"><span class="type">“stable_id”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--stable-id"><span class="type">“stable_id”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-stable-id.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -731,7 +577,7 @@ nm_setting_connection_get_stable_id (<em class="parameter"><code><a class="link" <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_interface_name (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--interface-name" title="The “interface-name” property"><span class="type">“interface-name”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--interface-name"><span class="type">“interface-name”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-interface-name.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -758,7 +604,7 @@ nm_setting_connection_get_interface_name <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_connection_type (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--type" title="The “type” property"><span class="type">“type”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--type"><span class="type">“type”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-connection-type.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -784,7 +630,7 @@ nm_setting_connection_get_connection_type <a name="nm-setting-connection-get-autoconnect"></a><h3>nm_setting_connection_get_autoconnect ()</h3> <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_connection_get_autoconnect (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect" title="The “autoconnect” property"><span class="type">“autoconnect”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--autoconnect"><span class="type">“autoconnect”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-autoconnect.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -811,7 +657,7 @@ nm_setting_connection_get_autoconnect (<em class="parameter"><code><a class="lin <pre class="programlisting"><span class="returnvalue">int</span> nm_setting_connection_get_autoconnect_priority (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-priority" title="The “autoconnect-priority” property"><span class="type">“autoconnect-priority”</span></a> property of the connection. +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--autoconnect-priority"><span class="type">“autoconnect-priority”</span></a> property of the connection. The higher number, the higher priority.</p> <div class="refsect3"> <a name="nm-setting-connection-get-autoconnect-priority.parameters"></a><h4>Parameters</h4> @@ -839,7 +685,7 @@ The higher number, the higher priority.</p> <pre class="programlisting"><span class="returnvalue">int</span> nm_setting_connection_get_autoconnect_retries (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-retries" title="The “autoconnect-retries” property"><span class="type">“autoconnect-retries”</span></a> property of the connection. +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--autoconnect-retries"><span class="type">“autoconnect-retries”</span></a> property of the connection. Zero means infinite, -1 means the global default value.</p> <div class="refsect3"> <a name="nm-setting-connection-get-autoconnect-retries.parameters"></a><h4>Parameters</h4> @@ -885,7 +731,7 @@ nm_setting_connection_get_multi_connect </div> <div class="refsect3"> <a name="nm-setting-connection-get-multi-connect.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingConnection.html#NMSettingConnection--multi-connect" title="The “multi-connect” property"><span class="type">“multi-connect”</span></a> property of the connection.</p> +<p> the <a href="NMSettingConnection.html#NMSettingConnection--multi-connect"><span class="type">“multi-connect”</span></a> property of the connection.</p> </div> <p class="since">Since: 1.14</p> </div> @@ -894,7 +740,7 @@ nm_setting_connection_get_multi_connect <a name="nm-setting-connection-get-timestamp"></a><h3>nm_setting_connection_get_timestamp ()</h3> <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a> nm_setting_connection_get_timestamp (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--timestamp" title="The “timestamp” property"><span class="type">“timestamp”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--timestamp"><span class="type">“timestamp”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-timestamp.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -920,7 +766,7 @@ nm_setting_connection_get_timestamp (<em class="parameter"><code><a class="link" <a name="nm-setting-connection-get-read-only"></a><h3>nm_setting_connection_get_read_only ()</h3> <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> nm_setting_connection_get_read_only (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--read-only" title="The “read-only” property"><span class="type">“read-only”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--read-only"><span class="type">“read-only”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-read-only.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -947,7 +793,7 @@ nm_setting_connection_get_read_only (<em class="parameter"><code><a class="link" <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> nm_setting_connection_get_num_permissions (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the number of entries in the <a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property"><span class="type">“permissions”</span></a> +<p>Returns the number of entries in the <a href="NMSettingConnection.html#NMSettingConnection--permissions"><span class="type">“permissions”</span></a> property of this setting.</p> <div class="refsect3"> <a name="nm-setting-connection-get-num-permissions.parameters"></a><h4>Parameters</h4> @@ -978,7 +824,7 @@ nm_setting_connection_get_permission (<em class="parameter"><code><a class="link <em class="parameter"><code>const <span class="type">char</span> **out_ptype</code></em>, <em class="parameter"><code>const <span class="type">char</span> **out_pitem</code></em>, <em class="parameter"><code>const <span class="type">char</span> **out_detail</code></em>);</pre> -<p>Retrieve one of the entries of the <a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property"><span class="type">“permissions”</span></a> property +<p>Retrieve one of the entries of the <a href="NMSettingConnection.html#NMSettingConnection--permissions"><span class="type">“permissions”</span></a> property of this setting.</p> <div class="refsect3"> <a name="nm-setting-connection-get-permission.parameters"></a><h4>Parameters</h4> @@ -1009,7 +855,7 @@ unless the entry is invalid, in which case it returns "invalid".</p></td> <td class="parameter_name"><p>out_pitem</p></td> <td class="parameter_description"><p>on return, the permission item (formatted according to <em class="parameter"><code>ptype</code></em> , see -<a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property"><span class="type">“permissions”</span></a> for more detail</p></td> +<a href="NMSettingConnection.html#NMSettingConnection--permissions"><span class="type">“permissions”</span></a> for more detail</p></td> <td class="parameter_annotations"> </td> </tr> <tr> @@ -1031,7 +877,7 @@ was invalid</p> <a name="nm-setting-connection-get-zone"></a><h3>nm_setting_connection_get_zone ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_zone (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--zone" title="The “zone” property"><span class="type">“zone”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--zone"><span class="type">“zone”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-zone.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1099,7 +945,7 @@ nm_setting_connection_add_permission (<em class="parameter"><code><a class="link <p>Adds a permission to the connection's permission list. At this time, only the "user" permission type is supported, and <em class="parameter"><code>pitem</code></em> must be a username. See -<a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property"><span class="type">“permissions”</span></a>: for more details.</p> +<a href="NMSettingConnection.html#NMSettingConnection--permissions"><span class="type">“permissions”</span></a>: for more details.</p> <div class="refsect3"> <a name="nm-setting-connection-add-permission.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1188,7 +1034,7 @@ nm_setting_connection_remove_permission_by_value <p>Removes the permission from the connection. At this time, only the "user" permission type is supported, and <em class="parameter"><code>pitem</code></em> must -be a username. See <a class="link" href="NMSettingConnection.html#NMSettingConnection--permissions" title="The “permissions” property"><span class="type">“permissions”</span></a>: for more details.</p> +be a username. See <a href="NMSettingConnection.html#NMSettingConnection--permissions"><span class="type">“permissions”</span></a>: for more details.</p> <div class="refsect3"> <a name="nm-setting-connection-remove-permission-by-value.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1232,7 +1078,7 @@ be a username. See <a class="link" href="NMSettingConnection.html#NMSettingConne <a name="nm-setting-connection-get-master"></a><h3>nm_setting_connection_get_master ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_master (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--master" title="The “master” property"><span class="type">“master”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--master"><span class="type">“master”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-master.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1295,7 +1141,7 @@ against <em class="parameter"><code>setting</code></em> <a name="nm-setting-connection-get-slave-type"></a><h3>nm_setting_connection_get_slave_type ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_slave_type (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--slave-type" title="The “slave-type” property"><span class="type">“slave-type”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--slave-type"><span class="type">“slave-type”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-slave-type.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1322,7 +1168,7 @@ nm_setting_connection_get_slave_type (<em class="parameter"><code><a class="link <pre class="programlisting"><a class="link" href="NMSettingConnection.html#NMSettingConnectionAutoconnectSlaves" title="enum NMSettingConnectionAutoconnectSlaves"><span class="returnvalue">NMSettingConnectionAutoconnectSlaves</span></a> nm_setting_connection_get_autoconnect_slaves (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-slaves" title="The “autoconnect-slaves” property"><span class="type">“autoconnect-slaves”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--autoconnect-slaves"><span class="type">“autoconnect-slaves”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-autoconnect-slaves.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1393,7 +1239,9 @@ nm_setting_connection_get_secondary (<em class="parameter"><code><a class="link" </tr> <tr> <td class="parameter_name"><p>idx</p></td> -<td class="parameter_description"><p>the zero-based index of the secondary connection UUID entry</p></td> +<td class="parameter_description"><p>the zero-based index of the secondary connection UUID entry. +Access one past the length of secondaries is ok and will return +<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Otherwise, it is a user error.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> @@ -1402,7 +1250,9 @@ nm_setting_connection_get_secondary (<em class="parameter"><code><a class="link" <div class="refsect3"> <a name="nm-setting-connection-get-secondary.returns"></a><h4>Returns</h4> <p> the secondary connection UUID at index <em class="parameter"><code>idx</code></em> -</p> +or +<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>idx</code></em> +is the number of secondaries.</p> </div> </div> <hr> @@ -1531,7 +1381,7 @@ nm_setting_connection_get_gateway_ping_timeout </div> <div class="refsect3"> <a name="nm-setting-connection-get-gateway-ping-timeout.returns"></a><h4>Returns</h4> -<p> the value contained in the <a class="link" href="NMSettingConnection.html#NMSettingConnection--gateway-ping-timeout" title="The “gateway-ping-timeout” property"><span class="type">“gateway-ping-timeout”</span></a> +<p> the value contained in the <a href="NMSettingConnection.html#NMSettingConnection--gateway-ping-timeout"><span class="type">“gateway-ping-timeout”</span></a> property.</p> </div> </div> @@ -1557,7 +1407,7 @@ nm_setting_connection_get_metered (<em class="parameter"><code><a class="link" h </div> <div class="refsect3"> <a name="nm-setting-connection-get-metered.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingConnection.html#NMSettingConnection--metered" title="The “metered” property"><span class="type">“metered”</span></a> property of the setting.</p> +<p> the <a href="NMSettingConnection.html#NMSettingConnection--metered"><span class="type">“metered”</span></a> property of the setting.</p> </div> <p class="since">Since: 1.2</p> </div> @@ -1566,7 +1416,7 @@ nm_setting_connection_get_metered (<em class="parameter"><code><a class="link" h <a name="nm-setting-connection-get-lldp"></a><h3>nm_setting_connection_get_lldp ()</h3> <pre class="programlisting"><a class="link" href="NMSettingConnection.html#NMSettingConnectionLldp" title="enum NMSettingConnectionLldp"><span class="returnvalue">NMSettingConnectionLldp</span></a> nm_setting_connection_get_lldp (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the <a class="link" href="NMSettingConnection.html#NMSettingConnection--lldp" title="The “lldp” property"><span class="type">“lldp”</span></a> property of the connection.</p> +<p>Returns the <a href="NMSettingConnection.html#NMSettingConnection--lldp"><span class="type">“lldp”</span></a> property of the connection.</p> <div class="refsect3"> <a name="nm-setting-connection-get-lldp.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1595,7 +1445,7 @@ enabled for the connection.</p> <pre class="programlisting"><span class="returnvalue">int</span> nm_setting_connection_get_auth_retries (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingConnection.html#NMSettingConnection--auth-retries" title="The “auth-retries” property"><span class="type">“auth-retries”</span></a> property.</p> +<p>Returns the value contained in the <a href="NMSettingConnection.html#NMSettingConnection--auth-retries"><span class="type">“auth-retries”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-connection-get-auth-retries.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1640,7 +1490,7 @@ nm_setting_connection_get_mdns (<em class="parameter"><code><a class="link" href </div> <div class="refsect3"> <a name="nm-setting-connection-get-mdns.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingConnection.html#NMSettingConnection--mdns" title="The “mdns” property"><span class="type">“mdns”</span></a> property of the setting.</p> +<p> the <a href="NMSettingConnection.html#NMSettingConnection--mdns"><span class="type">“mdns”</span></a> property of the setting.</p> </div> <p class="since">Since: 1.12</p> </div> @@ -1666,7 +1516,7 @@ nm_setting_connection_get_llmnr (<em class="parameter"><code><a class="link" hre </div> <div class="refsect3"> <a name="nm-setting-connection-get-llmnr.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingConnection.html#NMSettingConnection--llmnr" title="The “llmnr” property"><span class="type">“llmnr”</span></a> property of the setting.</p> +<p> the <a href="NMSettingConnection.html#NMSettingConnection--llmnr"><span class="type">“llmnr”</span></a> property of the setting.</p> </div> <p class="since">Since: 1.14</p> </div> @@ -1703,7 +1553,7 @@ the timeout in milliseconds. -1 is the default.</p> <a name="nm-setting-connection-get-mud-url"></a><h3>nm_setting_connection_get_mud_url ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_connection_get_mud_url (<em class="parameter"><code><a class="link" href="NMSettingConnection.html" title="NMSettingConnection"><span class="type">NMSettingConnection</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingConnection.html#NMSettingConnection--mud-url" title="The “mud-url” property"><span class="type">“mud-url”</span></a> +<p>Returns the value contained in the <a href="NMSettingConnection.html#NMSettingConnection--mud-url"><span class="type">“mud-url”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-connection-get-mud-url.parameters"></a><h4>Parameters</h4> @@ -2069,388 +1919,6 @@ master is activated</p> </div> <p class="since">Since: 1.14</p> </div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection-struct"></a><h3>NMSettingConnection</h3> -<pre class="programlisting">typedef struct _NMSettingConnection NMSettingConnection;</pre> -<p>General Connection Profile Settings</p> -</div> -</div> -<div class="refsect1"> -<a name="NMSettingConnection.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="NMSettingConnection--auth-retries"></a><h3>The <code class="literal">“auth-retries”</code> property</h3> -<pre class="programlisting"> “auth-retries” <span class="type">int</span></pre> -<p>The number of retries for the authentication. Zero means to try indefinitely; -1 means -to use a global default. If the global default is not set, the authentication -retries for 3 times before failing the connection.</p> -<p>Currently, this only applies to 802-1x authentication.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Allowed values: >= -1</p> -<p>Default value: -1</p> -<p class="since">Since: 1.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--autoconnect"></a><h3>The <code class="literal">“autoconnect”</code> property</h3> -<pre class="programlisting"> “autoconnect” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> -<p>Whether or not the connection should be automatically connected by -NetworkManager when the resources for the connection are available. -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to automatically activate the connection, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to require manual -intervention to activate the connection.</p> -<p>Note that autoconnect is not implemented for VPN profiles. See -<a class="link" href="NMSettingConnection.html#NMSettingConnection--secondaries" title="The “secondaries” property"><span class="type">“secondaries”</span></a> as an alternative to automatically -connect VPN profiles.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: TRUE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--autoconnect-priority"></a><h3>The <code class="literal">“autoconnect-priority”</code> property</h3> -<pre class="programlisting"> “autoconnect-priority” <span class="type">int</span></pre> -<p>The autoconnect priority. If the connection is set to autoconnect, -connections with higher priority will be preferred. Defaults to 0. -The higher number means higher priority.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Allowed values: [-999,999]</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--autoconnect-retries"></a><h3>The <code class="literal">“autoconnect-retries”</code> property</h3> -<pre class="programlisting"> “autoconnect-retries” <span class="type">int</span></pre> -<p>The number of times a connection should be tried when autoactivating before -giving up. Zero means forever, -1 means the global default (4 times if not -overridden). Setting this to 1 means to try activation only once before -blocking autoconnect. Note that after a timeout, NetworkManager will try -to autoconnect again.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Allowed values: >= -1</p> -<p>Default value: -1</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--autoconnect-slaves"></a><h3>The <code class="literal">“autoconnect-slaves”</code> property</h3> -<pre class="programlisting"> “autoconnect-slaves” <a class="link" href="NMSettingConnection.html#NMSettingConnectionAutoconnectSlaves" title="enum NMSettingConnectionAutoconnectSlaves"><span class="type">NMSettingConnectionAutoconnectSlaves</span></a></pre> -<p>Whether or not slaves of this connection should be automatically brought up -when NetworkManager activates this connection. This only has a real effect -for master connections. The properties <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect" title="The “autoconnect” property"><span class="type">“autoconnect”</span></a>, -<a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-priority" title="The “autoconnect-priority” property"><span class="type">“autoconnect-priority”</span></a> and <a class="link" href="NMSettingConnection.html#NMSettingConnection--autoconnect-retries" title="The “autoconnect-retries” property"><span class="type">“autoconnect-retries”</span></a> -are unrelated to this setting. -The permitted values are: 0: leave slave connections untouched, -1: activate all the slave connections with this connection, -1: default. -If -1 (default) is set, global connection.autoconnect-slaves is read to -determine the real value. If it is default as well, this fallbacks to 0.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT</p> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--gateway-ping-timeout"></a><h3>The <code class="literal">“gateway-ping-timeout”</code> property</h3> -<pre class="programlisting"> “gateway-ping-timeout” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> -<p>If greater than zero, delay success of IP addressing until either the -timeout is reached, or an IP gateway replies to a ping.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Allowed values: <= 600</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--id"></a><h3>The <code class="literal">“id”</code> property</h3> -<pre class="programlisting"> “id” <span class="type">char</span> *</pre> -<p>A human readable unique identifier for the connection, like "Work Wi-Fi" -or "T-Mobile 3G".</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--interface-name"></a><h3>The <code class="literal">“interface-name”</code> property</h3> -<pre class="programlisting"> “interface-name” <span class="type">char</span> *</pre> -<p>The name of the network interface this connection is bound to. If not -set, then the connection can be attached to any interface of the -appropriate type (subject to restrictions imposed by other settings).</p> -<p>For software devices this specifies the name of the created device.</p> -<p>For connection types where interface names cannot easily be made -persistent (e.g. mobile broadband or USB Ethernet), this property should -not be used. Setting this property restricts the interfaces a connection -can be used with, and if interface names change or are reordered the -connection may be applied to the wrong interface.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--lldp"></a><h3>The <code class="literal">“lldp”</code> property</h3> -<pre class="programlisting"> “lldp” <span class="type">int</span></pre> -<p>Whether LLDP is enabled for the connection.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: -1</p> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--llmnr"></a><h3>The <code class="literal">“llmnr”</code> property</h3> -<pre class="programlisting"> “llmnr” <span class="type">int</span></pre> -<p>Whether Link-Local Multicast Name Resolution (LLMNR) is enabled -for the connection. LLMNR is a protocol based on the Domain Name -System (DNS) packet format that allows both IPv4 and IPv6 hosts -to perform name resolution for hosts on the same local link.</p> -<p>The permitted values are: "yes" (2) register hostname and resolving -for the connection, "no" (0) disable LLMNR for the interface, "resolve" -(1) do not register hostname but allow resolving of LLMNR host names -If unspecified, "default" ultimately depends on the DNS plugin (which -for systemd-resolved currently means "yes").</p> -<p>This feature requires a plugin which supports LLMNR. Otherwise, the -setting has no effect. One such plugin is dns-systemd-resolved.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: -1</p> -<p class="since">Since: 1.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--master"></a><h3>The <code class="literal">“master”</code> property</h3> -<pre class="programlisting"> “master” <span class="type">char</span> *</pre> -<p>Interface name of the master device or UUID of the master connection.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--mdns"></a><h3>The <code class="literal">“mdns”</code> property</h3> -<pre class="programlisting"> “mdns” <span class="type">int</span></pre> -<p>Whether mDNS is enabled for the connection.</p> -<p>The permitted values are: "yes" (2) register hostname and resolving -for the connection, "no" (0) disable mDNS for the interface, "resolve" -(1) do not register hostname but allow resolving of mDNS host names -and "default" (-1) to allow lookup of a global default in NetworkManager.conf. -If unspecified, "default" ultimately depends on the DNS plugin (which -for systemd-resolved currently means "no").</p> -<p>This feature requires a plugin which supports mDNS. Otherwise, the -setting has no effect. One such plugin is dns-systemd-resolved.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: -1</p> -<p class="since">Since: 1.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--metered"></a><h3>The <code class="literal">“metered”</code> property</h3> -<pre class="programlisting"> “metered” <a class="link" href="libnm-nm-dbus-interface.html#NMMetered" title="enum NMMetered"><span class="type">NMMetered</span></a></pre> -<p>Whether the connection is metered.</p> -<p>When updating this property on a currently activated connection, -the change takes effect immediately.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NM_METERED_UNKNOWN</p> -<p class="since">Since: 1.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--mud-url"></a><h3>The <code class="literal">“mud-url”</code> property</h3> -<pre class="programlisting"> “mud-url” <span class="type">char</span> *</pre> -<p>If configured, set to a Manufacturer Usage Description (MUD) URL that points -to manufacturer-recommended network policies for IoT devices. It is transmitted -as a DHCPv4 or DHCPv6 option. The value must be a valid URL starting with "https://".</p> -<p>The special value "none" is allowed to indicate that no MUD URL is used.</p> -<p>If the per-profile value is unspecified (the default), a global connection default gets -consulted. If still unspecified, the ultimate default is "none".</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.26</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--multi-connect"></a><h3>The <code class="literal">“multi-connect”</code> property</h3> -<pre class="programlisting"> “multi-connect” <span class="type">int</span></pre> -<p>Specifies whether the profile can be active multiple times at a particular -moment. The value is of type <a class="link" href="libnm-nm-dbus-interface.html#NMConnectionMultiConnect" title="enum NMConnectionMultiConnect"><span class="type">NMConnectionMultiConnect</span></a>.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -<p class="since">Since: 1.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--permissions"></a><h3>The <code class="literal">“permissions”</code> property</h3> -<pre class="programlisting"> “permissions” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>An array of strings defining what access a given user has to this -connection. If this is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or empty, all users are allowed to access -this connection; otherwise users are allowed if and only if they are in -this list. When this is not empty, the connection can be active only when -one of the specified users is logged into an active session. Each entry -is of the form "[type]:[id]:[reserved]"; for example, "user:dcbw:blah".</p> -<p>At this time only the "user" [type] is allowed. Any other values are -ignored and reserved for future use. [id] is the username that this -permission refers to, which may not contain the ":" character. Any -[reserved] information present must be ignored and is reserved for future -use. All of [type], [id], and [reserved] must be valid UTF-8.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--read-only"></a><h3>The <code class="literal">“read-only”</code> property</h3> -<pre class="programlisting"> “read-only” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> -<p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the connection can be modified using the provided settings -service's D-Bus interface with the right privileges, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the -connection is read-only and cannot be modified.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--secondaries"></a><h3>The <code class="literal">“secondaries”</code> property</h3> -<pre class="programlisting"> “secondaries” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>List of connection UUIDs that should be activated when the base -connection itself is activated. Currently, only VPN connections are -supported.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--slave-type"></a><h3>The <code class="literal">“slave-type”</code> property</h3> -<pre class="programlisting"> “slave-type” <span class="type">char</span> *</pre> -<p>Setting name of the device type of this slave's master connection (eg, -<a class="link" href="NMSettingBond.html#NM-SETTING-BOND-SETTING-NAME:CAPS" title="NM_SETTING_BOND_SETTING_NAME"><code class="literal">NM_SETTING_BOND_SETTING_NAME</code></a>), or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if this connection is not a -slave.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--stable-id"></a><h3>The <code class="literal">“stable-id”</code> property</h3> -<pre class="programlisting"> “stable-id” <span class="type">char</span> *</pre> -<p>This represents the identity of the connection used for various purposes. -It allows to configure multiple profiles to share the identity. Also, -the stable-id can contain placeholders that are substituted dynamically and -deterministically depending on the context.</p> -<p>The stable-id is used for generating IPv6 stable private addresses -with ipv6.addr-gen-mode=stable-privacy. It is also used to seed the -generated cloned MAC address for ethernet.cloned-mac-address=stable -and wifi.cloned-mac-address=stable. It is also used as DHCP client -identifier with ipv4.dhcp-client-id=stable and to derive the DHCP -DUID with ipv6.dhcp-duid=stable-[llt,ll,uuid].</p> -<p>Note that depending on the context where it is used, other parameters are -also seeded into the generation algorithm. For example, a per-host key -is commonly also included, so that different systems end up generating -different IDs. Or with ipv6.addr-gen-mode=stable-privacy, also the device's -name is included, so that different interfaces yield different addresses. -The per-host key is the identity of your machine and stored in /var/lib/NetworkManager/secret-key.</p> -<p>The '$' character is treated special to perform dynamic substitutions -at runtime. Currently, supported are "${CONNECTION}", "${DEVICE}", "${MAC}", -"${BOOT}", "${RANDOM}". -These effectively create unique IDs per-connection, per-device, per-boot, -or every time. Note that "${DEVICE}" corresponds to the interface name of the -device and "${MAC}" is the permanent MAC address of the device. -Any unrecognized patterns following '$' are treated verbatim, however -are reserved for future use. You are thus advised to avoid '$' or -escape it as "$$". -For example, set it to "${CONNECTION}-${BOOT}-${DEVICE}" to create a unique id for -this connection that changes with every reboot and differs depending on the -interface where the profile activates.</p> -<p>If the value is unset, a global connection default is consulted. If the -value is still unset, the default is similar to "${CONNECTION}" and uses -a unique, fixed ID for the connection.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--timestamp"></a><h3>The <code class="literal">“timestamp”</code> property</h3> -<pre class="programlisting"> “timestamp” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a></pre> -<p>The time, in seconds since the Unix Epoch, that the connection was last -_successfully_ fully activated.</p> -<p>NetworkManager updates the connection timestamp periodically when the -connection is active to ensure that an active connection has the latest -timestamp. The property is only meant for reading (changes to this -property will not be preserved).</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--type"></a><h3>The <code class="literal">“type”</code> property</h3> -<pre class="programlisting"> “type” <span class="type">char</span> *</pre> -<p>Base type of the connection. For hardware-dependent connections, should -contain the setting name of the hardware-type specific setting (ie, -"802-3-ethernet" or "802-11-wireless" or "bluetooth", etc), and for -non-hardware dependent connections like VPN or otherwise, should contain -the setting name of that setting type (ie, "vpn" or "bridge", etc).</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--uuid"></a><h3>The <code class="literal">“uuid”</code> property</h3> -<pre class="programlisting"> “uuid” <span class="type">char</span> *</pre> -<p>A universally unique identifier for the connection, for example generated -with libuuid. It should be assigned when the connection is created, and -never changed as long as the connection still applies to the same -network. For example, it should not be changed when the -<a class="link" href="NMSettingConnection.html#NMSettingConnection--id" title="The “id” property"><span class="type">“id”</span></a> property or <a class="link" href="NMSettingIP4Config.html" title="NMSettingIP4Config"><span class="type">NMSettingIP4Config</span></a> changes, but -might need to be re-created when the Wi-Fi SSID, mobile broadband network -provider, or <a class="link" href="NMSettingConnection.html#NMSettingConnection--type" title="The “type” property"><span class="type">“type”</span></a> property changes.</p> -<p>The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" -(ie, contains only hexadecimal characters and "-"). A suitable UUID may -be generated by <a class="link" href="libnm-nm-utils.html#nm-utils-uuid-generate" title="nm_utils_uuid_generate ()"><code class="function">nm_utils_uuid_generate()</code></a> or -<code class="function">nm_utils_uuid_generate_from_string()</code>.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--wait-device-timeout"></a><h3>The <code class="literal">“wait-device-timeout”</code> property</h3> -<pre class="programlisting"> “wait-device-timeout” <span class="type">int</span></pre> -<p>Timeout in milliseconds to wait for device at startup. -During boot, devices may take a while to be detected by the driver. -This property will cause to delay NetworkManager-wait-online.service -and nm-online to give the device a chance to appear. This works by -waiting for the given timeout until a compatible device for the -profile is available and managed.</p> -<p>The value 0 means no wait time. The default value is -1, which -currently has the same meaning as no wait time.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Allowed values: >= -1</p> -<p>Default value: -1</p> -<p class="since">Since: 1.20</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingConnection--zone"></a><h3>The <code class="literal">“zone”</code> property</h3> -<pre class="programlisting"> “zone” <span class="type">char</span> *</pre> -<p>The trust level of a the connection. Free form case-insensitive string -(for example "Home", "Work", "Public"). <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or unspecified zone means -the connection will be placed in the default zone as defined by the -firewall.</p> -<p>When updating this property on a currently activated connection, -the change takes effect immediately.</p> -<p>Owner: NMSettingConnection</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> </div> </div> <div class="footer"> |