NMDeviceWifi: libnm Reference Manual

## NMDeviceWifi NMDeviceWifi |

## Functions

const char * | nm_device_wifi_get_hw_address ()
const char * | nm_device_wifi_get_permanent_hw_address ()
NM80211Mode | nm_device_wifi_get_mode ()
guint32 | nm_device_wifi_get_bitrate ()
NMDeviceWifiCapabilities | nm_device_wifi_get_capabilities ()
NMAccessPoint * | nm_device_wifi_get_active_access_point ()
NMAccessPoint * | nm_device_wifi_get_access_point_by_path ()
const GPtrArray * | nm_device_wifi_get_access_points ()
gint64 | nm_device_wifi_get_last_scan ()
gboolean | nm_device_wifi_request_scan ()
gboolean | nm_device_wifi_request_scan_options ()
void | nm_device_wifi_request_scan_async ()
void | nm_device_wifi_request_scan_options_async ()
gboolean | nm_device_wifi_request_scan_finish ()

## Properties

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

## Signals

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

## 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
#define | NM_DEVICE_WIFI_LAST_SCAN
| NMDeviceWifi

## Object Hierarchy

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

## Description

## Functions

### nm_device_wifi_get_hw_address ()

    const char *
    nm_device_wifi_get_hw_address (NMDeviceWifi *device);

`nm_device_wifi_get_hw_address` is deprecated and should not be used in newly-written code.

### nm_device_wifi_get_permanent_hw_address ()

    const char *
    nm_device_wifi_get_permanent_hw_address
                                   (NMDeviceWifi *device);

### nm_device_wifi_get_mode ()

    NM80211Mode
    nm_device_wifi_get_mode (NMDeviceWifi *device);

### nm_device_wifi_get_bitrate ()

    guint32
    nm_device_wifi_get_bitrate (NMDeviceWifi *device);

### nm_device_wifi_get_capabilities ()

    NMDeviceWifiCapabilities
    nm_device_wifi_get_capabilities (NMDeviceWifi *device);

### nm_device_wifi_get_active_access_point ()

    NMAccessPoint *
    nm_device_wifi_get_active_access_point
                                   (NMDeviceWifi *device);

### nm_device_wifi_get_access_point_by_path ()

    NMAccessPoint *
    nm_device_wifi_get_access_point_by_path
                                   (NMDeviceWifi *device,
                                    const char *path);

### nm_device_wifi_get_access_points ()

    const GPtrArray *
    nm_device_wifi_get_access_points (NMDeviceWifi *device);

### nm_device_wifi_get_last_scan ()

    gint64
    nm_device_wifi_get_last_scan (NMDeviceWifi *device);

### nm_device_wifi_request_scan ()

    gboolean
    nm_device_wifi_request_scan (NMDeviceWifi *device,
                                 GCancellable *cancellable,
                                 GError **error);

`nm_device_wifi_request_scan` is deprecated and should not be used in newly-written code.

### nm_device_wifi_request_scan_options ()

    gboolean
    nm_device_wifi_request_scan_options (NMDeviceWifi *device,
                                         GVariant *options,
                                         GCancellable *cancellable,
                                         GError **error);

`nm_device_wifi_request_scan_options` is deprecated and should not be used in newly-written code.

### nm_device_wifi_request_scan_async ()

    void
    nm_device_wifi_request_scan_async (NMDeviceWifi *device,
                                       GCancellable *cancellable,
                                       GAsyncReadyCallback callback,
                                       gpointer user_data);

### 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);

### nm_device_wifi_request_scan_finish ()

    gboolean
    nm_device_wifi_request_scan_finish (NMDeviceWifi *device,
                                        GAsyncResult *result,
                                        GError **error);

## 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"

### NM_DEVICE_WIFI_LAST_SCAN

    #define NM_DEVICE_WIFI_LAST_SCAN            "last-scan"

### NMDeviceWifi

    typedef struct _NMDeviceWifi NMDeviceWifi;

## Property Details

### The `“access-points”` property

      “access-points”            GPtrArray *

Owner: NMDeviceWifi

Flags: Read

### The `“active-access-point”` property

      “active-access-point”      NMAccessPoint *

Owner: NMDeviceWifi

Flags: Read

### The `“bitrate”` property

      “bitrate”                  guint

Owner: NMDeviceWifi

Flags: Read

Default value: 0

### The `“last-scan”` property

      “last-scan”                gint64

Owner: NMDeviceWifi

Flags: Read

Allowed values: >= -1

Default value: -1

### The `“mode”` property

      “mode”                     NM80211Mode

Owner: NMDeviceWifi

Flags: Read

Default value: NM_802_11_MODE_UNKNOWN

### The `“perm-hw-address”` property

      “perm-hw-address”          char *

Owner: NMDeviceWifi

Flags: Read

Default value: NULL

### The `“wireless-capabilities”` property

      “wireless-capabilities”    NMDeviceWifiCapabilities

Owner: NMDeviceWifi

Flags: Read

## Signal Details

### The `“access-point-added”` signal

    void
    user_function (NMDeviceWifi *nmdevicewifi,
                   GObject      *arg1,
                   gpointer      user_data)

Flags: Run First

### The `“access-point-removed”` signal

    void
    user_function (NMDeviceWifi *nmdevicewifi,
                   GObject      *arg1,
                   gpointer      user_data)

Flags: Run First