Top |
Functions
Properties
GPtrArray * | access-points | Read |
NMAccessPoint * | active-access-point | Read |
guint | bitrate | Read |
gchar * | hw-address | Read |
NM80211Mode | mode | Read |
gchar * | perm-hw-address | Read |
NMDeviceWifiCapabilities | wireless-capabilities | Read |
Types and Values
#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 |
NMDeviceWifi |
Functions
nm_device_wifi_get_hw_address ()
const char *
nm_device_wifi_get_hw_address (NMDeviceWifi *device
);
Gets the actual hardware (MAC) address of the NMDeviceWifi
nm_device_wifi_get_permanent_hw_address ()
const char *
nm_device_wifi_get_permanent_hw_address
(NMDeviceWifi *device
);
Gets the permanent hardware (MAC) address of the NMDeviceWifi
nm_device_wifi_get_mode ()
NM80211Mode
nm_device_wifi_get_mode (NMDeviceWifi *device
);
Gets the NMDeviceWifi mode.
nm_device_wifi_get_bitrate ()
guint32
nm_device_wifi_get_bitrate (NMDeviceWifi *device
);
Gets the bit rate of the NMDeviceWifi in kbit/s.
nm_device_wifi_get_capabilities ()
NMDeviceWifiCapabilities
nm_device_wifi_get_capabilities (NMDeviceWifi *device
);
Gets the Wi-Fi capabilities of the NMDeviceWifi.
nm_device_wifi_get_active_access_point ()
NMAccessPoint *
nm_device_wifi_get_active_access_point
(NMDeviceWifi *device
);
Gets the active NMAccessPoint.
nm_device_wifi_get_access_point_by_path ()
NMAccessPoint * nm_device_wifi_get_access_point_by_path (NMDeviceWifi *device
,const char *path
);
Gets a NMAccessPoint by path.
nm_device_wifi_get_access_points ()
const GPtrArray *
nm_device_wifi_get_access_points (NMDeviceWifi *device
);
Gets all the scanned access points of the NMDeviceWifi.
Returns
a GPtrArray containing all the scanned NMAccessPoints. The returned array is owned by the client and should not be modified.
[element-type NMAccessPoint]
nm_device_wifi_request_scan ()
gboolean nm_device_wifi_request_scan (NMDeviceWifi *device
,GCancellable *cancellable
,GError **error
);
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.
nm_device_wifi_request_scan_options ()
gboolean nm_device_wifi_request_scan_options (NMDeviceWifi *device
,GVariant *options
,GCancellable *cancellable
,GError **error
);
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 otions inside the dictionary are:
'ssids' => array of SSIDs (saay)
Parameters
device |
||
options |
dictionary with options for |
|
cancellable |
a GCancellable, or |
|
error |
Since: 1.2
nm_device_wifi_request_scan_async ()
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.
Parameters
device |
||
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the scan has been requested |
|
user_data |
caller-specific data passed to |
nm_device_wifi_request_scan_options_async ()
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 otions inside the dictionary are:
'ssids' => array of SSIDs (saay)
Parameters
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
nm_device_wifi_request_scan_finish ()
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()
.
Property Details
The “access-points”
property
“access-points” GPtrArray *
List of all Wi-Fi access points the device can see.
Element-type: NMAccessPoint
Flags: Read
The “active-access-point”
property
“active-access-point” NMAccessPoint *
The active NMAccessPoint of the device.
Flags: Read
The “bitrate”
property
“bitrate” guint
The bit rate of the device in kbit/s.
Flags: Read
Default value: 0
The “hw-address”
property
“hw-address” gchar *
The hardware (MAC) address of the device.
Flags: Read
Default value: NULL
The “mode”
property
“mode” NM80211Mode
The mode of the device.
Flags: Read
Default value: NM_802_11_MODE_UNKNOWN
The “perm-hw-address”
property
“perm-hw-address” gchar *
The hardware (MAC) address of the device.
Flags: Read
Default value: NULL
The “wireless-capabilities”
property
“wireless-capabilities” NMDeviceWifiCapabilities
The wireless capabilities of the device.
Flags: Read
Signal Details
The “access-point-added”
signal
void user_function (NMDeviceWifi *device, GObject *ap, gpointer user_data)
Notifies that a NMAccessPoint is added to the Wi-Fi device.
Parameters
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
The “access-point-removed”
signal
void user_function (NMDeviceWifi *device, GObject *ap, gpointer user_data)
Notifies that a NMAccessPoint is removed from the Wi-Fi device.
Parameters
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