diff options
Diffstat (limited to 'docs/libnm/html/NMSettingWired.html')
| -rw-r--r-- | docs/libnm/html/NMSettingWired.html | 192 |
1 files changed, 142 insertions, 50 deletions
diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index 568b9d5e..41bdca30 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -8,7 +8,7 @@ <link rel="up" href="ch03.html" title="Connection and Setting API Reference"> <link rel="prev" href="NMSettingWimax.html" title="NMSettingWimax"> <link rel="next" href="NMSettingWireless.html" title="NMSettingWireless"> -<meta name="generator" content="GTK-Doc V1.24 (XML mode)"> +<meta name="generator" content="GTK-Doc V1.25 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> @@ -94,6 +94,13 @@ </td> </tr> <tr> +<td class="function_type">const <span class="returnvalue">char</span> * +</td> +<td class="function_name"> +<a class="link" href="NMSettingWired.html#nm-setting-wired-get-generate-mac-address-mask" title="nm_setting_wired_get_generate_mac_address_mask ()">nm_setting_wired_get_generate_mac_address_mask</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> <td class="function_type">const <span class="returnvalue">char</span> * const * </td> <td class="function_name"> @@ -262,6 +269,12 @@ <tr> <td class="property_type"> <span class="type">gchar</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">gchar</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> @@ -359,6 +372,10 @@ </tr> <tr> <td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-GENERATE-MAC-ADDRESS-MASK:CAPS" title="NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK">NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> <td class="function_name"><a class="link" href="NMSettingWired.html#NM-SETTING-WIRED-MAC-ADDRESS-BLACKLIST:CAPS" title="NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST">NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST</a></td> </tr> <tr> @@ -414,7 +431,7 @@ necessary for connection to Ethernet networks.</p> nm_setting_wired_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> <p>Creates a new <a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> object with default values.</p> <div class="refsect3"> -<a name="id-1.4.33.8.2.5"></a><h4>Returns</h4> +<a name="nm-setting-wired-new.returns"></a><h4>Returns</h4> <p> the new empty <a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> object. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> @@ -425,7 +442,7 @@ nm_setting_wired_new (<em class="parameter"><code><span class="type">void</span> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_wired_get_port (<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="id-1.4.33.8.3.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-port.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -440,7 +457,7 @@ nm_setting_wired_get_port (<em class="parameter"><code><a class="link" href="NMS </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.3.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -450,7 +467,7 @@ nm_setting_wired_get_port (<em class="parameter"><code><a class="link" href="NMS <pre class="programlisting"><span class="returnvalue">guint32</span> nm_setting_wired_get_speed (<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="id-1.4.33.8.4.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-speed.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -465,7 +482,7 @@ nm_setting_wired_get_speed (<em class="parameter"><code><a class="link" href="NM </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.4.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -475,7 +492,7 @@ nm_setting_wired_get_speed (<em class="parameter"><code><a class="link" href="NM <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_wired_get_duplex (<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="id-1.4.33.8.5.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-duplex.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -490,7 +507,7 @@ nm_setting_wired_get_duplex (<em class="parameter"><code><a class="link" href="N </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.5.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -500,7 +517,7 @@ nm_setting_wired_get_duplex (<em class="parameter"><code><a class="link" href="N <pre class="programlisting"><span class="returnvalue">gboolean</span> nm_setting_wired_get_auto_negotiate (<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="id-1.4.33.8.6.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-auto-negotiate.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -515,7 +532,7 @@ nm_setting_wired_get_auto_negotiate (<em class="parameter"><code><a class="link" </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.6.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -525,7 +542,7 @@ nm_setting_wired_get_auto_negotiate (<em class="parameter"><code><a class="link" <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_wired_get_mac_address (<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="id-1.4.33.8.7.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-mac-address.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -540,7 +557,7 @@ nm_setting_wired_get_mac_address (<em class="parameter"><code><a class="link" hr </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.7.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -551,7 +568,7 @@ nm_setting_wired_get_mac_address (<em class="parameter"><code><a class="link" hr nm_setting_wired_get_cloned_mac_address (<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="id-1.4.33.8.8.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-cloned-mac-address.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -566,18 +583,45 @@ nm_setting_wired_get_cloned_mac_address </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.8.5"></a><h4>Returns</h4> +<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> </div> </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 + (<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-generate-mac-address-mask.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table 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-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> +</div> +<p class="since">Since: 1.4</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-setting-wired-get-mac-address-blacklist"></a><h3>nm_setting_wired_get_mac_address_blacklist ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * const * nm_setting_wired_get_mac_address_blacklist (<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="id-1.4.33.8.9.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-mac-address-blacklist.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -592,7 +636,7 @@ nm_setting_wired_get_mac_address_blacklist </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.9.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -603,7 +647,7 @@ nm_setting_wired_get_mac_address_blacklist nm_setting_wired_get_num_mac_blacklist_items (<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="id-1.4.33.8.10.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-num-mac-blacklist-items.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -618,7 +662,7 @@ nm_setting_wired_get_num_mac_blacklist_items </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.10.5"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-num-mac-blacklist-items.returns"></a><h4>Returns</h4> <p> the number of blacklisted MAC addresses</p> </div> </div> @@ -630,7 +674,7 @@ nm_setting_wired_get_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><span class="type">guint32</span> idx</code></em>);</pre> <div class="refsect3"> -<a name="id-1.4.33.8.11.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-mac-blacklist-item.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -652,7 +696,7 @@ nm_setting_wired_get_mac_blacklist_item </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.11.5"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-mac-blacklist-item.returns"></a><h4>Returns</h4> <p> the blacklisted MAC address string (hex-digits-and-colons notation) at index <em class="parameter"><code>idx</code></em> </p> @@ -667,7 +711,7 @@ nm_setting_wired_add_mac_blacklist_item <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> <div class="refsect3"> -<a name="id-1.4.33.8.12.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-add-mac-blacklist-item.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -689,7 +733,7 @@ nm_setting_wired_add_mac_blacklist_item </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.12.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-add-mac-blacklist-item.returns"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if the MAC address was added; <code class="literal">FALSE</code> if the MAC address is invalid or was already present</p> </div> @@ -704,7 +748,7 @@ nm_setting_wired_remove_mac_blacklist_item <p>Removes the MAC address at index <em class="parameter"><code>idx</code></em> from the blacklist.</p> <div class="refsect3"> -<a name="id-1.4.33.8.13.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-remove-mac-blacklist-item.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -736,7 +780,7 @@ nm_setting_wired_remove_mac_blacklist_item_by_value <p>Removes the MAC address <em class="parameter"><code>mac</code></em> from the blacklist.</p> <div class="refsect3"> -<a name="id-1.4.33.8.14.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-remove-mac-blacklist-item-by-value.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -759,7 +803,7 @@ the blacklist</p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.14.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-remove-mac-blacklist-item-by-value.returns"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if the MAC address was found and removed; <code class="literal">FALSE</code> if it was not.</p> </div> </div> @@ -771,7 +815,7 @@ nm_setting_wired_clear_mac_blacklist_items (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>);</pre> <p>Removes all blacklisted MAC addresses.</p> <div class="refsect3"> -<a name="id-1.4.33.8.15.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-clear-mac-blacklist-items.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -792,7 +836,7 @@ nm_setting_wired_clear_mac_blacklist_items <pre class="programlisting"><span class="returnvalue">guint32</span> nm_setting_wired_get_mtu (<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="id-1.4.33.8.16.4"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-mtu.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -807,7 +851,7 @@ nm_setting_wired_get_mtu (<em class="parameter"><code><a class="link" href="NMSe </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.16.5"></a><h4>Returns</h4> +<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> </div> </div> @@ -820,7 +864,7 @@ nm_setting_wired_get_s390_subchannels (<em class="parameter"><code><a class="lin connection is applicable to. The connection should only be used in conjunction with that device.</p> <div class="refsect3"> -<a name="id-1.4.33.8.17.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-s390-subchannels.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -835,7 +879,7 @@ conjunction with that device.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.17.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-s390-subchannels.returns"></a><h4>Returns</h4> <p> array of strings, each specifying one subchannel the s390 device uses to communicate to the host. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p> @@ -849,7 +893,7 @@ nm_setting_wired_get_s390_nettype (<em class="parameter"><code><a class="link" h <p>Returns the s390 device type this connection should apply to. Will be one of 'qeth', 'lcs', or 'ctc'.</p> <div class="refsect3"> -<a name="id-1.4.33.8.18.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-s390-nettype.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -864,7 +908,7 @@ of 'qeth', 'lcs', or 'ctc'.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.18.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-s390-nettype.returns"></a><h4>Returns</h4> <p> the s390 device type</p> </div> </div> @@ -877,7 +921,7 @@ nm_setting_wired_get_num_s390_options (<em class="parameter"><code><a class="lin device when it is activated. This can be used to retrieve each s390 option individually using <a class="link" href="NMSettingWired.html#nm-setting-wired-get-s390-option" title="nm_setting_wired_get_s390_option ()"><code class="function">nm_setting_wired_get_s390_option()</code></a>.</p> <div class="refsect3"> -<a name="id-1.4.33.8.19.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-num-s390-options.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -892,7 +936,7 @@ option individually using <a class="link" href="NMSettingWired.html#nm-setting-w </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.19.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-num-s390-options.returns"></a><h4>Returns</h4> <p> the number of s390-specific device options</p> </div> </div> @@ -910,7 +954,7 @@ are *not* guaranteed to be static across modifications to options done by and should not be used to refer to options except for short periods of time such as during option iteration.</p> <div class="refsect3"> -<a name="id-1.4.33.8.20.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-s390-option.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -946,7 +990,7 @@ modified. </p></td> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.20.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-s390-option.returns"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> on success if the index was valid and an option was found, <code class="literal">FALSE</code> if the index was invalid (ie, greater than the number of options currently held by the setting)</p> @@ -963,7 +1007,7 @@ nm_setting_wired_get_s390_option_by_key <em class="parameter"><code>key</code></em> , if it exists.</p> <div class="refsect3"> -<a name="id-1.4.33.8.21.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-s390-option-by-key.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -985,7 +1029,7 @@ nm_setting_wired_get_s390_option_by_key </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.21.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-s390-option-by-key.returns"></a><h4>Returns</h4> <p> the value, or <code class="literal">NULL</code> if the key/value pair was never added to the setting; the value is owned by the setting and must not be modified</p> </div> @@ -1002,7 +1046,7 @@ 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> <div class="refsect3"> -<a name="id-1.4.33.8.22.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-add-s390-option.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1029,7 +1073,7 @@ may already exist.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.22.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-add-s390-option.returns"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if the option was valid and was added to the internal option list, <code class="literal">FALSE</code> if it was not.</p> </div> @@ -1044,7 +1088,7 @@ nm_setting_wired_remove_s390_option (<em class="parameter"><code><a class="link" from the internal option list.</p> <div class="refsect3"> -<a name="id-1.4.33.8.23.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-remove-s390-option.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1066,7 +1110,7 @@ list.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.23.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-remove-s390-option.returns"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if the option was found and removed from the internal option list, <code class="literal">FALSE</code> if it was not.</p> </div> @@ -1079,7 +1123,7 @@ nm_setting_wired_get_valid_s390_options (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>);</pre> <p>Returns a list of valid s390 options.</p> <div class="refsect3"> -<a name="id-1.4.33.8.24.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-valid-s390-options.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1094,7 +1138,7 @@ nm_setting_wired_get_valid_s390_options </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.24.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-valid-s390-options.returns"></a><h4>Returns</h4> <p> a <code class="literal">NULL</code>-terminated array of strings of valid s390 options. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> @@ -1106,7 +1150,7 @@ nm_setting_wired_get_valid_s390_options nm_setting_wired_get_wake_on_lan (<em class="parameter"><code><a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> *setting</code></em>);</pre> <p>Returns the Wake-on-LAN options enabled for the connection</p> <div class="refsect3"> -<a name="id-1.4.33.8.25.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-wake-on-lan.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1121,7 +1165,7 @@ nm_setting_wired_get_wake_on_lan (<em class="parameter"><code><a class="link" hr </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.25.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-wake-on-lan.returns"></a><h4>Returns</h4> <p> the Wake-on-LAN options</p> </div> <p class="since">Since: 1.2</p> @@ -1135,7 +1179,7 @@ nm_setting_wired_get_wake_on_lan_password <p>Returns the Wake-on-LAN password. This only applies to <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>.</p> <div class="refsect3"> -<a name="id-1.4.33.8.26.5"></a><h4>Parameters</h4> +<a name="nm-setting-wired-get-wake-on-lan-password.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -1150,7 +1194,7 @@ nm_setting_wired_get_wake_on_lan_password </table></div> </div> <div class="refsect3"> -<a name="id-1.4.33.8.26.6"></a><h4>Returns</h4> +<a name="nm-setting-wired-get-wake-on-lan-password.returns"></a><h4>Returns</h4> <p> the Wake-on-LAN setting password, or <code class="literal">NULL</code> if there is no password.</p> </div> <p class="since">Since: 1.2</p> @@ -1169,7 +1213,7 @@ nm_setting_wired_get_wake_on_lan_password <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 are supported by all devices.</p> <div class="refsect3"> -<a name="id-1.4.33.9.3.4"></a><h4>Members</h4> +<a name="NMSettingWiredWakeOnLan.members"></a><h4>Members</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> @@ -1307,6 +1351,12 @@ are supported by all devices.</p> </div> <hr> <div class="refsect2"> +<a name="NM-SETTING-WIRED-GENERATE-MAC-ADDRESS-MASK:CAPS"></a><h3>NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK</h3> +<pre class="programlisting">#define NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK "generate-mac-address-mask" +</pre> +</div> +<hr> +<div class="refsect2"> <a name="NM-SETTING-WIRED-MAC-ADDRESS-BLACKLIST:CAPS"></a><h3>NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST</h3> <pre class="programlisting">#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist" </pre> @@ -1370,6 +1420,17 @@ are supported by all devices.</p> <pre class="programlisting"> “cloned-mac-address” <span class="type">gchar</span> *</pre> <p>If specified, request that the device use this MAC address instead of its permanent MAC address. This is known as MAC cloning or spoofing.</p> +<p>Beside explicitly specifing 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 of the device. +"random" creates a random MAC address on each connect. +"stable" creates a hashed MAC address based on connection.stable-id (or +the connection's UUID) 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 "permanent".</p> +<p>On D-Bus, this field is expressed as "assigned-mac-address" or the deprecated +"cloned-mac-address".</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> </div> @@ -1384,6 +1445,37 @@ Either "half" or "full".</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">gchar</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 <code class="literal">NULL</code>, it is eligible to be overwritten by a default +connection setting. If the value is still <code class="literal">NULL</code> 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 then 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>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">gchar</span> *</pre> <p>If specified, this connection will only apply to the Ethernet device @@ -1494,6 +1586,6 @@ no password will be required.</p> </div> </div> <div class="footer"> -<hr>Generated by GTK-Doc V1.24</div> +<hr>Generated by GTK-Doc V1.25</div> </body> </html> \ No newline at end of file |