![]() |
![]() |
![]() |
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.
|
a NMDevice |
Returns : |
TRUE if the device 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.
|
a NMDevice |
Returns : |
TRUE if 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 NULL if the device is not activated.
|
NMDHCP4Config * nm_device_get_dhcp4_config (NMDevice *device
);
Gets the current NMDHCP4Config associated with the NMDevice.
|
a NMDevice |
Returns : |
the NMDHCPConfig or NULL if the device is not activated or not
using DHCP.
|
NMIP6Config * nm_device_get_ip6_config (NMDevice *device
);
Gets the current NMIP6Config associated with the NMDevice.
|
a NMDevice |
Returns : |
the NMIP6Config or NULL if the device is not activated.
|
NMDHCP6Config * nm_device_get_dhcp6_config (NMDevice *device
);
Gets the current NMDHCP6Config associated with the NMDevice.
|
a NMDevice |
Returns : |
the NMDHCPConfig or NULL if the device is not activated or not
using DHCP.
|
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. |