diff options
Diffstat (limited to 'docs/libnm/html/NMSettingWired.html')
| -rw-r--r-- | docs/libnm/html/NMSettingWired.html | 396 |
1 files changed, 59 insertions, 337 deletions
diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index d2976632..a27878e3 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.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="#NMSettingWired.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> - <a href="#NMSettingWired.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> - <a href="#NMSettingWired.properties" class="shortcut">Properties</a></span> + <a href="#NMSettingWired.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> @@ -94,6 +93,14 @@ </td> </tr> <tr> +<td class="function_type"> +<a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="returnvalue">NMTernary</span></a> +</td> +<td class="function_name"> +<a class="link" href="NMSettingWired.html#nm-setting-wired-get-accept-all-mac-addresses" title="nm_setting_wired_get_accept_all_mac_addresses ()">nm_setting_wired_get_accept_all_mac_addresses</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> @@ -241,96 +248,6 @@ </table></div> </div> <div class="refsect1"> -<a name="NMSettingWired.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"><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="NMSettingWired.html#NMSettingWired--auto-negotiate" title="The “auto-negotiate” property">auto-negotiate</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="NMSettingWired.html#NMSettingWired--cloned-mac-address" title="The “cloned-mac-address” property">cloned-mac-address</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="NMSettingWired.html#NMSettingWired--duplex" title="The “duplex” property">duplex</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="NMSettingWired.html#NMSettingWired--generate-mac-address-mask" title="The “generate-mac-address-mask” property">generate-mac-address-mask</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="NMSettingWired.html#NMSettingWired--mac-address" title="The “mac-address” property">mac-address</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="NMSettingWired.html#NMSettingWired--mac-address-blacklist" title="The “mac-address-blacklist” property">mac-address-blacklist</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="NMSettingWired.html#NMSettingWired--mtu" title="The “mtu” property">mtu</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="NMSettingWired.html#NMSettingWired--port" title="The “port” property">port</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="NMSettingWired.html#NMSettingWired--s390-nettype" title="The “s390-nettype” property">s390-nettype</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *</td> -<td class="property_name"><a class="link" href="NMSettingWired.html#NMSettingWired--s390-options" title="The “s390-options” property">s390-options</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="NMSettingWired.html#NMSettingWired--s390-subchannels" title="The “s390-subchannels” property">s390-subchannels</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="NMSettingWired.html#NMSettingWired--speed" title="The “speed” property">speed</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="NMSettingWired.html#NMSettingWired--wake-on-lan" title="The “wake-on-lan” property">wake-on-lan</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="NMSettingWired.html#NMSettingWired--wake-on-lan-password" title="The “wake-on-lan-password” property">wake-on-lan-password</a></td> -<td class="property_flags">Read / Write</td> -</tr> -</tbody> -</table></div> -</div> -<div class="refsect1"> <a name="NMSettingWired.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> @@ -403,8 +320,8 @@ <td class="function_name"><a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-PASSWORD:CAPS" title="NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD">NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD</a></td> </tr> <tr> -<td class="datatype_keyword"> </td> -<td class="function_name"><a class="link" href="NMSettingWired.html#NMSettingWired-struct" title="NMSettingWired">NMSettingWired</a></td> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-ACCEPT-ALL-MAC-ADDRESSES:CAPS" title="NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES">NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES</a></td> </tr> </tbody> </table></div> @@ -413,9 +330,6 @@ <a name="NMSettingWired.object-hierarchy"></a><h2>Object Hierarchy</h2> <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a> <span class="lineart">╰──</span> NMSettingWiredWakeOnLan - <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> NMSettingWired </pre> </div> <div class="refsect1"> @@ -458,7 +372,7 @@ nm_setting_wired_get_port (<em class="parameter"><code><a class="link" href="NMS </div> <div class="refsect3"> <a name="nm-setting-wired-get-port.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--port" title="The “port” property"><span class="type">“port”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--port"><span class="type">“port”</span></a> property of the setting</p> </div> </div> <hr> @@ -483,7 +397,7 @@ nm_setting_wired_get_speed (<em class="parameter"><code><a class="link" href="NM </div> <div class="refsect3"> <a name="nm-setting-wired-get-speed.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--speed" title="The “speed” property"><span class="type">“speed”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--speed"><span class="type">“speed”</span></a> property of the setting</p> </div> </div> <hr> @@ -508,7 +422,7 @@ nm_setting_wired_get_duplex (<em class="parameter"><code><a class="link" href="N </div> <div class="refsect3"> <a name="nm-setting-wired-get-duplex.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--duplex" title="The “duplex” property"><span class="type">“duplex”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--duplex"><span class="type">“duplex”</span></a> property of the setting</p> </div> </div> <hr> @@ -533,7 +447,7 @@ nm_setting_wired_get_auto_negotiate (<em class="parameter"><code><a class="link" </div> <div class="refsect3"> <a name="nm-setting-wired-get-auto-negotiate.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--auto-negotiate" title="The “auto-negotiate” property"><span class="type">“auto-negotiate”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--auto-negotiate"><span class="type">“auto-negotiate”</span></a> property of the setting</p> </div> </div> <hr> @@ -558,7 +472,7 @@ nm_setting_wired_get_mac_address (<em class="parameter"><code><a class="link" hr </div> <div class="refsect3"> <a name="nm-setting-wired-get-mac-address.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--mac-address" title="The “mac-address” property"><span class="type">“mac-address”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--mac-address"><span class="type">“mac-address”</span></a> property of the setting</p> </div> </div> <hr> @@ -584,11 +498,38 @@ nm_setting_wired_get_cloned_mac_address </div> <div class="refsect3"> <a name="nm-setting-wired-get-cloned-mac-address.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--cloned-mac-address" title="The “cloned-mac-address” property"><span class="type">“cloned-mac-address”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--cloned-mac-address"><span class="type">“cloned-mac-address”</span></a> property of the setting</p> </div> </div> <hr> <div class="refsect2"> +<a name="nm-setting-wired-get-accept-all-mac-addresses"></a><h3>nm_setting_wired_get_accept_all_mac_addresses ()</h3> +<pre class="programlisting"><a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary"><span class="returnvalue">NMTernary</span></a> +nm_setting_wired_get_accept_all_mac_addresses + (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>);</pre> +<div class="refsect3"> +<a name="nm-setting-wired-get-accept-all-mac-addresses.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>setting</p></td> +<td class="parameter_description"><p>the <a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="nm-setting-wired-get-accept-all-mac-addresses.returns"></a><h4>Returns</h4> +<p> the <span class="type">“accept-all-mac-addresses”</span> property of the setting</p> +</div> +<p class="since">Since: 1.32</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-setting-wired-get-generate-mac-address-mask"></a><h3>nm_setting_wired_get_generate_mac_address_mask ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_wired_get_generate_mac_address_mask @@ -610,7 +551,7 @@ nm_setting_wired_get_generate_mac_address_mask </div> <div class="refsect3"> <a name="nm-setting-wired-get-generate-mac-address-mask.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--generate-mac-address-mask" title="The “generate-mac-address-mask” property"><span class="type">“generate-mac-address-mask”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--generate-mac-address-mask"><span class="type">“generate-mac-address-mask”</span></a> property of the setting</p> </div> <p class="since">Since: 1.4</p> </div> @@ -637,7 +578,7 @@ nm_setting_wired_get_mac_address_blacklist </div> <div class="refsect3"> <a name="nm-setting-wired-get-mac-address-blacklist.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--mac-address-blacklist" title="The “mac-address-blacklist” property"><span class="type">“mac-address-blacklist”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--mac-address-blacklist"><span class="type">“mac-address-blacklist”</span></a> property of the setting</p> </div> </div> <hr> @@ -709,7 +650,7 @@ at index <em class="parameter"><code>idx</code></em> nm_setting_wired_add_mac_blacklist_item (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *mac</code></em>);</pre> -<p>Adds a new MAC address to the <a class="link" href="NMSettingWired.html#NMSettingWired--mac-address-blacklist" title="The “mac-address-blacklist” property"><span class="type">“mac-address-blacklist”</span></a> property.</p> +<p>Adds a new MAC address to the <a href="NMSettingWired.html#NMSettingWired--mac-address-blacklist"><span class="type">“mac-address-blacklist”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-wired-add-mac-blacklist-item.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -852,7 +793,7 @@ nm_setting_wired_get_mtu (<em class="parameter"><code><a class="link" href="NMSe </div> <div class="refsect3"> <a name="nm-setting-wired-get-mtu.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingWired.html#NMSettingWired--mtu" title="The “mtu” property"><span class="type">“mtu”</span></a> property of the setting</p> +<p> the <a href="NMSettingWired.html#NMSettingWired--mtu"><span class="type">“mtu”</span></a> property of the setting</p> </div> </div> <hr> @@ -977,14 +918,14 @@ such as during option iteration.</p> <td class="parameter_name"><p>out_key</p></td> <td class="parameter_description"><p>on return, the key name of the s390 specific option; this value is owned by the setting and should not be modified. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>out_value</p></td> <td class="parameter_description"><p>on return, the value of the key of the s390 specific option; this value is owned by the setting and should not be modified. </p></td> -<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> </tr> </tbody> </table></div> @@ -1041,10 +982,10 @@ setting; the value is owned by the setting and must not be modified</p> nm_setting_wired_add_s390_option (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>, <em class="parameter"><code>const <span class="type">char</span> *key</code></em>, <em class="parameter"><code>const <span class="type">char</span> *value</code></em>);</pre> -<p>Add an option to the table. The option is compared to an internal list -of allowed options. Key names may contain only alphanumeric characters -(ie [a-zA-Z0-9]). Adding a new key replaces any existing key/value pair that -may already exist.</p> +<p>Add an option to the table. If the key already exists, the value gets +replaced.</p> +<p>Before 1.32, the function would assert that the key is valid. Since then, +an invalid key gets silently added but renders the profile as invalid.</p> <div class="refsect3"> <a name="nm-setting-wired-add-s390-option.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1074,8 +1015,7 @@ may already exist.</p> </div> <div class="refsect3"> <a name="nm-setting-wired-add-s390-option.returns"></a><h4>Returns</h4> -<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the option was valid and was added to the internal option -list, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it was not.</p> +<p> since 1.32 this always returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p> </div> </div> <hr> @@ -1213,7 +1153,7 @@ nm_setting_wired_get_wake_on_lan_password <hr> <div class="refsect2"> <a name="NMSettingWiredWakeOnLan"></a><h3>enum NMSettingWiredWakeOnLan</h3> -<p>Options for <a class="link" href="NMSettingWired.html#NMSettingWired--wake-on-lan" title="The “wake-on-lan” property"><span class="type">“wake-on-lan”</span></a>. Note that not all options +<p>Options for <a href="NMSettingWired.html#NMSettingWired--wake-on-lan"><span class="type">“wake-on-lan”</span></a>. Note that not all options are supported by all devices.</p> <div class="refsect3"> <a name="NMSettingWiredWakeOnLan.members"></a><h4>Members</h4> @@ -1397,227 +1337,9 @@ incompatible with other flags</p> </div> <hr> <div class="refsect2"> -<a name="NMSettingWired-struct"></a><h3>NMSettingWired</h3> -<pre class="programlisting">typedef struct _NMSettingWired NMSettingWired;</pre> -<p>Wired Ethernet Settings</p> -</div> -</div> -<div class="refsect1"> -<a name="NMSettingWired.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="NMSettingWired--auto-negotiate"></a><h3>The <code class="literal">“auto-negotiate”</code> property</h3> -<pre class="programlisting"> “auto-negotiate” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> -<p>When <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, enforce auto-negotiation of speed and duplex mode. -If "speed" and "duplex" properties are both specified, only that -single mode will be advertised and accepted during the link -auto-negotiation process: this works only for BASE-T 802.3 specifications -and is useful for enforcing gigabits modes, as in these cases link -negotiation is mandatory. -When <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, "speed" and "duplex" properties should be both set or -link configuration will be skipped.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--cloned-mac-address"></a><h3>The <code class="literal">“cloned-mac-address”</code> property</h3> -<pre class="programlisting"> “cloned-mac-address” <span class="type">char</span> *</pre> -<p>If specified, request that the device use this MAC address instead. -This is known as MAC cloning or spoofing.</p> -<p>Beside explicitly specifying a MAC address, the special values "preserve", "permanent", -"random" and "stable" are supported. -"preserve" means not to touch the MAC address on activation. -"permanent" means to use the permanent hardware address if the device -has one (otherwise this is treated as "preserve"). -"random" creates a random MAC address on each connect. -"stable" creates a hashed MAC address based on connection.stable-id and a -machine dependent key.</p> -<p>If unspecified, the value can be overwritten via global defaults, see manual -of NetworkManager.conf. If still unspecified, it defaults to "preserve" -(older versions of NetworkManager may use a different default value).</p> -<p>On D-Bus, this field is expressed as "assigned-mac-address" or the deprecated -"cloned-mac-address".</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--duplex"></a><h3>The <code class="literal">“duplex”</code> property</h3> -<pre class="programlisting"> “duplex” <span class="type">char</span> *</pre> -<p>When a value is set, either "half" or "full", configures the device -to use the specified duplex mode. If "auto-negotiate" is "yes" the -specified duplex mode will be the only one advertised during link -negotiation: this works only for BASE-T 802.3 specifications and is -useful for enforcing gigabits modes, as in these cases link negotiation -is mandatory. -If the value is unset (the default), the link configuration will be -either skipped (if "auto-negotiate" is "no", the default) or will -be auto-negotiated (if "auto-negotiate" is "yes") and the local device -will advertise all the supported duplex modes. -Must be set together with the "speed" property if specified. -Before specifying a duplex mode be sure your device supports it.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--generate-mac-address-mask"></a><h3>The <code class="literal">“generate-mac-address-mask”</code> property</h3> -<pre class="programlisting"> “generate-mac-address-mask” <span class="type">char</span> *</pre> -<p>With <a class="link" href="NMSettingWired.html#NMSettingWired--cloned-mac-address" title="The “cloned-mac-address” property"><span class="type">“cloned-mac-address”</span></a> setting "random" or "stable", -by default all bits of the MAC address are scrambled and a locally-administered, -unicast MAC address is created. This property allows to specify that certain bits -are fixed. Note that the least significant bit of the first MAC address will -always be unset to create a unicast MAC address.</p> -<p>If the property is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it is eligible to be overwritten by a default -connection setting. If the value is still <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or an empty string, the -default is to create a locally-administered, unicast MAC address.</p> -<p>If the value contains one MAC address, this address is used as mask. The set -bits of the mask are to be filled with the current MAC address of the device, -while the unset bits are subject to randomization. -Setting "FE:FF:FF:00:00:00" means to preserve the OUI of the current MAC address -and only randomize the lower 3 bytes using the "random" or "stable" algorithm.</p> -<p>If the value contains one additional MAC address after the mask, -this address is used instead of the current MAC address to fill the bits -that shall not be randomized. For example, a value of -"FE:FF:FF:00:00:00 68:F7:28:00:00:00" will set the OUI of the MAC address -to 68:F7:28, while the lower bits are randomized. A value of -"02:00:00:00:00:00 00:00:00:00:00:00" will create a fully scrambled -globally-administered, burned-in MAC address.</p> -<p>If the value contains more than one additional MAC addresses, one of -them is chosen randomly. For example, "02:00:00:00:00:00 00:00:00:00:00:00 02:00:00:00:00:00" -will create a fully scrambled MAC address, randomly locally or globally -administered.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--mac-address"></a><h3>The <code class="literal">“mac-address”</code> property</h3> -<pre class="programlisting"> “mac-address” <span class="type">char</span> *</pre> -<p>If specified, this connection will only apply to the Ethernet device -whose permanent MAC address matches. This property does not change the -MAC address of the device (i.e. MAC spoofing).</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--mac-address-blacklist"></a><h3>The <code class="literal">“mac-address-blacklist”</code> property</h3> -<pre class="programlisting"> “mac-address-blacklist” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>If specified, this connection will never apply to the Ethernet device -whose permanent MAC address matches an address in the list. Each MAC -address is in the standard hex-digits-and-colons notation -(00:11:22:33:44:55).</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--mtu"></a><h3>The <code class="literal">“mtu”</code> property</h3> -<pre class="programlisting"> “mtu” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> -<p>If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--port"></a><h3>The <code class="literal">“port”</code> property</h3> -<pre class="programlisting"> “port” <span class="type">char</span> *</pre> -<p>Specific port type to use if the device supports multiple -attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit -Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface). -If the device supports only one port type, this setting is ignored.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--s390-nettype"></a><h3>The <code class="literal">“s390-nettype”</code> property</h3> -<pre class="programlisting"> “s390-nettype” <span class="type">char</span> *</pre> -<p>s390 network device type; one of "qeth", "lcs", or "ctc", representing -the different types of virtual network devices available on s390 systems.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--s390-options"></a><h3>The <code class="literal">“s390-options”</code> property</h3> -<pre class="programlisting"> “s390-options” <a href="https://developer.gnome.org/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *</pre> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--s390-subchannels"></a><h3>The <code class="literal">“s390-subchannels”</code> property</h3> -<pre class="programlisting"> “s390-subchannels” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>Identifies specific subchannels that this network device uses for -communication with z/VM or s390 host. Like the -<a class="link" href="NMSettingWired.html#NMSettingWired--mac-address" title="The “mac-address” property"><span class="type">“mac-address”</span></a> property for non-z/VM devices, this property -can be used to ensure this connection only applies to the network device -that uses these subchannels. The list should contain exactly 3 strings, -and each string may only be composed of hexadecimal characters and the -period (.) character.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--speed"></a><h3>The <code class="literal">“speed”</code> property</h3> -<pre class="programlisting"> “speed” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> -<p>When a value greater than 0 is set, configures the device to use -the specified speed. If "auto-negotiate" is "yes" the specified -speed will be the only one advertised during link negotiation: -this works only for BASE-T 802.3 specifications and is useful for -enforcing gigabit speeds, as in this case link negotiation is -mandatory. -If the value is unset (0, the default), the link configuration will be -either skipped (if "auto-negotiate" is "no", the default) or will -be auto-negotiated (if "auto-negotiate" is "yes") and the local device -will advertise all the supported speeds. -In Mbit/s, ie 100 == 100Mbit/s. -Must be set together with the "duplex" property when non-zero. -Before specifying a speed value be sure your device supports it.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingWired--wake-on-lan"></a><h3>The <code class="literal">“wake-on-lan”</code> property</h3> -<pre class="programlisting"> “wake-on-lan” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> -<p>The <a class="link" href="NMSettingWired.html#NMSettingWiredWakeOnLan" title="enum NMSettingWiredWakeOnLan"><span class="type">NMSettingWiredWakeOnLan</span></a> options to enable. Not all devices support all options. -May be any combination of <a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-PHY:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_PHY</code></a>, -<a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-UNICAST:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST</code></a>, <a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-MULTICAST:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST</code></a>, -<a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-BROADCAST:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST</code></a>, <a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-ARP:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_ARP</code></a>, -<a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-MAGIC:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC</code></a> or the special values -<a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-DEFAULT:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT</code></a> (to use global settings) and -<a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-WAKE-ON-LAN-IGNORE:CAPS"><code class="literal">NM_SETTING_WIRED_WAKE_ON_LAN_IGNORE</code></a> (to disable management of Wake-on-LAN in -NetworkManager).</p> -<p>Owner: NMSettingWired</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="NMSettingWired--wake-on-lan-password"></a><h3>The <code class="literal">“wake-on-lan-password”</code> property</h3> -<pre class="programlisting"> “wake-on-lan-password” <span class="type">char</span> *</pre> -<p>If specified, the password used with magic-packet-based -Wake-on-LAN, represented as an Ethernet MAC address. If <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, -no password will be required.</p> -<p>Owner: NMSettingWired</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.2</p> +<a name="NM-SETTING-WIRED-ACCEPT-ALL-MAC-ADDRESSES:CAPS"></a><h3>NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES</h3> +<pre class="programlisting">#define NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES "accept-all-mac-addresses" +</pre> </div> </div> </div> |