Top |
guint | bandwidth | Read |
char * | bssid | Read |
NM80211ApFlags | flags | Read |
guint | frequency | Read |
char * | hw-address | Read |
int | last-seen | Read |
guint | max-bitrate | Read |
NM80211Mode | mode | Read |
NM80211ApSecurityFlags | rsn-flags | Read |
GBytes * | ssid | Read |
guchar | strength | Read |
NM80211ApSecurityFlags | wpa-flags | Read |
#define | NM_ACCESS_POINT_FLAGS |
#define | NM_ACCESS_POINT_WPA_FLAGS |
#define | NM_ACCESS_POINT_RSN_FLAGS |
#define | NM_ACCESS_POINT_SSID |
#define | NM_ACCESS_POINT_BSSID |
#define | NM_ACCESS_POINT_FREQUENCY |
#define | NM_ACCESS_POINT_MODE |
#define | NM_ACCESS_POINT_MAX_BITRATE |
#define | NM_ACCESS_POINT_STRENGTH |
#define | NM_ACCESS_POINT_LAST_SEEN |
#define | NM_ACCESS_POINT_BANDWIDTH |
#define | NM_ACCESS_POINT_HW_ADDRESS |
NMAccessPoint |
NM80211ApFlags
nm_access_point_get_flags (NMAccessPoint *ap
);
Gets the flags of the access point.
NM80211ApSecurityFlags
nm_access_point_get_wpa_flags (NMAccessPoint *ap
);
Gets the WPA (version 1) flags of the access point.
NM80211ApSecurityFlags
nm_access_point_get_rsn_flags (NMAccessPoint *ap
);
Gets the RSN (Robust Secure Network, ie WPA version 2) flags of the access point.
GBytes *
nm_access_point_get_ssid (NMAccessPoint *ap
);
Gets the SSID of the access point.
const char *
nm_access_point_get_bssid (NMAccessPoint *ap
);
Gets the Basic Service Set ID (BSSID) of the Wi-Fi access point.
guint32
nm_access_point_get_frequency (NMAccessPoint *ap
);
Gets the frequency of the access point in MHz.
NM80211Mode
nm_access_point_get_mode (NMAccessPoint *ap
);
Gets the mode of the access point.
guint32
nm_access_point_get_max_bitrate (NMAccessPoint *ap
);
Gets the maximum bit rate of the access point in kbit/s.
guint8
nm_access_point_get_strength (NMAccessPoint *ap
);
Gets the current signal strength of the access point as a percentage.
int
nm_access_point_get_last_seen (NMAccessPoint *ap
);
Returns the timestamp (in CLOCK_BOOTTIME seconds) for the last time the access point was found in scan results. A value of -1 means the access point has not been found in a scan.
Since: 1.2
guint32
nm_access_point_get_bandwidth (NMAccessPoint *ap
);
Gets the bandwidth advertised by the access point in MHz.
Since: 1.46
GPtrArray * nm_access_point_filter_connections (NMAccessPoint *ap
,const GPtrArray *connections
);
Filters a given array of connections for a given NMAccessPoint object and
returns connections which may be activated with the access point. Any
returned connections will match the ap
's SSID and (if given) BSSID and
other attributes like security settings, channel, etc.
To obtain the list of connections that are compatible with this access point,
use nm_client_get_connections()
and then filter the returned list for a given
NMDevice using nm_device_filter_connections()
and finally filter that list
with this function.
ap |
an NMAccessPoint to filter connections for |
|
connections |
an array of NMConnections to filter. |
[element-type NMConnection] |
an array of
NMConnections that could be activated with the given ap
. The array should
be freed with g_ptr_array_unref()
when it is no longer required.
WARNING: the transfer annotation for this function may not work correctly
with bindings. See https://gitlab.gnome.org/GNOME/gobject-introspection/-/issues/305.
You can filter the list yourself with nm_access_point_connection_valid()
.
[transfer full][element-type NMConnection]
gboolean nm_access_point_connection_valid (NMAccessPoint *ap
,NMConnection *connection
);
Validates a given connection against a given Wi-Fi access point to ensure that
the connection may be activated with that AP. The connection must match the
ap
's SSID, (if given) BSSID, and other attributes like security settings,
channel, band, etc.
ap |
an NMAccessPoint to validate |
|
connection |
an NMConnection to validate against |
“bandwidth”
property“bandwidth” guint
The channel bandwidth announced by the AP in MHz.
Owner: NMAccessPoint
Flags: Read
Default value: 0
Since: 1.46
“bssid”
property “bssid” char *
The BSSID of the access point.
Owner: NMAccessPoint
Flags: Read
Default value: NULL
“flags”
property“flags” NM80211ApFlags
The flags of the access point.
Owner: NMAccessPoint
Flags: Read
“frequency”
property“frequency” guint
The frequency of the access point.
Owner: NMAccessPoint
Flags: Read
Allowed values: <= 10000
Default value: 0
“hw-address”
property “hw-address” char *
Alias for “bssid”.
NMAccessPoint:hw-address
has been deprecated since version 1.0 and should not be used in newly-written code.
Use “bssid”.
Owner: NMAccessPoint
Flags: Read
Default value: NULL
“last-seen”
property “last-seen” int
The timestamp (in CLOCK_BOOTTIME seconds) for the last time the access point was found in scan results. A value of -1 means the access point has not been found in a scan.
Owner: NMAccessPoint
Flags: Read
Allowed values: >= -1
Default value: -1
Since: 1.2
“max-bitrate”
property“max-bitrate” guint
The maximum bit rate of the access point in kbit/s.
Owner: NMAccessPoint
Flags: Read
Default value: 0
“mode”
property“mode” NM80211Mode
The mode of the access point; either "infrastructure" (a central coordinator of the wireless network allowing clients to connect) or "ad-hoc" (a network with no central controller).
Owner: NMAccessPoint
Flags: Read
Default value: NM_802_11_MODE_UNKNOWN
“rsn-flags”
property“rsn-flags” NM80211ApSecurityFlags
The RSN flags of the access point.
Owner: NMAccessPoint
Flags: Read
“ssid”
property“ssid” GBytes *
The SSID of the access point, or NULL
if it is not known.
Owner: NMAccessPoint
Flags: Read
“strength”
property“strength” guchar
The current signal strength of the access point.
Owner: NMAccessPoint
Flags: Read
Default value: 0
“wpa-flags”
property“wpa-flags” NM80211ApSecurityFlags
The WPA flags of the access point.
Owner: NMAccessPoint
Flags: Read