|  |  |  | libnm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
enum NMDeviceWifiError; #define NM_DEVICE_WIFI_ERROR GQuark nm_device_wifi_error_quark (void); #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 NMDeviceWifi; NMDeviceWifiClass; GObject * nm_device_wifi_new (DBusGConnection *connection,const char *path); const char * nm_device_wifi_get_hw_address (NMDeviceWifi *device); const char * nm_device_wifi_get_permanent_hw_address (NMDeviceWifi *device); NM80211Mode nm_device_wifi_get_mode (NMDeviceWifi *device); guint32 nm_device_wifi_get_bitrate (NMDeviceWifi *device); NMDeviceWifiCapabilities nm_device_wifi_get_capabilities (NMDeviceWifi *device); NMAccessPoint * nm_device_wifi_get_active_access_point (NMDeviceWifi *device); NMAccessPoint * nm_device_wifi_get_access_point_by_path (NMDeviceWifi *device,const char *path); const GPtrArray * nm_device_wifi_get_access_points (NMDeviceWifi *device); void (*NMDeviceWifiRequestScanFn) (NMDeviceWifi *device,GError *error,gpointer user_data); void nm_device_wifi_request_scan_simple (NMDeviceWifi *device,NMDeviceWifiRequestScanFn callback,gpointer user_data);
"active-access-point" NMAccessPoint* : Read "bitrate" guint : Read "hw-address" gchar* : Read "mode" guint : Read "perm-hw-address" gchar* : Read "wireless-capabilities" guint : Read
typedef enum {
	NM_DEVICE_WIFI_ERROR_UNKNOWN = 0,             /*< nick=UnknownError >*/
	NM_DEVICE_WIFI_ERROR_NOT_WIFI_CONNECTION,     /*< nick=NotWifiConnection >*/
	NM_DEVICE_WIFI_ERROR_INVALID_WIFI_CONNECTION, /*< nick=InvalidWifiConnection >*/
	NM_DEVICE_WIFI_ERROR_INVALID_DEVICE_MAC,      /*< nick=InvalidDeviceMac >*/
	NM_DEVICE_WIFI_ERROR_MAC_MISMATCH,            /*< nick=MacMismatch >*/
	NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_WPA_CAPS, /*< nick=MissingDeviceWpaCaps >*/
	NM_DEVICE_WIFI_ERROR_MISSING_DEVICE_RSN_CAPS, /*< nick=MissingDeviceRsnCaps >*/
} NMDeviceWifiError;
| unknown or unclassified error | |
| the connection was not of Wi-Fi type | |
| the Wi-Fi connection was invalid | |
| the device's MAC was invalid | |
| the MACs of the connection and the device mismatched | |
| the device missed WPA capabilities required by the connection | |
| the device missed RSN capabilities required by the connection | 
GQuark              nm_device_wifi_error_quark          (void);
Registers an error quark for NMDeviceWifi if necessary.
| Returns : | the error quark used for NMDeviceWifi errors. | 
typedef struct {
	NMDeviceClass parent;
	/* Signals */
	void (*access_point_added) (NMDeviceWifi *device, NMAccessPoint *ap);
	void (*access_point_removed) (NMDeviceWifi *device, NMAccessPoint *ap);
	/* Padding for future expansion */
	void (*_reserved1) (void);
	void (*_reserved2) (void);
	void (*_reserved3) (void);
	void (*_reserved4) (void);
	void (*_reserved5) (void);
	void (*_reserved6) (void);
} NMDeviceWifiClass;
GObject * nm_device_wifi_new (DBusGConnection *connection,const char *path);
Creates a new NMDeviceWifi.
| 
 | the DBusGConnection | 
| 
 | the DBus object path of the device | 
| Returns : | a new WiFi device. [transfer full] | 
const char *        nm_device_wifi_get_hw_address       (NMDeviceWifi *device);
Gets the actual hardware (MAC) address of the NMDeviceWifi
| 
 | a NMDeviceWifi | 
| Returns : | the actual hardware address. This is the internal string used by the device, and must not be modified. | 
const char *        nm_device_wifi_get_permanent_hw_address
                                                        (NMDeviceWifi *device);
Gets the permanent hardware (MAC) address of the NMDeviceWifi
| 
 | a NMDeviceWifi | 
| Returns : | the permanent hardware address. This is the internal string used by the device, and must not be modified. | 
NM80211Mode         nm_device_wifi_get_mode             (NMDeviceWifi *device);
Gets the NMDeviceWifi mode.
| 
 | a NMDeviceWifi | 
| Returns : | the mode | 
guint32             nm_device_wifi_get_bitrate          (NMDeviceWifi *device);
Gets the bit rate of the NMDeviceWifi.
| 
 | a NMDeviceWifi | 
| Returns : | the bit rate | 
NMDeviceWifiCapabilities nm_device_wifi_get_capabilities
                                                        (NMDeviceWifi *device);
Gets the WIFI capabilities of the NMDeviceWifi.
| 
 | a NMDeviceWifi | 
| Returns : | the capabilities | 
NMAccessPoint *     nm_device_wifi_get_active_access_point
                                                        (NMDeviceWifi *device);
Gets the active NMAccessPoint.
| 
 | a NMDeviceWifi | 
| Returns : | the access point or NULLif none is active. [transfer none] | 
NMAccessPoint * nm_device_wifi_get_access_point_by_path (NMDeviceWifi *device,const char *path);
Gets a NMAccessPoint by path.
| 
 | a NMDeviceWifi | 
| 
 | the object path of the access point | 
| Returns : | the access point or NULLif none is found. [transfer none] | 
const GPtrArray *   nm_device_wifi_get_access_points    (NMDeviceWifi *device);
Gets all the scanned access points of the NMDeviceWifi.
| 
 | 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 NMClient.AccessPoint] | 
void (*NMDeviceWifiRequestScanFn) (NMDeviceWifi *device,GError *error,gpointer user_data);
void nm_device_wifi_request_scan_simple (NMDeviceWifi *device,NMDeviceWifiRequestScanFn callback,gpointer user_data);
Request NM to scan for access points on the NMDeviceWifi. This function only
instructs NM to perform scanning. Use nm_device_wifi_get_access_points()
to get available access points.
| 
 | a NMDeviceWifi | 
| 
 | the function to call when the call is done. [scope async][allow-none] | 
| 
 | user data to pass to the callback function. [closure] | 
Since 0.9.8
"active-access-point" property"active-access-point" NMAccessPoint* : Read
The active NMAccessPoint of the device.
"hw-address" property"hw-address" gchar* : Read
The hardware (MAC) address of the device.
Default value: NULL
"mode" property"mode" guint : Read
The mode of the device.
Allowed values: <= 3
Default value: 2
"perm-hw-address" property"perm-hw-address" gchar* : Read
The hardware (MAC) address of the device.
Default value: NULL
"wireless-capabilities" property"wireless-capabilities" guint : Read
The wireless capabilities of the device.
Default value: 0
"access-point-added" signalvoid                user_function                      (NMDeviceWifi *device,
                                                        GObject      *ap,
                                                        gpointer      user_data)      : Run First
Notifies that a NMAccessPoint is added to the wifi device.
| 
 | the wifi device that received the signal | 
| 
 | the new access point | 
| 
 | user data set when the signal handler was connected. | 
"access-point-removed" signalvoid                user_function                      (NMDeviceWifi *device,
                                                        GObject      *ap,
                                                        gpointer      user_data)      : Run First
Notifies that a NMAccessPoint is removed from the wifi device.
| 
 | the wifi device that received the signal | 
| 
 | the removed access point | 
| 
 | user data set when the signal handler was connected. |