SettingWireless

---

Object Hierarchy:

Description:

Content:

Constants:

• public const string AP_ISOLATION
• public const string BAND
• public const string BSSID
• public const string CHANNEL
• public const string CHANNEL_WIDTH
• public const string CLONED_MAC_ADDRESS
• public const string GENERATE_MAC_ADDRESS_MASK
• public const string HIDDEN
• public const string MAC_ADDRESS
• public const string MAC_ADDRESS_BLACKLIST
• public const string MAC_ADDRESS_DENYLIST
• public const string MAC_ADDRESS_RANDOMIZATION
• public const string MODE
• public const string MODE_ADHOC
  Indicates Ad-Hoc mode where no access point is expected to be present.
• public const string MODE_AP
  Indicates AP/master mode where the wireless device is started as an access point/hotspot.
• public const string MODE_INFRA
  Indicates infrastructure mode where an access point is expected to be present for this connection.
• public const string MODE_MESH
  Indicates that the connection should create a mesh point.
• public const string MTU
• public const string POWERSAVE
• public const string RATE
• public const string SEEN_BSSIDS
• public const string SETTING_NAME
• public const string SSID
• public const string TX_POWER
• public const string WAKE_ON_WLAN

Properties:

• public Ternary ap_isolation { get; set; }
  Configures AP isolation, which prevents communication between wireless devices connected to this AP.
• public string band { owned get; set; }
  802.11 frequency band of the network.
• public string bssid { owned get; set; }
  If specified, directs the device to only associate with the given access point.
• public uint channel { get; set; }
  Wireless channel to use for the Wi-Fi connection.
• public int channel_width { get; set; }
  Specifies width of the wireless channel in Access Point (AP) mode.
• public string cloned_mac_address { owned get; set; }
  If specified, request that the device use this MAC address instead.
• public string generate_mac_address_mask { owned get; set; }
  With cloned_mac_address setting "random" or "stable", by default all bits of the MAC address are scrambled and a locally-administered, unicast MAC address is created.
• public bool hidden { get; set; }
  If true, indicates that the network is a non-broadcasting network that hides its SSID.
• public string mac_address { owned get; set; }
  If specified, this connection will only apply to the Wi-Fi device whose permanent MAC address matches.
• public string[] mac_address_blacklist { owned get; set; }
  A list of permanent MAC addresses of Wi-Fi devices to which this connection should never apply.
• public string[] mac_address_denylist { owned get; set; }
  A list of permanent MAC addresses of Wi-Fi devices to which this connection should never apply.
• public uint mac_address_randomization { get; set; }
  One of nm_setting_mac_randomization_default (never randomize unless the user has set a global default to randomize and the supplicant supports randomization), nm_setting_mac_randomization_never (never randomize the MAC address), or nm_setting_mac_randomization_always (always randomize the MAC address).
• public string mode { owned get; set; }
  Wi-Fi network mode; one of "infrastructure", "mesh", "adhoc" or "ap".
• public uint mtu { get; set; }
  If non-zero, only transmit packets of the specified size or smaller, breaking larger packets up into multiple Ethernet frames.
• public uint powersave { get; set; }
  One of nm_setting_wireless_powersave_disable (disable Wi-Fi power saving), nm_setting_wireless_powersave_enable (enable Wi-Fi power saving), nm_setting_wireless_powersave_ignore (don't touch currently configure setting) or nm_setting_wireless_powersave_default (use the globally configured value).
• public uint rate { get; set; }
  This property is not implemented and has no effect.
• public string[] seen_bssids { owned get; set; }
  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.
• public Bytes ssid { owned get; set; }
  SSID of the Wi-Fi network.
• public uint tx_power { get; set; }
  This property is not implemented and has no effect.
• public uint wake_on_wlan { get; set; }
  The SettingWirelessWakeOnWLan options to enable.

Creation methods:

• public SettingWireless ()
  Creates a new SettingWireless object with default values.

Methods:

• public bool add_mac_blacklist_item (string mac)
  Adds a new MAC address to the mac_address_denylist property.
• public bool add_mac_denylist_item (string mac)
  Adds a new MAC address to the mac_address_denylist property.
• public bool add_seen_bssid (string bssid)
  Adds a new Wi-Fi AP's BSSID to the previously seen BSSID list of the setting.
• public bool ap_security_compatible (SettingWirelessSecurity s_wireless_sec, @80211ApFlags ap_flags, @80211ApSecurityFlags ap_wpa, @80211ApSecurityFlags ap_rsn, @80211Mode ap_mode)
  Given a SettingWireless and an optional SettingWirelessSecurity, 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.
• public void clear_mac_blacklist_items ()
  Removes all denylisted MAC addresses.
• public void clear_mac_denylist_items ()
  Removes all denylisted MAC addresses.
• public Ternary get_ap_isolation ()
• public unowned string get_band ()
• public unowned string get_bssid ()
• public uint32 get_channel ()
• public SettingWirelessChannelWidth get_channel_width ()
  Returns the channel_width property.
• public unowned string get_cloned_mac_address ()
• public unowned string get_generate_mac_address_mask ()
• public bool get_hidden ()
• public unowned string get_mac_address ()
• public unowned string[] get_mac_address_blacklist ()
• public unowned string[] get_mac_address_denylist ()
• public SettingMacRandomization get_mac_address_randomization ()
• public unowned string get_mac_blacklist_item (uint32 idx)
  Since 1.46, access at index "len" is allowed and returns NULL.
• public unowned string get_mac_denylist_item (uint32 idx)
• public unowned string get_mode ()
• public uint32 get_mtu ()
• public uint32 get_num_mac_blacklist_items ()
• public uint32 get_num_mac_denylist_items ()
• public uint32 get_num_seen_bssids ()
• public uint32 get_powersave ()
• public uint32 get_rate ()
• public unowned string get_seen_bssid (uint32 i)
• public unowned Bytes get_ssid ()
• public uint32 get_tx_power ()
• public SettingWirelessWakeOnWLan get_wake_on_wlan ()
  Returns the Wake-on-WLAN options enabled for the connection
• public void remove_mac_blacklist_item (uint32 idx)
  Removes the MAC address at index idx from the denylist.
• public bool remove_mac_blacklist_item_by_value (string mac)
  Removes the MAC address mac from the denylist.
• public void remove_mac_denylist_item (uint32 idx)
  Removes the MAC address at index idx from the denylist.
• public bool remove_mac_denylist_item_by_value (string mac)
  Removes the MAC address mac from the denylist.

Inherited Members: