From 50a58f0fabd8a34c1b6108a107e08abe3c1ccd24 Mon Sep 17 00:00:00 2001
From: Michael Biebl the “mode” property of the setting the “band” property of the setting the “channel” property of the setting the “bssid” property of the setting the “rate” property of the setting the “tx-power” property of the setting the “mac-address” property of the setting the blacklisted MAC address string (hex-digits-and-colons notation)
at index
Returns
@@ -482,7 +481,6 @@ nm_setting_wireless_get_band (
Returns
@@ -508,7 +506,6 @@ nm_setting_wireless_get_channel (
Returns
@@ -534,7 +531,6 @@ nm_setting_wireless_get_bssid (
Returns
@@ -560,7 +556,6 @@ nm_setting_wireless_get_rate (
Returns
@@ -586,7 +581,6 @@ nm_setting_wireless_get_tx_power (
Returns
@@ -612,7 +606,6 @@ nm_setting_wireless_get_mac_address (
Returns
@@ -639,7 +632,6 @@ nm_setting_wireless_get_cloned_mac_address
@@ -666,7 +658,6 @@ nm_setting_wireless_get_mac_address_blacklist
@@ -693,7 +684,6 @@ nm_setting_wireless_get_num_mac_blacklist_items
@@ -730,7 +720,6 @@ nm_setting_wireless_get_mac_blacklist_item
idx
@@ -767,7 +756,6 @@ nm_setting_wireless_add_mac_blacklist_item
Returns
TRUE if the MAC address was added; FALSE if the MAC address
is invalid or was already present
@@ -837,7 +825,6 @@ the blacklist
Returns
the “mtu” property of the setting
-
@@ -912,7 +898,6 @@ nm_setting_wireless_get_hidden (
Returns
the “hidden” property of the setting
-
@@ -951,7 +936,6 @@ not be preserved.
Returns
TRUE if bssid
was already known, FALSE if not
-
@@ -978,7 +962,6 @@ nm_setting_wireless_get_num_seen_bssids
@@ -1013,7 +996,6 @@ nm_setting_wireless_get_seen_bssid (Returns
the BSSID at index i
-
@@ -1081,7 +1063,6 @@ capabilities
Returns
TRUE if the given settings are compatible with the access point's
security flags and mode, FALSE if they are not.
-
@@ -1091,112 +1072,84 @@ security flags and mode, FALSE if they are not.
NM_SETTING_WIRELESS_SETTING_NAME
#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"
-
-
NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
-
-
NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
-
-
@@ -1227,7 +1180,12 @@ for this connection.
The “band” property
“band” gchar *
-
+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.
Flags: Read / Write
Default value: NULL
@@ -1235,7 +1193,10 @@ for this connection.
The “bssid” property
“bssid” gchar *
-
+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.
Flags: Read / Write
Default value: NULL
@@ -1243,7 +1204,10 @@ for this connection.
The “channel” property
“channel” guint
-
+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.
Flags: Read / Write / Construct
Default value: 0
@@ -1251,7 +1215,8 @@ for this connection.
The “cloned-mac-address” property
“cloned-mac-address” gchar *
-
+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.
Flags: Read / Write
Default value: NULL
@@ -1259,7 +1224,11 @@ for this connection.
The “hidden” property
“hidden” gboolean
-
+If TRUE, 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.
Flags: Read / Write
Default value: FALSE
@@ -1267,7 +1236,9 @@ for this connection.
The “mac-address” property
“mac-address” gchar *
-
+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).
Flags: Read / Write
Default value: NULL
@@ -1275,14 +1246,17 @@ for this connection.
The “mac-address-blacklist” property
“mac-address-blacklist” GStrv
-
+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").
Flags: Read / Write
The “mode” property
“mode” gchar *
-
+Wi-Fi network mode; one of "infrastructure", "adhoc" or "ap". If blank,
+infrastructure is assumed.
Flags: Read / Write
Default value: NULL
@@ -1290,7 +1264,8 @@ for this connection.
The “mtu” property
“mtu” guint
-
+If non-zero, only transmit packets of the specified size or smaller,
+breaking larger packets up into multiple Ethernet frames.
Flags: Read / Write / Construct
Default value: 0
@@ -1298,7 +1273,10 @@ for this connection.
The “rate” property
“rate” guint
-
+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.
Flags: Read / Write / Construct
Default value: 0
@@ -1306,28 +1284,34 @@ for this connection.
The “seen-bssids” property
“seen-bssids” GStrv
-
+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.
Flags: Read / Write
The “ssid” property
“ssid” GBytes *
-
+SSID of the Wi-Fi network. Must be specified.
Flags: Read / Write
+
Generated by GTK-Doc V1.24
\ No newline at end of file
--
cgit 1.3.0-6-gf8a5