|  |  |  | libnm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
#define NM_DEVICE_UDI #define NM_DEVICE_INTERFACE #define NM_DEVICE_IP_INTERFACE #define NM_DEVICE_DRIVER #define NM_DEVICE_CAPABILITIES #define NM_DEVICE_MANAGED #define NM_DEVICE_FIRMWARE_MISSING #define NM_DEVICE_IP4_CONFIG #define NM_DEVICE_DHCP4_CONFIG #define NM_DEVICE_IP6_CONFIG #define NM_DEVICE_DHCP6_CONFIG #define NM_DEVICE_STATE #define NM_DEVICE_VENDOR #define NM_DEVICE_PRODUCT NMDevice; NMDeviceClass; GObject * nm_device_new (DBusGConnection *connection,const char *path); const char * nm_device_get_iface (NMDevice *device); const char * nm_device_get_ip_iface (NMDevice *device); const char * nm_device_get_udi (NMDevice *device); const char * nm_device_get_driver (NMDevice *device); guint32 nm_device_get_capabilities (NMDevice *device); gboolean nm_device_get_managed (NMDevice *device); gboolean nm_device_get_firmware_missing (NMDevice *device); NMIP4Config * nm_device_get_ip4_config (NMDevice *device); NMDHCP4Config * nm_device_get_dhcp4_config (NMDevice *device); NMIP6Config * nm_device_get_ip6_config (NMDevice *device); NMDHCP6Config * nm_device_get_dhcp6_config (NMDevice *device); NMDeviceState nm_device_get_state (NMDevice *device); const char * nm_device_get_product (NMDevice *device); const char * nm_device_get_vendor (NMDevice *device); void (*NMDeviceDeactivateFn) (NMDevice *device,GError *error,gpointer user_data); void nm_device_disconnect (NMDevice *device,NMDeviceDeactivateFn callback,gpointer user_data);
GObject +----NMObject +----NMDevice +----NMDeviceEthernet +----NMDeviceWifi +----NMSerialDevice +----NMDeviceBt
"capabilities" guint : Read "dhcp4-config" NMDHCP4Config* : Read "dhcp6-config" NMDHCP6Config* : Read "driver" gchar* : Read "firmware-missing" gboolean : Read "interface" gchar* : Read "ip-interface" gchar* : Read "ip4-config" NMIP4Config* : Read "ip6-config" NMIP6Config* : Read "managed" gboolean : Read "product" gchar* : Read "state" guint : Read "udi" gchar* : Read "vendor" gchar* : Read
typedef struct {
	NMObjectClass parent;
	/* Signals */
	void (*state_changed) (NMDevice *device,
	                       NMDeviceState new_state,
	                       NMDeviceState old_state,
	                       NMDeviceStateReason reason);
	/* Padding for future expansion */
	void (*_reserved1) (void);
	void (*_reserved2) (void);
	void (*_reserved3) (void);
	void (*_reserved4) (void);
	void (*_reserved5) (void);
	void (*_reserved6) (void);
} NMDeviceClass;
GObject * nm_device_new (DBusGConnection *connection,const char *path);
Creates a new NMDevice.
| 
 | the DBusGConnection | 
| 
 | the DBus object path of the device | 
| Returns : | a new device | 
const char *        nm_device_get_iface                 (NMDevice *device);
Gets the interface name of the NMDevice.
| 
 | a NMDevice | 
| Returns : | the interface of the device. This is the internal string used by the device, and must not be modified. | 
const char *        nm_device_get_ip_iface              (NMDevice *device);
Gets the IP interface name of the NMDevice over which IP traffic flows when the device is in the ACTIVATED state.
| 
 | a NMDevice | 
| Returns : | the IP traffic interface of the device. This is the internal string used by the device, and must not be modified. | 
const char *        nm_device_get_udi                   (NMDevice *device);
Gets the Unique Device Identifier of the NMDevice.
| 
 | a NMDevice | 
| Returns : | the Unique Device Identifier of the device. This identifier may be used to gather more information about the device from various operating system services like udev or sysfs. | 
const char *        nm_device_get_driver                (NMDevice *device);
Gets the driver of the NMDevice.
| 
 | a NMDevice | 
| Returns : | the driver of the device. This is the internal string used by the device, and must not be modified. | 
guint32             nm_device_get_capabilities          (NMDevice *device);
Gets the device' capabilities.
| 
 | a NMDevice | 
| Returns : | the capabilities | 
gboolean            nm_device_get_managed               (NMDevice *device);
Whether the NMDevice is managed by NetworkManager.
gboolean            nm_device_get_firmware_missing      (NMDevice *device);
Indicates that firmware required for the device's operation is likely to be missing.
NMIP4Config *       nm_device_get_ip4_config            (NMDevice *device);
Gets the current NMIP4Config associated with the NMDevice.
| 
 | a NMDevice | 
| Returns : | the NMIP4Config or NULLif the device is not activated. | 
NMDHCP4Config *     nm_device_get_dhcp4_config          (NMDevice *device);
Gets the current NMDHCP4Config associated with the NMDevice.
NMIP6Config *       nm_device_get_ip6_config            (NMDevice *device);
Gets the current NMIP6Config associated with the NMDevice.
| 
 | a NMDevice | 
| Returns : | the NMIP6Config or NULLif the device is not activated. | 
NMDHCP6Config *     nm_device_get_dhcp6_config          (NMDevice *device);
Gets the current NMDHCP6Config associated with the NMDevice.
NMDeviceState       nm_device_get_state                 (NMDevice *device);
Gets the current NMDevice state.
| 
 | a NMDevice | 
| Returns : | the current device state | 
const char *        nm_device_get_product               (NMDevice *device);
Gets the product string of the NMDevice.
| 
 | a NMDevice | 
| Returns : | the product name of the device. This is the internal string used by the device, and must not be modified. | 
const char *        nm_device_get_vendor                (NMDevice *device);
Gets the vendor string of the NMDevice.
| 
 | a NMDevice | 
| Returns : | the vendor name of the device. This is the internal string used by the device, and must not be modified. | 
void (*NMDeviceDeactivateFn) (NMDevice *device,GError *error,gpointer user_data);
| 
 | |
| 
 | |
| 
 | 
void nm_device_disconnect (NMDevice *device,NMDeviceDeactivateFn callback,gpointer user_data);
Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.
| 
 | a NMDevice | 
| 
 | callback to be called when disconnect operation completes | 
| 
 | caller-specific data passed to callback | 
"capabilities" property"capabilities" guint : Read
The capabilities of the device.
Default value: 0
"firmware-missing" property"firmware-missing" gboolean : Read
When TRUE indicates the device is likely missing firmware required
for its operation.
Default value: FALSE
"ip-interface" property"ip-interface" gchar* : Read
The IP interface of the device which should be used for all IP-related operations like addressing and routing.
Default value: NULL
"managed" property"managed" gboolean : Read
Whether the device is managed by NetworkManager.
Default value: FALSE
"product" property"product" gchar* : Read
The product string of the device.
Default value: NULL
"udi" property"udi" gchar* : Read
The Unique Device Identifier of the device.
Default value: NULL
"state-changed" signalvoid user_function (NMDevice *device, guint state, guint arg2, guint arg3, gpointer user_data) : Run First
Notifies the state change of a NMDevice.
| 
 | the client that received the signal | 
| 
 | the new state of the device | 
| 
 | user data set when the signal handler was connected. |