nm_device_new ()

GObject *
nm_device_new (DBusGConnection *connection,
               const char *path);

Creates a new NMDevice.

nm_device_get_iface ()

const char *
nm_device_get_iface (NMDevice *device);

Gets the interface name of the NMDevice.

nm_device_get_ip_iface ()

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.

nm_device_get_device_type ()

NMDeviceType
nm_device_get_device_type (NMDevice *device);

Returns the numeric type of the NMDevice, ie ethernet, wifi, etc.

nm_device_get_udi ()

const char *
nm_device_get_udi (NMDevice *device);

Gets the Unique Device Identifier of the NMDevice.

nm_device_get_driver ()

const char *
nm_device_get_driver (NMDevice *device);

Gets the driver of the NMDevice.

nm_device_get_driver_version ()

const char *
nm_device_get_driver_version (NMDevice *device);

Gets the driver version of the NMDevice.

nm_device_get_firmware_version ()

const char *
nm_device_get_firmware_version (NMDevice *device);

Gets the firmware version of the NMDevice.

nm_device_get_capabilities ()

NMDeviceCapabilities
nm_device_get_capabilities (NMDevice *device);

Gets the device' capabilities.

nm_device_get_managed ()

gboolean
nm_device_get_managed (NMDevice *device);

Whether the NMDevice is managed by NetworkManager.

nm_device_get_autoconnect ()

gboolean
nm_device_get_autoconnect (NMDevice *device);

Whether the NMDevice can be autoconnected.

nm_device_set_autoconnect ()

void
nm_device_set_autoconnect (NMDevice *device,
                           gboolean autoconnect);

Enables or disables automatic activation of the NMDevice.

nm_device_get_firmware_missing ()

gboolean
nm_device_get_firmware_missing (NMDevice *device);

Indicates that firmware required for the device's operation is likely to be missing.

nm_device_get_ip4_config ()

NMIP4Config *
nm_device_get_ip4_config (NMDevice *device);

Gets the current NMIP4Config associated with the NMDevice.

nm_device_get_dhcp4_config ()

NMDHCP4Config *
nm_device_get_dhcp4_config (NMDevice *device);

Gets the current NMDHCP4Config associated with the NMDevice.

nm_device_get_ip6_config ()

NMIP6Config *
nm_device_get_ip6_config (NMDevice *device);

Gets the current NMIP6Config associated with the NMDevice.

nm_device_get_dhcp6_config ()

NMDHCP6Config *
nm_device_get_dhcp6_config (NMDevice *device);

Gets the current NMDHCP6Config associated with the NMDevice.

nm_device_get_state ()

NMDeviceState
nm_device_get_state (NMDevice *device);

Gets the current NMDevice state.

nm_device_get_state_reason ()

NMDeviceState
nm_device_get_state_reason (NMDevice *device,
                            NMDeviceStateReason *reason);

Gets the current NMDevice state (return value) and the reason for entering the state (reason argument).

nm_device_get_active_connection ()

NMActiveConnection *
nm_device_get_active_connection (NMDevice *device);

Gets the NMActiveConnection object which owns this device during activation.

nm_device_get_available_connections ()

const GPtrArray *
nm_device_get_available_connections (NMDevice *device);

Gets the NMRemoteConnections currently known to the daemon that could be activated on device .

Since 0.9.8

nm_device_get_product ()

const char *
nm_device_get_product (NMDevice *device);

Gets the product string of the NMDevice.

nm_device_get_vendor ()

const char *
nm_device_get_vendor (NMDevice *device);

Gets the vendor string of the NMDevice.

NMDeviceDeactivateFn ()

void
(*NMDeviceDeactivateFn) (NMDevice *device,
                         GError *error,
                         gpointer user_data);

nm_device_disconnect ()

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.

nm_device_filter_connections ()

GSList *
nm_device_filter_connections (NMDevice *device,
                              const GSList *connections);

Filters a given list of connections for a given NMDevice object and return connections which may be activated with the device. For example if device is a WiFi device that supports only WEP encryption, the returned list will contain any WiFi connections in connections that allow connection to unencrypted or WEP-enabled SSIDs. The returned list will not contain Ethernet, Bluetooth, WiFi WPA connections, or any other connection that is incompatible with the device. To get the full list of connections see nm_remote_settings_list_connections().

nm_device_connection_valid ()

gboolean
nm_device_connection_valid (NMDevice *device,
                            NMConnection *connection);

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if device is a WiFi device that supports only WEP encryption, the connection will only be valid if it is a WiFi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the device.

nm_device_connection_compatible ()

gboolean
nm_device_connection_compatible (NMDevice *device,
                                 NMConnection *connection,
                                 GError **error);

Validates a given connection for a given NMDevice object and returns whether the connection may be activated with the device. For example if device is a WiFi device that supports only WEP encryption, the connection will only be valid if it is a WiFi connection which describes a WEP or open network, and will not be valid if it describes a WPA network, or if it is an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the device.

This function does the same as nm_device_connection_valid(), i.e. checking compatibility of the given device and connection. But, in addition, it sets GError when FALSE is returned.

NM_DEVICE_DEVICE_TYPE

#define NM_DEVICE_DEVICE_TYPE "device-type"

NM_DEVICE_UDI

#define NM_DEVICE_UDI "udi"

NM_DEVICE_INTERFACE

#define NM_DEVICE_INTERFACE "interface"

NM_DEVICE_IP_INTERFACE

#define NM_DEVICE_IP_INTERFACE "ip-interface"

NM_DEVICE_DRIVER

#define NM_DEVICE_DRIVER "driver"

NM_DEVICE_DRIVER_VERSION

#define NM_DEVICE_DRIVER_VERSION "driver-version"

NM_DEVICE_FIRMWARE_VERSION

#define NM_DEVICE_FIRMWARE_VERSION "firmware-version"

NM_DEVICE_CAPABILITIES

#define NM_DEVICE_CAPABILITIES "capabilities"

NM_DEVICE_MANAGED

#define NM_DEVICE_MANAGED "managed"

NM_DEVICE_AUTOCONNECT

#define NM_DEVICE_AUTOCONNECT "autoconnect"

NM_DEVICE_FIRMWARE_MISSING

#define NM_DEVICE_FIRMWARE_MISSING "firmware-missing"

NM_DEVICE_IP4_CONFIG

#define NM_DEVICE_IP4_CONFIG "ip4-config"

NM_DEVICE_DHCP4_CONFIG

#define NM_DEVICE_DHCP4_CONFIG "dhcp4-config"

NM_DEVICE_IP6_CONFIG

#define NM_DEVICE_IP6_CONFIG "ip6-config"

NM_DEVICE_DHCP6_CONFIG

#define NM_DEVICE_DHCP6_CONFIG "dhcp6-config"

NM_DEVICE_STATE

#define NM_DEVICE_STATE "state"

NM_DEVICE_STATE_REASON

#define NM_DEVICE_STATE_REASON "state-reason"

NM_DEVICE_ACTIVE_CONNECTION

#define NM_DEVICE_ACTIVE_CONNECTION "active-connection"

NM_DEVICE_AVAILABLE_CONNECTIONS

#define NM_DEVICE_AVAILABLE_CONNECTIONS "available-connections"

NM_DEVICE_VENDOR

#define NM_DEVICE_VENDOR "vendor"

NM_DEVICE_PRODUCT

#define NM_DEVICE_PRODUCT "product"

NMDevice

typedef struct _NMDevice NMDevice;

NMDeviceClass

typedef struct {
	NMObjectClass parent;

	/* Signals */
	void (*state_changed) (NMDevice *device,
	                       NMDeviceState new_state,
	                       NMDeviceState old_state,
	                       NMDeviceStateReason reason);

	gboolean (*connection_compatible) (NMDevice *device,
	                                   NMConnection *connection,
	                                   GError **error);

	/* Padding for future expansion */
	void (*_reserved1) (void);
	void (*_reserved2) (void);
	void (*_reserved3) (void);
	void (*_reserved4) (void);
	void (*_reserved5) (void);
	void (*_reserved6) (void);
} NMDeviceClass;

The “active-connection” property

  “active-connection”        NMActiveConnection *

The NMActiveConnection object that "owns" this device during activation.

Flags: Read

The “autoconnect” property

  “autoconnect”              gboolean

Whether the device can auto-activate a connection.

Flags: Read / Write

Default value: TRUE

The “available-connections” property

  “available-connections”    NMObjectArray *

The available connections (NMRemoteConnection) of the device

Flags: Read

Since 0.9.8

The “capabilities” property

  “capabilities”             guint

The capabilities of the device.

Flags: Read

Default value: 0

The “device-type” property

  “device-type”              guint

The numeric type of the device.

Flags: Read

Default value: 0

The “dhcp4-config” property

  “dhcp4-config”             NMDHCP4Config *

The NMDHCP4Config of the device.

Flags: Read

The “dhcp6-config” property

  “dhcp6-config”             NMDHCP6Config *

The NMDHCP6Config of the device.

Flags: Read

The “driver” property

  “driver”                   gchar *

The driver of the device.

Flags: Read

Default value: NULL

The “driver-version” property

  “driver-version”           gchar *

The version of the device driver.

Flags: Read

Default value: NULL

The “firmware-missing” property

  “firmware-missing”         gboolean

When TRUE indicates the device is likely missing firmware required for its operation.

Flags: Read

Default value: FALSE

The “firmware-version” property

  “firmware-version”         gchar *

The firmware version of the device.

Flags: Read

Default value: NULL

The “interface” property

  “interface”                gchar *

The interface of the device.

Flags: Read

Default value: NULL

The “ip-interface” property

  “ip-interface”             gchar *

The IP interface of the device which should be used for all IP-related operations like addressing and routing.

Flags: Read

Default value: NULL

The “ip4-config” property

  “ip4-config”               NMIP4Config *

The NMIP4Config of the device.

Flags: Read

The “ip6-config” property

  “ip6-config”               NMIP6Config *

The NMIP6Config of the device.

Flags: Read

The “managed” property

  “managed”                  gboolean

Whether the device is managed by NetworkManager.

Flags: Read

Default value: FALSE

The “product” property

  “product”                  gchar *

The product string of the device.

Flags: Read

Default value: NULL

The “state” property

  “state”                    guint

The state of the device.

Flags: Read

Default value: 0

The “state-reason” property

  “state-reason”             GValueArray_guint+guint_*

The state and reason of the device.

Flags: Read

The “udi” property

  “udi”                      gchar *

An operating-system specific device hardware identifier; this is not unique to a specific hardware device across reboots or hotplugs. It is an opaque string which for some device types (Bluetooth, Modem) contains an identifier provided by the underlying hardware service daemon such as Bluez or ModemManager, and clients can use this property to request more information about the device from those services.

Flags: Read

Default value: NULL

The “vendor” property

  “vendor”                   gchar *

The vendor string of the device.

Flags: Read

Default value: NULL

The “state-changed” signal

void
user_function (NMDevice *device,
               guint     new_state,
               guint     old_state,
               guint     reason,
               gpointer  user_data)

Notifies the state change of a NMDevice.

Flags: Run First