nm_setting_wireless_new ()

NMSetting *
nm_setting_wireless_new (void);

Creates a new NMSettingWireless object with default values.

nm_setting_wireless_get_ssid ()

GBytes *
nm_setting_wireless_get_ssid (NMSettingWireless *setting);

nm_setting_wireless_get_mode ()

const char *
nm_setting_wireless_get_mode (NMSettingWireless *setting);

nm_setting_wireless_get_band ()

const char *
nm_setting_wireless_get_band (NMSettingWireless *setting);

nm_setting_wireless_get_channel ()

guint32
nm_setting_wireless_get_channel (NMSettingWireless *setting);

nm_setting_wireless_get_bssid ()

const char *
nm_setting_wireless_get_bssid (NMSettingWireless *setting);

nm_setting_wireless_get_rate ()

guint32
nm_setting_wireless_get_rate (NMSettingWireless *setting);

nm_setting_wireless_get_tx_power ()

guint32
nm_setting_wireless_get_tx_power (NMSettingWireless *setting);

nm_setting_wireless_get_mac_address ()

const char *
nm_setting_wireless_get_mac_address (NMSettingWireless *setting);

nm_setting_wireless_get_cloned_mac_address ()

const char *
nm_setting_wireless_get_cloned_mac_address
                               (NMSettingWireless *setting);

nm_setting_wireless_get_generate_mac_address_mask ()

const char *
nm_setting_wireless_get_generate_mac_address_mask
                               (NMSettingWireless *setting);

Since: 1.4

nm_setting_wireless_get_mac_address_blacklist ()

const char *const *
nm_setting_wireless_get_mac_address_blacklist
                               (NMSettingWireless *setting);

nm_setting_wireless_get_num_mac_blacklist_items ()

guint32
nm_setting_wireless_get_num_mac_blacklist_items
                               (NMSettingWireless *setting);

nm_setting_wireless_get_mac_blacklist_item ()

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.

nm_setting_wireless_add_mac_blacklist_item ()

gboolean
nm_setting_wireless_add_mac_blacklist_item
                               (NMSettingWireless *setting,
                                const char *mac);

Adds a new MAC address to the “mac-address-denylist” property.

nm_setting_wireless_remove_mac_blacklist_item ()

void
nm_setting_wireless_remove_mac_blacklist_item
                               (NMSettingWireless *setting,
                                guint32 idx);

Removes the MAC address at index idx from the denylist.

nm_setting_wireless_remove_mac_blacklist_item_by_value ()

gboolean
nm_setting_wireless_remove_mac_blacklist_item_by_value
                               (NMSettingWireless *setting,
                                const char *mac);

Removes the MAC address mac from the denylist.

nm_setting_wireless_clear_mac_blacklist_items ()

void
nm_setting_wireless_clear_mac_blacklist_items
                               (NMSettingWireless *setting);

Removes all denylisted MAC addresses.

nm_setting_wireless_get_mac_address_denylist ()

const char *const *
nm_setting_wireless_get_mac_address_denylist
                               (NMSettingWireless *setting);

Since: 1.48

nm_setting_wireless_get_num_mac_denylist_items ()

guint32
nm_setting_wireless_get_num_mac_denylist_items
                               (NMSettingWireless *setting);

Since: 1.48

nm_setting_wireless_get_mac_denylist_item ()

const char *
nm_setting_wireless_get_mac_denylist_item
                               (NMSettingWireless *setting,
                                guint32 idx);

Since: 1.48

nm_setting_wireless_add_mac_denylist_item ()

gboolean
nm_setting_wireless_add_mac_denylist_item
                               (NMSettingWireless *setting,
                                const char *mac);

Adds a new MAC address to the “mac-address-denylist” property.

Since: 1.48

nm_setting_wireless_remove_mac_denylist_item ()

void
nm_setting_wireless_remove_mac_denylist_item
                               (NMSettingWireless *setting,
                                guint32 idx);

Removes the MAC address at index idx from the denylist.

Since: 1.48

nm_setting_wireless_remove_mac_denylist_item_by_value ()

gboolean
nm_setting_wireless_remove_mac_denylist_item_by_value
                               (NMSettingWireless *setting,
                                const char *mac);

Removes the MAC address mac from the denylist.

Since: 1.48

nm_setting_wireless_clear_mac_denylist_items ()

void
nm_setting_wireless_clear_mac_denylist_items
                               (NMSettingWireless *setting);

Removes all denylisted MAC addresses.

Since: 1.48

nm_setting_wireless_get_mtu ()

guint32
nm_setting_wireless_get_mtu (NMSettingWireless *setting);

nm_setting_wireless_get_hidden ()

gboolean
nm_setting_wireless_get_hidden (NMSettingWireless *setting);

nm_setting_wireless_get_powersave ()

guint32
nm_setting_wireless_get_powersave (NMSettingWireless *setting);

Since: 1.2

nm_setting_wireless_get_mac_address_randomization ()

NMSettingMacRandomization
nm_setting_wireless_get_mac_address_randomization
                               (NMSettingWireless *setting);

Since: 1.2

nm_setting_wireless_add_seen_bssid ()

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.

nm_setting_wireless_get_num_seen_bssids ()

guint32
nm_setting_wireless_get_num_seen_bssids
                               (NMSettingWireless *setting);

nm_setting_wireless_get_seen_bssid ()

const char *
nm_setting_wireless_get_seen_bssid (NMSettingWireless *setting,
                                    guint32 i);

nm_setting_wireless_ap_security_compatible ()

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.

nm_setting_wireless_get_wake_on_wlan ()

NMSettingWirelessWakeOnWLan
nm_setting_wireless_get_wake_on_wlan (NMSettingWireless *setting);

Returns the Wake-on-WLAN options enabled for the connection

Since: 1.12

nm_setting_wireless_get_ap_isolation ()

NMTernary
nm_setting_wireless_get_ap_isolation (NMSettingWireless *setting);

Since: 1.28

nm_setting_wireless_get_channel_width ()

NMSettingWirelessChannelWidth
nm_setting_wireless_get_channel_width (NMSettingWireless *setting);

Returns the “channel-width” property.

Since: 1.50

NM_SETTING_WIRELESS_SETTING_NAME

#define NM_SETTING_WIRELESS_SETTING_NAME "802-11-wireless"

enum NMSettingWirelessWakeOnWLan

Options for “wake-on-wlan”. Note that not all options are supported by all devices.

Since: 1.12

NM_SETTING_WIRELESS_SSID

#define NM_SETTING_WIRELESS_SSID                      "ssid"

NM_SETTING_WIRELESS_MODE

#define NM_SETTING_WIRELESS_MODE                      "mode"

NM_SETTING_WIRELESS_BAND

#define NM_SETTING_WIRELESS_BAND                      "band"

NM_SETTING_WIRELESS_CHANNEL

#define NM_SETTING_WIRELESS_CHANNEL                   "channel"

NM_SETTING_WIRELESS_BSSID

#define NM_SETTING_WIRELESS_BSSID                     "bssid"

NM_SETTING_WIRELESS_RATE

#define NM_SETTING_WIRELESS_RATE                      "rate"

NM_SETTING_WIRELESS_TX_POWER

#define NM_SETTING_WIRELESS_TX_POWER                  "tx-power"

NM_SETTING_WIRELESS_MAC_ADDRESS

#define NM_SETTING_WIRELESS_MAC_ADDRESS               "mac-address"

NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS

#define NM_SETTING_WIRELESS_CLONED_MAC_ADDRESS        "cloned-mac-address"

NM_SETTING_WIRELESS_GENERATE_MAC_ADDRESS_MASK

#define NM_SETTING_WIRELESS_GENERATE_MAC_ADDRESS_MASK "generate-mac-address-mask"

NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST

#define NM_SETTING_WIRELESS_MAC_ADDRESS_BLACKLIST     "mac-address-blacklist"

NM_SETTING_WIRELESS_MAC_ADDRESS_DENYLIST

#define NM_SETTING_WIRELESS_MAC_ADDRESS_DENYLIST      "mac-address-denylist"

NM_SETTING_WIRELESS_MTU

#define NM_SETTING_WIRELESS_MTU                       "mtu"

NM_SETTING_WIRELESS_SEEN_BSSIDS

#define NM_SETTING_WIRELESS_SEEN_BSSIDS               "seen-bssids"

NM_SETTING_WIRELESS_HIDDEN

#define NM_SETTING_WIRELESS_HIDDEN                    "hidden"

NM_SETTING_WIRELESS_POWERSAVE

#define NM_SETTING_WIRELESS_POWERSAVE                 "powersave"

NM_SETTING_WIRELESS_MAC_ADDRESS_RANDOMIZATION

#define NM_SETTING_WIRELESS_MAC_ADDRESS_RANDOMIZATION "mac-address-randomization"

NM_SETTING_WIRELESS_WAKE_ON_WLAN

#define NM_SETTING_WIRELESS_WAKE_ON_WLAN              "wake-on-wlan"

NM_SETTING_WIRELESS_AP_ISOLATION

#define NM_SETTING_WIRELESS_AP_ISOLATION              "ap-isolation"

NM_SETTING_WIRELESS_CHANNEL_WIDTH

#define NM_SETTING_WIRELESS_CHANNEL_WIDTH             "channel-width"

NM_SETTING_WIRELESS_MODE_ADHOC

#define NM_SETTING_WIRELESS_MODE_ADHOC "adhoc"

Indicates Ad-Hoc mode where no access point is expected to be present.

NM_SETTING_WIRELESS_MODE_AP

#define NM_SETTING_WIRELESS_MODE_AP "ap"

Indicates AP/master mode where the wireless device is started as an access point/hotspot.

NM_SETTING_WIRELESS_MODE_INFRA

#define NM_SETTING_WIRELESS_MODE_INFRA "infrastructure"

Indicates infrastructure mode where an access point is expected to be present for this connection.

NM_SETTING_WIRELESS_MODE_MESH

#define NM_SETTING_WIRELESS_MODE_MESH "mesh"

Indicates that the connection should create a mesh point.

Since: 1.20

enum NMSettingWirelessPowersave

These flags indicate whether wireless powersave must be enabled.

Since: 1.2

enum NMSettingWirelessChannelWidth

Indicates the wireless channel width.

Since: 1.50