| Top |
The NMSettingWireless object is a NMSetting subclass that describes properties necessary for connection to 802.11 Wi-Fi networks.
NMSetting *
nm_setting_wireless_new (void);
Creates a new NMSettingWireless object with default values.
char * nm_setting_wireless_get_blacklist_hostname (NMSettingWireless *setting,guint32 i);
guint32
nm_setting_wireless_get_num_blacklist_hostname_items
(NMSettingWireless *setting);
gboolean nm_setting_wireless_add_blacklist_hostname_item (NMSettingWireless *setting,const char *hostname);
Adds a new blacklist hostname to the “blacklist-hostname” property.
void nm_setting_wireless_remove_blacklist_hostname_item (NMSettingWireless *setting,guint32 idx);
Removes the hostname at index idx
from the blacklist.
gboolean nm_setting_wireless_remove_blacklist_hostname_item_by_value (NMSettingWireless *setting,const char *hostname);
Removes the blacklist hostname hostname
from the blacklist hostname.
const char * nm_setting_wireless_get_whitelist_hostname (NMSettingWireless *setting,guint32 i);
guint32
nm_setting_wireless_get_num_whitelist_hostname_items
(NMSettingWireless *setting);
gboolean nm_setting_wireless_add_whitelist_hostname_item (NMSettingWireless *setting,const char *hostname);
Adds a new whitelist hostname to the “whitelist-hostname” property.
void nm_setting_wireless_remove_whitelist_hostname_item (NMSettingWireless *setting,guint32 idx);
Removes the hostname at index idx
from the whitelist.
gboolean nm_setting_wireless_remove_whitelist_hostname_item_by_value (NMSettingWireless *setting,const char *hostname);
Removes the whitelist hostname hostname
from the blacklist hostname.
const char * nm_setting_wireless_get_mac_address_whitelist (NMSettingWireless *setting,guint32 i);
guint32
nm_setting_wireless_get_num_mac_address_whitelist_items
(NMSettingWireless *setting);
gboolean nm_setting_wireless_add_mac_address_whitelist_item (NMSettingWireless *setting,const char *mac);
Adds a new mac address whitelist to the NMSettingWireless: mac-address-whitelist property.
void nm_setting_wireless_remove_mac_address_whitelist_item (NMSettingWireless *setting,guint32 idx);
Removes the mac at index idx
from the whitelist.
gboolean nm_setting_wireless_remove_mac_address_whitelist_item_by_value (NMSettingWireless *setting,const char *mac);
Removes the whitelist mac mac
from the whitelist mac.
guint32
nm_setting_wireless_get_sta_connectable_quantity
(NMSettingWireless *setting);
Returns the “sta_connectable_quantity” property .
guint32
nm_setting_wireless_get_blacklist_whitelist_flag
(NMSettingWireless *setting);
Returns the “blacklist_whitelist_flag” property .
const char *
nm_setting_wireless_get_mode (NMSettingWireless *setting);
const char *
nm_setting_wireless_get_band (NMSettingWireless *setting);
guint32
nm_setting_wireless_get_channel (NMSettingWireless *setting);
const char *
nm_setting_wireless_get_bssid (NMSettingWireless *setting);
guint32
nm_setting_wireless_get_rate (NMSettingWireless *setting);
nm_setting_wireless_get_rate has been deprecated since version 1.44 and should not be used in newly-written code.
This setting is not implemented and has no effect.
guint32
nm_setting_wireless_get_tx_power (NMSettingWireless *setting);
nm_setting_wireless_get_tx_power has been deprecated since version 1.44 and should not be used in newly-written code.
This setting is not implemented and has no effect.
const char *
nm_setting_wireless_get_mac_address (NMSettingWireless *setting);
const char *
nm_setting_wireless_get_cloned_mac_address
(NMSettingWireless *setting);
const char *
nm_setting_wireless_get_generate_mac_address_mask
(NMSettingWireless *setting);
Since: 1.4
const char *const *
nm_setting_wireless_get_mac_address_blacklist
(NMSettingWireless *setting);
guint32
nm_setting_wireless_get_num_mac_blacklist_items
(NMSettingWireless *setting);
const char * nm_setting_wireless_get_mac_blacklist_item (NMSettingWireless *setting,guint32 idx);
Since 1.46, access at index "len" is allowed and returns NULL.
gboolean nm_setting_wireless_add_mac_blacklist_item (NMSettingWireless *setting,const char *mac);
Adds a new MAC address to the “mac-address-blacklist” property.
void nm_setting_wireless_remove_mac_blacklist_item (NMSettingWireless *setting,guint32 idx);
Removes the MAC address at index idx
from the blacklist.
gboolean nm_setting_wireless_remove_mac_blacklist_item_by_value (NMSettingWireless *setting,const char *mac);
Removes the MAC address mac
from the blacklist.
void
nm_setting_wireless_clear_mac_blacklist_items
(NMSettingWireless *setting);
Removes all blacklisted MAC addresses.
gboolean
nm_setting_wireless_get_hidden (NMSettingWireless *setting);
guint32
nm_setting_wireless_get_powersave (NMSettingWireless *setting);
Since: 1.2
NMSettingMacRandomization
nm_setting_wireless_get_mac_address_randomization
(NMSettingWireless *setting);
Since: 1.2
gboolean nm_setting_wireless_add_seen_bssid (NMSettingWireless *setting,const char *bssid);
Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting. NetworkManager now tracks previously seen BSSIDs internally so this function no longer has much use. Actually, changes you make using this function will not be preserved.
guint32
nm_setting_wireless_get_num_seen_bssids
(NMSettingWireless *setting);
const char * nm_setting_wireless_get_seen_bssid (NMSettingWireless *setting,guint32 i);
gboolean nm_setting_wireless_ap_security_compatible (NMSettingWireless *s_wireless,NMSettingWirelessSecurity *s_wireless_sec,NM80211ApFlags ap_flags,NM80211ApSecurityFlags ap_wpa,NM80211ApSecurityFlags ap_rsn,NM80211Mode ap_mode);
Given a NMSettingWireless and an optional NMSettingWirelessSecurity, determine if the configuration given by the settings is compatible with the security of an access point using that access point's capability flags and mode. Useful for clients that wish to filter a set of connections against a set of access points and determine which connections are compatible with which access points.
s_wireless |
||
s_wireless_sec |
a NMSettingWirelessSecurity or |
|
ap_flags |
the |
|
ap_wpa |
the |
|
ap_rsn |
the |
|
ap_mode |
the 802.11 mode of the AP, either Ad-Hoc or Infrastructure |
NMSettingWirelessWakeOnWLan
nm_setting_wireless_get_wake_on_wlan (NMSettingWireless *setting);
Returns the Wake-on-WLAN options enabled for the connection
Since: 1.12
NMTernary
nm_setting_wireless_get_ap_isolation (NMSettingWireless *setting);
Since: 1.28
Options for “wake-on-wlan”. Note that not all options are supported by all devices.
|
Wake-on-WLAN disabled |
||
|
Wake on any activity |
||
|
Wake on disconnect |
||
|
Wake on magic packet |
||
|
Wake on GTK rekey failure |
||
|
Wake on EAP identity request |
||
|
Wake on 4way handshake |
||
|
Wake on rfkill release |
||
|
Wake on all events. This does not
include the exclusive flags |
||
|
Use the default value |
||
|
Don't change configured settings |
||
|
Mask of flags that are incompatible with other flags |
Since: 1.12
#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS "cloned-mac-address"
#define NM_SETTING_WIRELESS_GENERATE_MAC_ADDRESS_MASK "generate-mac-address-mask"
#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
#define NM_SETTING_WIRELESS_MAC_ADDRESS_RANDOMIZATION "mac-address-randomization"
#define NM_SETTING_WIRELESS_BLACKLIST_HOSTNAME "blacklist-hostname"
#define NM_SETTING_WIRELESS_MAC_ADDRESS_WHITELIST "mac-address-whitelist"
#define NM_SETTING_WIRELESS_WHITELIST_HOSTNAME "whitelist-hostname"
#define NM_SETTING_WIRELESS_STA_CONNECTABLE_QUANTITY "sta-connectable-quantity"
#define NM_SETTING_CONNECTION_STA_CONNECTABLE_QUANTITY_MIN 1
#define NM_SETTING_CONNECTION_STA_CONNECTABLE_QUANTITY_MAX 999
#define NM_SETTING_CONNECTION_STA_CONNECTABLE_QUANTITY_DEFAULT 10
#define NM_SETTING_WIRELESS_BLACKLIST_WHITELIST_FLAG "blacklist-whitelist-flag"
#define NM_SETTING_CONNECTION_BLACKLIST_WHITELIST_FLAG_DEFAULT 0
#define NM_SETTING_CONNECTION_BLACKLIST_WHITELIST_FLAG_MIN 1
#define NM_SETTING_CONNECTION_BLACKLIST_WHITELIST_FLAG_MAX 2
#define NM_SETTING_WIRELESS_MODE_ADHOC "adhoc"
Indicates Ad-Hoc mode where no access point is expected to be present.
#define NM_SETTING_WIRELESS_MODE_AP "ap"
Indicates AP/master mode where the wireless device is started as an access point/hotspot.
#define NM_SETTING_WIRELESS_MODE_INFRA "infrastructure"
Indicates infrastructure mode where an access point is expected to be present for this connection.
#define NM_SETTING_WIRELESS_MODE_MESH "mesh"
Indicates that the connection should create a mesh point.
Since: 1.20