| Top |
| GPtrArray * | access-points | Read |
| NMAccessPoint * | active-access-point | Read |
| guint | bitrate | Read |
| gint64 | last-scan | Read |
| NM80211Mode | mode | Read |
| char * | perm-hw-address | Read |
| NMDeviceWifiCapabilities | wireless-capabilities | Read |
| #define | NM_DEVICE_WIFI_HW_ADDRESS |
| #define | NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS |
| #define | NM_DEVICE_WIFI_MODE |
| #define | NM_DEVICE_WIFI_BITRATE |
| #define | NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT |
| #define | NM_DEVICE_WIFI_CAPABILITIES |
| #define | NM_DEVICE_WIFI_ACCESS_POINTS |
| #define | NM_DEVICE_WIFI_LAST_SCAN |
| NMDeviceWifi |
const char *
nm_device_wifi_get_hw_address (NMDeviceWifi *device);
nm_device_wifi_get_hw_address has been deprecated since version 1.24 and should not be used in newly-written code.
Use nm_device_get_hw_address() instead.
Gets the actual hardware (MAC) address of the NMDeviceWifi
[skip]
const char *
nm_device_wifi_get_permanent_hw_address
(NMDeviceWifi *device);
Gets the permanent hardware (MAC) address of the NMDeviceWifi
NM80211Mode
nm_device_wifi_get_mode (NMDeviceWifi *device);
Gets the NMDeviceWifi mode.
guint32
nm_device_wifi_get_bitrate (NMDeviceWifi *device);
Gets the bit rate of the NMDeviceWifi in kbit/s.
NMDeviceWifiCapabilities
nm_device_wifi_get_capabilities (NMDeviceWifi *device);
Gets the Wi-Fi capabilities of the NMDeviceWifi.
NMAccessPoint *
nm_device_wifi_get_active_access_point
(NMDeviceWifi *device);
Gets the active NMAccessPoint.
NMAccessPoint * nm_device_wifi_get_access_point_by_path (NMDeviceWifi *device,const char *path);
Gets a NMAccessPoint by path.
const GPtrArray *
nm_device_wifi_get_access_points (NMDeviceWifi *device);
Gets all the scanned access points of the NMDeviceWifi.
a GPtrArray containing all the scanned NMAccessPoints. The returned array is owned by the client and should not be modified.
[element-type NMAccessPoint]
gint64
nm_device_wifi_get_last_scan (NMDeviceWifi *device);
Returns the timestamp (in CLOCK_BOOTTIME milliseconds) for the last finished network scan. A value of -1 means the device never scanned for access points.
Use nm_utils_get_timestamp_msec() to obtain current time value suitable for
comparing to this value.
Since: 1.12
gboolean nm_device_wifi_request_scan (NMDeviceWifi *device,GCancellable *cancellable,GError **error);
nm_device_wifi_request_scan has been deprecated since version 1.22 and should not be used in newly-written code.
Use nm_device_wifi_request_scan_async() or GDBusConnection.
Request NM to scan for access points on device
. Note that the function
returns immediately after requesting the scan, and it may take some time
after that for the scan to complete.
gboolean nm_device_wifi_request_scan_options (NMDeviceWifi *device,GVariant *options,GCancellable *cancellable,GError **error);
nm_device_wifi_request_scan_options has been deprecated since version 1.22 and should not be used in newly-written code.
Use nm_device_wifi_request_scan_options_async() or GDBusConnection.
Request NM to scan for access points on device
. Note that the function
returns immediately after requesting the scan, and it may take some time
after that for the scan to complete.
This is the same as nm_device_wifi_request_scan
except it accepts options
for the scanning. The argument is the dictionary passed to RequestScan()
D-Bus call. Valid options inside the dictionary are:
'ssids' => array of SSIDs (saay)
device |
||
options |
dictionary with options for |
|
cancellable |
a GCancellable, or |
|
error |
Since: 1.2
void nm_device_wifi_request_scan_async (NMDeviceWifi *device,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Request NM to scan for access points on device
. Note that callback
will be
called immediately after requesting the scan, and it may take some time after
that for the scan to complete.
device |
||
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the scan has been requested |
|
user_data |
caller-specific data passed to |
void nm_device_wifi_request_scan_options_async (NMDeviceWifi *device,GVariant *options,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Request NM to scan for access points on device
. Note that callback
will be
called immediately after requesting the scan, and it may take some time after
that for the scan to complete.
This is the same as nm_device_wifi_request_scan_async
except it accepts options
for the scanning. The argument is the dictionary passed to RequestScan()
D-Bus call. Valid options inside the dictionary are:
'ssids' => array of SSIDs (saay)
To complete the request call nm_device_wifi_request_scan_finish().
device |
||
options |
dictionary with options for |
|
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the scan has been requested |
|
user_data |
caller-specific data passed to |
Since: 1.2
gboolean nm_device_wifi_request_scan_finish (NMDeviceWifi *device,GAsyncResult *result,GError **error);
Gets the result of a call to nm_device_wifi_request_scan_async() and
nm_device_wifi_request_scan_options_async().
“access-points” property“access-points” GPtrArray *
List of all Wi-Fi access points the device can see.
[type GPtrArray(NMAccessPoint)]
Owner: NMDeviceWifi
Flags: Read
“active-access-point” property“active-access-point” NMAccessPoint *
The active NMAccessPoint of the device.
Owner: NMDeviceWifi
Flags: Read
“bitrate” property“bitrate” guint
The bit rate of the device in kbit/s.
Owner: NMDeviceWifi
Flags: Read
Default value: 0
“last-scan” property“last-scan” gint64
The timestamp (in CLOCK_BOOTTIME seconds) for the last finished network scan. A value of -1 means the device never scanned for access points.
Owner: NMDeviceWifi
Flags: Read
Allowed values: >= -1
Default value: -1
Since: 1.12
“mode” property“mode” NM80211Mode
The mode of the device.
Owner: NMDeviceWifi
Flags: Read
Default value: NM_802_11_MODE_UNKNOWN
“perm-hw-address” property “perm-hw-address” char *
The hardware (MAC) address of the device.
Owner: NMDeviceWifi
Flags: Read
Default value: NULL
“wireless-capabilities” property“wireless-capabilities” NMDeviceWifiCapabilities
The wireless capabilities of the device.
Owner: NMDeviceWifi
Flags: Read
“access-point-added” signalvoid user_function (NMDeviceWifi *device, GObject *ap, gpointer user_data)
Notifies that a NMAccessPoint is added to the Wi-Fi device.
device |
the Wi-Fi device that received the signal |
|
ap |
the new access point |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“access-point-removed” signalvoid user_function (NMDeviceWifi *device, GObject *ap, gpointer user_data)
Notifies that a NMAccessPoint is removed from the Wi-Fi device.
device |
the Wi-Fi device that received the signal |
|
ap |
the removed access point |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First