diff options
Diffstat (limited to 'docs/libnm-util/html/NMSettingWireless.html')
| -rw-r--r-- | docs/libnm-util/html/NMSettingWireless.html | 137 |
1 files changed, 59 insertions, 78 deletions
diff --git a/docs/libnm-util/html/NMSettingWireless.html b/docs/libnm-util/html/NMSettingWireless.html index f668698a..4642d621 100644 --- a/docs/libnm-util/html/NMSettingWireless.html +++ b/docs/libnm-util/html/NMSettingWireless.html @@ -2,13 +2,13 @@ <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>libnm-util Reference Manual: NMSettingWireless</title> +<title>NMSettingWireless: 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="NMSettingWired.html" title="NMSettingWired"> <link rel="next" href="NMSettingWirelessSecurity.html" title="NMSettingWirelessSecurity"> -<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"> @@ -445,7 +445,6 @@ nm_setting_wireless_error_quark (<em class="parameter"><code><span class="type"> <div class="refsect3"> <a name="id-1.2.6.9.2.5"></a><h4>Returns</h4> <p> the error quark used for <a class="link" href="NMSettingWireless.html" title="NMSettingWireless"><span class="type">NMSettingWireless</span></a> errors.</p> -<p></p> </div> </div> <hr> @@ -483,7 +482,6 @@ nm_setting_wireless_get_ssid (<em class="parameter"><code><a class="link" href=" <div class="refsect3"> <a name="id-1.2.6.9.4.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--ssid" title="The “ssid” property"><span class="type">“ssid”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -509,7 +507,6 @@ nm_setting_wireless_get_mode (<em class="parameter"><code><a class="link" href=" <div class="refsect3"> <a name="id-1.2.6.9.5.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--mode" title="The “mode” property"><span class="type">“mode”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -535,7 +532,6 @@ nm_setting_wireless_get_band (<em class="parameter"><code><a class="link" href=" <div class="refsect3"> <a name="id-1.2.6.9.6.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--band" title="The “band” property"><span class="type">“band”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -561,7 +557,6 @@ nm_setting_wireless_get_channel (<em class="parameter"><code><a class="link" hre <div class="refsect3"> <a name="id-1.2.6.9.7.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--channel" title="The “channel” property"><span class="type">“channel”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -587,7 +582,6 @@ nm_setting_wireless_get_bssid (<em class="parameter"><code><a class="link" href= <div class="refsect3"> <a name="id-1.2.6.9.8.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--bssid" title="The “bssid” property"><span class="type">“bssid”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -613,7 +607,6 @@ nm_setting_wireless_get_rate (<em class="parameter"><code><a class="link" href=" <div class="refsect3"> <a name="id-1.2.6.9.9.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--rate" title="The “rate” property"><span class="type">“rate”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -639,7 +632,6 @@ nm_setting_wireless_get_tx_power (<em class="parameter"><code><a class="link" hr <div class="refsect3"> <a name="id-1.2.6.9.10.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--tx-power" title="The “tx-power” property"><span class="type">“tx-power”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -665,7 +657,6 @@ nm_setting_wireless_get_mac_address (<em class="parameter"><code><a class="link" <div class="refsect3"> <a name="id-1.2.6.9.11.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--mac-address" title="The “mac-address” property"><span class="type">“mac-address”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -692,7 +683,6 @@ nm_setting_wireless_get_cloned_mac_address <div class="refsect3"> <a name="id-1.2.6.9.12.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--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> @@ -747,9 +737,8 @@ nm_setting_wireless_get_num_mac_blacklist_items <div class="refsect3"> <a name="id-1.2.6.9.14.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"> @@ -785,9 +774,8 @@ nm_setting_wireless_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"> @@ -823,9 +811,8 @@ nm_setting_wireless_add_mac_blacklist_item <a name="id-1.2.6.9.16.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"> @@ -858,7 +845,7 @@ nm_setting_wireless_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"> @@ -895,9 +882,8 @@ the blacklist</p></td> <div class="refsect3"> <a name="id-1.2.6.9.18.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"> @@ -921,7 +907,7 @@ nm_setting_wireless_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"> @@ -946,7 +932,6 @@ nm_setting_wireless_get_mtu (<em class="parameter"><code><a class="link" href="N <div class="refsect3"> <a name="id-1.2.6.9.20.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--mtu" title="The “mtu” property"><span class="type">“mtu”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -972,7 +957,6 @@ nm_setting_wireless_get_hidden (<em class="parameter"><code><a class="link" href <div class="refsect3"> <a name="id-1.2.6.9.21.5"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--hidden" title="The “hidden” property"><span class="type">“hidden”</span></a> property of the setting</p> -<p></p> </div> </div> <hr> @@ -1011,7 +995,6 @@ not be preserved.</p> <a name="id-1.2.6.9.22.6"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if <em class="parameter"><code>bssid</code></em> was already known, <code class="literal">FALSE</code> if not</p> -<p></p> </div> </div> <hr> @@ -1038,7 +1021,6 @@ nm_setting_wireless_get_num_seen_bssids <div class="refsect3"> <a name="id-1.2.6.9.23.5"></a><h4>Returns</h4> <p> the number of BSSIDs in the previously seen BSSID list</p> -<p></p> </div> </div> <hr> @@ -1073,7 +1055,6 @@ nm_setting_wireless_get_seen_bssid (<em class="parameter"><code><a class="link" <a name="id-1.2.6.9.24.5"></a><h4>Returns</h4> <p> the BSSID at index <em class="parameter"><code>i</code></em> </p> -<p></p> </div> </div> <hr> @@ -1141,7 +1122,6 @@ capabilities</p></td> <a name="id-1.2.6.9.25.6"></a><h4>Returns</h4> <p> <code class="literal">TRUE</code> if the given settings are compatible with the access point's security flags and mode, <code class="literal">FALSE</code> if they are not.</p> -<p></p> </div> </div> <hr> @@ -1172,7 +1152,6 @@ the presence of NM_SETTING_WIRELESS_SECURITY_SETTING_NAME in the connection.</p> <div class="refsect3"> <a name="id-1.2.6.9.26.6"></a><h4>Returns</h4> <p> the <a class="link" href="NMSettingWireless.html#NMSettingWireless--security" title="The “security” property"><span class="type">“security”</span></a> property of the setting</p> -<p></p> </div> </div> </div> @@ -1182,8 +1161,6 @@ the presence of NM_SETTING_WIRELESS_SECURITY_SETTING_NAME in the connection.</p> <a name="NM-SETTING-WIRELESS-SETTING-NAME:CAPS"></a><h3>NM_SETTING_WIRELESS_SETTING_NAME</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> @@ -1244,120 +1221,90 @@ set to a value that requires the <a class="link" href="NMSettingWireless.html#NM <a name="NM-SETTING-WIRELESS-ERROR:CAPS"></a><h3>NM_SETTING_WIRELESS_ERROR</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_ERROR nm_setting_wireless_error_quark () </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-SSID:CAPS"></a><h3>NM_SETTING_WIRELESS_SSID</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_SSID "ssid" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-MODE:CAPS"></a><h3>NM_SETTING_WIRELESS_MODE</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_MODE "mode" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-BAND:CAPS"></a><h3>NM_SETTING_WIRELESS_BAND</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_BAND "band" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-CHANNEL:CAPS"></a><h3>NM_SETTING_WIRELESS_CHANNEL</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_CHANNEL "channel" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-BSSID:CAPS"></a><h3>NM_SETTING_WIRELESS_BSSID</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_BSSID "bssid" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-RATE:CAPS"></a><h3>NM_SETTING_WIRELESS_RATE</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_RATE "rate" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-TX-POWER:CAPS"></a><h3>NM_SETTING_WIRELESS_TX_POWER</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_TX_POWER "tx-power" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-MAC-ADDRESS:CAPS"></a><h3>NM_SETTING_WIRELESS_MAC_ADDRESS</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_MAC_ADDRESS "mac-address" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-CLONED-MAC-ADDRESS:CAPS"></a><h3>NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-MAC-ADDRESS-BLACKLIST:CAPS"></a><h3>NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-MTU:CAPS"></a><h3>NM_SETTING_WIRELESS_MTU</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_MTU "mtu" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-SEEN-BSSIDS:CAPS"></a><h3>NM_SETTING_WIRELESS_SEEN_BSSIDS</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_SEEN_BSSIDS "seen-bssids" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-HIDDEN:CAPS"></a><h3>NM_SETTING_WIRELESS_HIDDEN</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_HIDDEN "hidden" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> <a name="NM-SETTING-WIRELESS-SEC:CAPS"></a><h3>NM_SETTING_WIRELESS_SEC</h3> <pre class="programlisting">#define NM_SETTING_WIRELESS_SEC "security" </pre> -<p> -</p> </div> <hr> <div class="refsect2"> @@ -1373,7 +1320,7 @@ set to a value that requires the <a class="link" href="NMSettingWireless.html#NM </pre> <p>Indicates AP/master mode where the wireless device is started as an access point/hotspot.</p> -<p class="since">Since 0.9.8</p> +<p class="since">Since: 0.9.8</p> </div> <hr> <div class="refsect2"> @@ -1389,7 +1336,12 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--band"></a><h3>The <code class="literal">“band”</code> property</h3> <pre class="programlisting"> “band” <span class="type">gchar</span> *</pre> -<p></p> +<p>802.11 frequency band of the network. One of "a" for 5GHz 802.11a or +"bg" for 2.4GHz 802.11. This will lock associations to the Wi-Fi network +to the specific band, i.e. if "a" is specified, the device will not +associate with the same network in the 2.4GHz band even if the network's +settings are compatible. This setting depends on specific driver +capability and may not work with all drivers.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> </div> @@ -1397,14 +1349,20 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--bssid"></a><h3>The <code class="literal">“bssid”</code> property</h3> <pre class="programlisting"> “bssid” <span class="type">GArray_guchar_</span> *</pre> -<p></p> +<p>If specified, directs the device to only associate with the given access +point. This capability is highly driver dependent and not supported by +all devices. Note: this property does not control the BSSID used when +creating an Ad-Hoc network and is unlikely to in the future.</p> <p>Flags: Read / Write</p> </div> <hr> <div class="refsect2"> <a name="NMSettingWireless--channel"></a><h3>The <code class="literal">“channel”</code> property</h3> <pre class="programlisting"> “channel” <span class="type">guint</span></pre> -<p></p> +<p>Wireless channel to use for the Wi-Fi connection. The device will only +join (or create for Ad-Hoc networks) a Wi-Fi network on the specified +channel. Because channel numbers overlap between bands, this property +also requires the "band" property to be set.</p> <p>Flags: Read / Write / Construct</p> <p>Default value: 0</p> </div> @@ -1412,14 +1370,19 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--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 Wi-Fi 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="NMSettingWireless--hidden"></a><h3>The <code class="literal">“hidden”</code> property</h3> <pre class="programlisting"> “hidden” <span class="type">gboolean</span></pre> -<p></p> +<p>If <code class="literal">TRUE</code>, indicates this network is a non-broadcasting network that hides +its SSID. In this case various workarounds may take place, such as +probe-scanning the SSID for more reliable network discovery. However, +these workarounds expose inherent insecurities with hidden SSID networks, +and thus hidden SSID networks should be used with caution.</p> <p>Flags: Read / Write</p> <p>Default value: FALSE</p> </div> @@ -1427,21 +1390,26 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--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 Wi-Fi 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="NMSettingWireless--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>A list of permanent MAC addresses of Wi-Fi devices to which this +connection should never apply. Each MAC address should be given in the +standard hex-digits-and-colons notation (eg "00:11:22:33:44:55").</p> <p>Flags: Read / Write</p> </div> <hr> <div class="refsect2"> <a name="NMSettingWireless--mode"></a><h3>The <code class="literal">“mode”</code> property</h3> <pre class="programlisting"> “mode” <span class="type">gchar</span> *</pre> -<p></p> +<p>Wi-Fi network mode; one of "infrastructure", "adhoc" or "ap". If blank, +infrastructure is assumed.</p> <p>Flags: Read / Write</p> <p>Default value: NULL</p> </div> @@ -1449,7 +1417,8 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--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> @@ -1457,7 +1426,10 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--rate"></a><h3>The <code class="literal">“rate”</code> property</h3> <pre class="programlisting"> “rate” <span class="type">guint</span></pre> -<p></p> +<p>If non-zero, directs the device to only use the specified bitrate for +communication with the access point. Units are in Kb/s, ie 5500 = 5.5 +Mbit/s. This property is highly driver dependent and not all devices +support setting a static bitrate.</p> <p>Flags: Read / Write / Construct</p> <p>Default value: 0</p> </div> @@ -1465,7 +1437,10 @@ for this connection.</p> <div class="refsect2"> <a name="NMSettingWireless--security"></a><h3>The <code class="literal">“security”</code> property</h3> <pre class="programlisting"> “security” <span class="type">gchar</span> *</pre> -<p></p> +<p>If the wireless connection has any security restrictions, like 802.1x, +WEP, or WPA, set this property to +<a class="link" href="NMSettingWirelessSecurity.html#NM-SETTING-WIRELESS-SECURITY-SETTING-NAME:CAPS" title="NM_SETTING_WIRELESS_SECURITY_SETTING_NAME"><code class="literal">NM_SETTING_WIRELESS_SECURITY_SETTING_NAME</code></a> and ensure the connection +contains a valid <a class="link" href="NMSettingWirelessSecurity.html" title="NMSettingWirelessSecurity"><span class="type">NMSettingWirelessSecurity</span></a> setting.</p> <div class="warning"> <p><code class="literal">NMSettingWireless:security</code> has been deprecated since version 0.9.10 and should not be used in newly-written code.</p> <p>No longer used. Security restrictions are recognized @@ -1479,28 +1454,34 @@ connection.</p> <div class="refsect2"> <a name="NMSettingWireless--seen-bssids"></a><h3>The <code class="literal">“seen-bssids”</code> property</h3> <pre class="programlisting"> “seen-bssids” <span class="type">GSList_gchararray_</span> *</pre> -<p></p> +<p>A list of BSSIDs (each BSSID formatted as a MAC address like +"00:11:22:33:44:55") that have been detected as part of the Wi-Fi +network. NetworkManager internally tracks previously seen BSSIDs. The +property is only meant for reading and reflects the BSSID list of +NetworkManager. The changes you make to this property will not be +preserved.</p> <p>Flags: Read / Write</p> </div> <hr> <div class="refsect2"> <a name="NMSettingWireless--ssid"></a><h3>The <code class="literal">“ssid”</code> property</h3> <pre class="programlisting"> “ssid” <span class="type">GArray_guchar_</span> *</pre> -<p></p> +<p>SSID of the Wi-Fi network. Must be specified.</p> <p>Flags: Read / Write</p> </div> <hr> <div class="refsect2"> <a name="NMSettingWireless--tx-power"></a><h3>The <code class="literal">“tx-power”</code> property</h3> <pre class="programlisting"> “tx-power” <span class="type">guint</span></pre> -<p></p> +<p>If non-zero, directs the device to use the specified transmit power. +Units are dBm. This property is highly driver dependent and not all +devices support setting a static transmit power.</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 |