NMDeviceWifi

NMDeviceWifi

Properties

Signals

void access-point-added Run First
void access-point-removed Run First

Object Hierarchy

    GObject
    ╰── NMObject
        ╰── NMDevice
            ╰── NMDeviceWifi

Description

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

Parameters

device

a NMDeviceWifi

 

Returns

the actual hardware address. This is the internal string used by the device, and must not be modified.


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

Parameters

device

a NMDeviceWifi

 

Returns

the permanent hardware address. This is the internal string used by the device, and must not be modified.


nm_device_wifi_get_mode ()

NM80211Mode
nm_device_wifi_get_mode (NMDeviceWifi *device);

Gets the NMDeviceWifi mode.

Parameters

device

a NMDeviceWifi

 

Returns

the mode


nm_device_wifi_get_bitrate ()

guint32
nm_device_wifi_get_bitrate (NMDeviceWifi *device);

Gets the bit rate of the NMDeviceWifi in kbit/s.

Parameters

device

a NMDeviceWifi

 

Returns

the bit rate (kbit/s)


nm_device_wifi_get_capabilities ()

NMDeviceWifiCapabilities
nm_device_wifi_get_capabilities (NMDeviceWifi *device);

Gets the Wi-Fi capabilities of the NMDeviceWifi.

Parameters

device

a NMDeviceWifi

 

Returns

the capabilities


nm_device_wifi_get_active_access_point ()

NMAccessPoint *
nm_device_wifi_get_active_access_point
                               (NMDeviceWifi *device);

Gets the active NMAccessPoint.

Parameters

device

a NMDeviceWifi

 

Returns

the access point or NULL if none is active.

[transfer none]


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.

Parameters

device

a NMDeviceWifi

 

path

the object path of the access point

 

Returns

the access point or NULL if none is found.

[transfer none]


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.

Parameters

device

a 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.

Parameters

device

a NMDeviceWifi

 

cancellable

a GCancellable, or NULL

 

error

location for a GError, or NULL

 

Returns

TRUE on success, FALSE on error, in which case error will be set.


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

a NMDeviceWifi

 

cancellable

a GCancellable, or NULL

 

callback

callback to be called when the scan has been requested

 

user_data

caller-specific data passed to callback

 

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().

Parameters

device

a NMDeviceWifi

 

result

the result passed to the GAsyncReadyCallback

 

error

location for a GError, or NULL

 

Returns

TRUE on success, FALSE on error, in which case error will be set.

Types and Values

NM_DEVICE_WIFI_HW_ADDRESS

#define NM_DEVICE_WIFI_HW_ADDRESS          "hw-address"


NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS

#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"


NM_DEVICE_WIFI_MODE

#define NM_DEVICE_WIFI_MODE                "mode"


NM_DEVICE_WIFI_BITRATE

#define NM_DEVICE_WIFI_BITRATE             "bitrate"


NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT

#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT "active-access-point"


NM_DEVICE_WIFI_CAPABILITIES

#define NM_DEVICE_WIFI_CAPABILITIES        "wireless-capabilities"


NM_DEVICE_WIFI_ACCESS_POINTS

#define NM_DEVICE_WIFI_ACCESS_POINTS       "access-points"

Property Details

The “access-points” property

  “access-points”            GPtrArray *

Flags: Read


The “active-access-point” property

  “active-access-point”      NMAccessPoint *

Flags: Read


The “bitrate” property

  “bitrate”                  guint

Flags: Read

Default value: 0


The “hw-address” property

  “hw-address”               gchar *

Flags: Read

Default value: NULL


The “mode” property

  “mode”                     NM80211Mode

Flags: Read

Default value: NM_802_11_MODE_UNKNOWN


The “perm-hw-address” property

  “perm-hw-address”          gchar *

Flags: Read

Default value: NULL


The “wireless-capabilities” property

  “wireless-capabilities”    NMDeviceWifiCapabilities

Flags: Read

Signal Details

The “access-point-added” signal

void
user_function (NMDeviceWifi *device,
               GObject      *ap,
               gpointer      user_data)

Flags: Run First


The “access-point-removed” signal

void
user_function (NMDeviceWifi *device,
               GObject      *ap,
               gpointer      user_data)

Flags: Run First