summary refs log tree commit diff
path: root/docs/libnm-util/html/NMSettingWired.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/libnm-util/html/NMSettingWired.html')
-rw-r--r--docs/libnm-util/html/NMSettingWired.html111
1 files changed, 45 insertions, 66 deletions
diff --git a/docs/libnm-util/html/NMSettingWired.html b/docs/libnm-util/html/NMSettingWired.html
index 3b0bfc3f..75184b1b 100644
--- a/docs/libnm-util/html/NMSettingWired.html
+++ b/docs/libnm-util/html/NMSettingWired.html
@@ -2,13 +2,13 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>libnm-util Reference Manual: NMSettingWired</title>
+<title>NMSettingWired: libnm-util Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="libnm-util Reference Manual">
 <link rel="up" href="ch01.html" title="libnm-util API Reference">
 <link rel="prev" href="NMSettingConnection.html" title="NMSettingConnection">
 <link rel="next" href="NMSettingWireless.html" title="NMSettingWireless">
-<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -396,7 +396,6 @@ nm_setting_wired_error_quark (<em class="parameter"><code><span class="type">voi
 <div class="refsect3">
 <a name="id-1.2.5.9.2.5"></a><h4>Returns</h4>
 <p> the error quark used for <a class="link" href="NMSettingWired.html" title="NMSettingWired"><span class="type">NMSettingWired</span></a> errors.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -434,7 +433,6 @@ nm_setting_wired_get_port (<em class="parameter"><code><a class="link" href="NMS
 <div class="refsect3">
 <a name="id-1.2.5.9.4.5"></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></p>
 </div>
 </div>
 <hr>
@@ -460,7 +458,6 @@ nm_setting_wired_get_speed (<em class="parameter"><code><a class="link" href="NM
 <div class="refsect3">
 <a name="id-1.2.5.9.5.5"></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></p>
 </div>
 </div>
 <hr>
@@ -486,7 +483,6 @@ nm_setting_wired_get_duplex (<em class="parameter"><code><a class="link" href="N
 <div class="refsect3">
 <a name="id-1.2.5.9.6.5"></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></p>
 </div>
 </div>
 <hr>
@@ -512,7 +508,6 @@ nm_setting_wired_get_auto_negotiate (<em class="parameter"><code><a class="link"
 <div class="refsect3">
 <a name="id-1.2.5.9.7.5"></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></p>
 </div>
 </div>
 <hr>
@@ -538,7 +533,6 @@ nm_setting_wired_get_mac_address (<em class="parameter"><code><a class="link" hr
 <div class="refsect3">
 <a name="id-1.2.5.9.8.5"></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></p>
 </div>
 </div>
 <hr>
@@ -565,7 +559,6 @@ nm_setting_wired_get_cloned_mac_address
 <div class="refsect3">
 <a name="id-1.2.5.9.9.5"></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></p>
 </div>
 </div>
 <hr>
@@ -620,9 +613,8 @@ nm_setting_wired_get_num_mac_blacklist_items
 <div class="refsect3">
 <a name="id-1.2.5.9.11.5"></a><h4>Returns</h4>
 <p> the number of blacklisted MAC addresses</p>
-<p></p>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -658,9 +650,8 @@ nm_setting_wired_get_mac_blacklist_item
 <p> the blacklisted MAC address string (hex-digits-and-colons notation)
 at index <em class="parameter"><code>idx</code></em>
 </p>
-<p></p>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -696,9 +687,8 @@ nm_setting_wired_add_mac_blacklist_item
 <a name="id-1.2.5.9.13.6"></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>
-<p></p>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -731,7 +721,7 @@ nm_setting_wired_remove_mac_blacklist_item
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -768,9 +758,8 @@ the blacklist</p></td>
 <div class="refsect3">
 <a name="id-1.2.5.9.15.6"></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>
-<p></p>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -794,7 +783,7 @@ nm_setting_wired_clear_mac_blacklist_items
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -819,7 +808,6 @@ nm_setting_wired_get_mtu (<em class="parameter"><code><a class="link" href="NMSe
 <div class="refsect3">
 <a name="id-1.2.5.9.17.5"></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></p>
 </div>
 </div>
 <hr>
@@ -877,7 +865,6 @@ of 'qeth', 'lcs', or 'ctc'.</p>
 <div class="refsect3">
 <a name="id-1.2.5.9.19.6"></a><h4>Returns</h4>
 <p> the s390 device type</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -906,7 +893,6 @@ option individually using <a class="link" href="NMSettingWired.html#nm-setting-w
 <div class="refsect3">
 <a name="id-1.2.5.9.20.6"></a><h4>Returns</h4>
 <p> the number of s390-specific device options</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -962,7 +948,6 @@ option; this value is owned by the setting and should not be modified. </p></td>
 <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>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1001,7 +986,6 @@ nm_setting_wired_get_s390_option_by_key
 <a name="id-1.2.5.9.22.6"></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>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1046,7 +1030,6 @@ may already exist.</p>
 <a name="id-1.2.5.9.23.6"></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>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1084,7 +1067,6 @@ list.</p>
 <a name="id-1.2.5.9.24.6"></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>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1114,7 +1096,7 @@ nm_setting_wired_get_valid_s390_options
 <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>
-<p class="since">Since 0.9.10</p>
+<p class="since">Since: 0.9.10</p>
 </div>
 </div>
 <div class="refsect1">
@@ -1123,8 +1105,6 @@ nm_setting_wired_get_valid_s390_options
 <a name="NM-SETTING-WIRED-SETTING-NAME:CAPS"></a><h3>NM_SETTING_WIRED_SETTING_NAME</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_SETTING_NAME "802-3-ethernet"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1169,96 +1149,72 @@ required</p>
 <a name="NM-SETTING-WIRED-ERROR:CAPS"></a><h3>NM_SETTING_WIRED_ERROR</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_ERROR nm_setting_wired_error_quark ()
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-PORT:CAPS"></a><h3>NM_SETTING_WIRED_PORT</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_PORT "port"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-SPEED:CAPS"></a><h3>NM_SETTING_WIRED_SPEED</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_SPEED "speed"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-DUPLEX:CAPS"></a><h3>NM_SETTING_WIRED_DUPLEX</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_DUPLEX "duplex"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-AUTO-NEGOTIATE:CAPS"></a><h3>NM_SETTING_WIRED_AUTO_NEGOTIATE</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_AUTO_NEGOTIATE "auto-negotiate"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-MAC-ADDRESS:CAPS"></a><h3>NM_SETTING_WIRED_MAC_ADDRESS</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_MAC_ADDRESS "mac-address"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-CLONED-MAC-ADDRESS:CAPS"></a><h3>NM_SETTING_WIRED_CLONED_MAC_ADDRESS</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
 </pre>
-<p>
-</p>
 </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>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-MTU:CAPS"></a><h3>NM_SETTING_WIRED_MTU</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_MTU "mtu"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-S390-SUBCHANNELS:CAPS"></a><h3>NM_SETTING_WIRED_S390_SUBCHANNELS</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_S390_SUBCHANNELS "s390-subchannels"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-S390-NETTYPE:CAPS"></a><h3>NM_SETTING_WIRED_S390_NETTYPE</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_S390_NETTYPE "s390-nettype"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-WIRED-S390-OPTIONS:CAPS"></a><h3>NM_SETTING_WIRED_S390_OPTIONS</h3>
 <pre class="programlisting">#define NM_SETTING_WIRED_S390_OPTIONS "s390-options"
 </pre>
-<p>
-</p>
 </div>
 </div>
 <div class="refsect1">
@@ -1266,7 +1222,9 @@ required</p>
 <div class="refsect2">
 <a name="NMSettingWired--auto-negotiate"></a><h3>The <code class="literal">“auto-negotiate”</code> property</h3>
 <pre class="programlisting">  “auto-negotiate”           <span class="type">gboolean</span></pre>
-<p></p>
+<p>If <code class="literal">TRUE</code>, allow auto-negotiation of port speed and duplex mode.  If
+<code class="literal">FALSE</code>, do not allow auto-negotiation, in which case the "speed" and
+"duplex" properties should be set.</p>
 <p>Flags: Read / Write / Construct</p>
 <p>Default value: TRUE</p>
 </div>
@@ -1274,14 +1232,16 @@ required</p>
 <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">GArray_guchar_</span> *</pre>
-<p></p>
+<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>Flags: Read / Write</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">gchar</span> *</pre>
-<p></p>
+<p>If specified, request that the device only use the specified duplex mode.
+Either "half" or "full".</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -1289,21 +1249,27 @@ required</p>
 <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">GArray_guchar_</span> *</pre>
-<p></p>
+<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>Flags: Read / Write</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”    <span class="type">GSList_gchararray_</span> *</pre>
-<p></p>
+<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>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”                      <span class="type">guint</span></pre>
-<p></p>
+<p>If non-zero, only transmit packets of the specified size or smaller,
+breaking larger packets up into multiple Ethernet frames.</p>
 <p>Flags: Read / Write / Construct</p>
 <p>Default value: 0</p>
 </div>
@@ -1311,7 +1277,10 @@ required</p>
 <div class="refsect2">
 <a name="NMSettingWired--port"></a><h3>The <code class="literal">“port”</code> property</h3>
 <pre class="programlisting">  “port”                     <span class="type">gchar</span> *</pre>
-<p></p>
+<p>Specific port type to use if multiple 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>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -1319,7 +1288,8 @@ required</p>
 <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">gchar</span> *</pre>
-<p></p>
+<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>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -1327,28 +1297,37 @@ required</p>
 <div class="refsect2">
 <a name="NMSettingWired--s390-options"></a><h3>The <code class="literal">“s390-options”</code> property</h3>
 <pre class="programlisting">  “s390-options”             <span class="type">GHashTable_gchararray+gchararray_*</span></pre>
-<p></p>
+<p>Dictionary of key/value pairs of s390-specific device options.  Both keys
+and values must be strings.  Allowed keys include "portno", "layer2",
+"portname", "protocol", among others.  Key names must contain only
+alphanumeric characters (ie, [a-zA-Z0-9]).</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”         <span class="type">GPtrArray_gchararray_</span> *</pre>
-<p></p>
+<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>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”                    <span class="type">guint</span></pre>
-<p></p>
+<p>If non-zero, request that the device use only the specified speed.  In
+Mbit/s, ie 100 == 100Mbit/s.</p>
 <p>Flags: Read / Write / Construct</p>
 <p>Default value: 0</p>
 </div>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>
\ No newline at end of file