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, Wi-Fi, 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_type_description ()

const char *
nm_device_get_type_description (NMDevice *device);

Gets a (non-localized) description of the type of device that device is.

nm_device_get_hw_address ()

const char *
nm_device_get_hw_address (NMDevice *device);

Gets the current a hardware address (MAC) for the device .

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_set_managed ()

void
nm_device_set_managed (NMDevice *device,
                       gboolean managed);

Enables or disables management of NMDevice by NetworkManager.

Since: 1.2

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_nm_plugin_missing ()

gboolean
nm_device_get_nm_plugin_missing (NMDevice *device);

Indicates that the NetworkManager plugin for the device is not installed.

Since: 1.2

nm_device_get_ip4_config ()

NMIPConfig *
nm_device_get_ip4_config (NMDevice *device);

Gets the current IPv4 NMIPConfig associated with the NMDevice.

You can alternatively use nm_active_connection_get_ip4_config(), which also works with VPN connections.

nm_device_get_dhcp4_config ()

NMDhcpConfig *
nm_device_get_dhcp4_config (NMDevice *device);

Gets the current IPv4 NMDhcpConfig associated with the NMDevice.

You can alternatively use nm_active_connection_get_dhcp4_config(), which also works with VPN connections.

nm_device_get_ip6_config ()

NMIPConfig *
nm_device_get_ip6_config (NMDevice *device);

Gets the current IPv6 NMIPConfig associated with the NMDevice.

You can alternatively use nm_active_connection_get_ip6_config(), which also works with VPN connections.

nm_device_get_dhcp6_config ()

NMDhcpConfig *
nm_device_get_dhcp6_config (NMDevice *device);

Gets the current IPv6 NMDhcpConfig associated with the NMDevice.

You can alternatively use nm_active_connection_get_dhcp6_config(), which also works with VPN connections.

nm_device_get_state ()

NMDeviceState
nm_device_get_state (NMDevice *device);

Gets the current NMDevice state.

nm_device_get_state_reason ()

NMDeviceStateReason
nm_device_get_state_reason (NMDevice *device);

Gets the reason for entering the current NMDevice state.

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 .

nm_device_get_physical_port_id ()

const char *
nm_device_get_physical_port_id (NMDevice *device);

Gets the physical port ID of the NMDevice. If non-NULL, this is an opaque string that can be used to recognize when seemingly-unrelated NMDevices are actually just different virtual ports on a single physical port. (Eg, NPAR / SR-IOV.)

nm_device_get_mtu ()

guint32
nm_device_get_mtu (NMDevice *device);

Gets the MTU of the NMDevice.

nm_device_is_real ()

gboolean
nm_device_is_real (NMDevice *device);

Since: 1.2

nm_device_is_software ()

gboolean
nm_device_is_software (NMDevice *device);

Whether the device is a software device.

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.

nm_device_get_description ()

const char *
nm_device_get_description (NMDevice *device);

Gets a description of device , based on its vendor and product names.

nm_device_get_metered ()

NMMetered
nm_device_get_metered (NMDevice *device);

Gets the metered setting of a NMDevice.

Since: 1.2

nm_device_get_lldp_neighbors ()

GPtrArray *
nm_device_get_lldp_neighbors (NMDevice *device);

Gets the list of neighbors discovered through LLDP.

Since: 1.2

nm_device_disambiguate_names ()

char **
nm_device_disambiguate_names (NMDevice **devices,
                              int num_devices);

Generates a list of short-ish unique presentation names for the devices in devices .

nm_device_reapply ()

gboolean
nm_device_reapply (NMDevice *device,
                   NMConnection *connection,
                   guint64 version_id,
                   guint32 flags,
                   GCancellable *cancellable,
                   GError **error);

Attempts to update device with changes to the currently active connection made since it was last applied.

Since: 1.2

nm_device_reapply_async ()

void
nm_device_reapply_async (NMDevice *device,
                         NMConnection *connection,
                         guint64 version_id,
                         guint32 flags,
                         GCancellable *cancellable,
                         GAsyncReadyCallback callback,
                         gpointer user_data);

Asynchronously begins an attempt to update device with changes to the currently active connection made since it was last applied.

Since: 1.2

nm_device_reapply_finish ()

gboolean
nm_device_reapply_finish (NMDevice *device,
                          GAsyncResult *result,
                          GError **error);

Gets the result of a call to nm_device_reapply_async().

Since: 1.2

nm_device_get_applied_connection ()

NMConnection *
nm_device_get_applied_connection (NMDevice *device,
                                  guint32 flags,
                                  guint64 *version_id,
                                  GCancellable *cancellable,
                                  GError **error);

Fetch the currently applied connection on the device.

Since: 1.2

nm_device_get_applied_connection_async ()

void
nm_device_get_applied_connection_async
                               (NMDevice *device,
                                guint32 flags,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Asynchronously begins and gets the currently applied connection.

Since: 1.2

nm_device_get_applied_connection_finish ()

NMConnection *
nm_device_get_applied_connection_finish
                               (NMDevice *device,
                                GAsyncResult *result,
                                guint64 *version_id,
                                GError **error);

Gets the result of a call to nm_device_get_applied_connection_async().

Since: 1.2

nm_device_disconnect ()

gboolean
nm_device_disconnect (NMDevice *device,
                      GCancellable *cancellable,
                      GError **error);

Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.

nm_device_disconnect_async ()

void
nm_device_disconnect_async (NMDevice *device,
                            GCancellable *cancellable,
                            GAsyncReadyCallback callback,
                            gpointer user_data);

Asynchronously begins disconnecting the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.

nm_device_disconnect_finish ()

gboolean
nm_device_disconnect_finish (NMDevice *device,
                             GAsyncResult *result,
                             GError **error);

Gets the result of a call to nm_device_disconnect_async().

nm_device_delete ()

gboolean
nm_device_delete (NMDevice *device,
                  GCancellable *cancellable,
                  GError **error);

Deletes the software device. Hardware devices can't be deleted.

nm_device_delete_async ()

void
nm_device_delete_async (NMDevice *device,
                        GCancellable *cancellable,
                        GAsyncReadyCallback callback,
                        gpointer user_data);

Asynchronously begins deleteing the software device. Hardware devices can't be deleted.

nm_device_delete_finish ()

gboolean
nm_device_delete_finish (NMDevice *device,
                         GAsyncResult *result,
                         GError **error);

Gets the result of a call to nm_device_delete_async().

nm_device_filter_connections ()

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

Filters a given array of connections for a given NMDevice object and returns connections which may be activated with the device. For example if device is a Wi-Fi device that supports only WEP encryption, the returned array will contain any Wi-Fi connections in connections that allow connection to unencrypted or WEP-enabled SSIDs. The returned array will not contain Ethernet, Bluetooth, Wi-Fi WPA connections, or any other connection that is incompatible with the device. To get the full list of connections see nm_client_get_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 Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi 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 Wi-Fi device that supports only WEP encryption, the connection will only be valid if it is a Wi-Fi 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_get_setting_type ()

GType
nm_device_get_setting_type (NMDevice *device);

Gets the (primary) NMSetting subtype associated with connections that can be used on device .

nm_lldp_neighbor_new ()

NMLldpNeighbor *
nm_lldp_neighbor_new (void);

Creates a new NMLldpNeighbor object.

Since: 1.2

nm_lldp_neighbor_ref ()

void
nm_lldp_neighbor_ref (NMLldpNeighbor *neighbor);

Increases the reference count of the object.

Since: 1.2

nm_lldp_neighbor_unref ()

void
nm_lldp_neighbor_unref (NMLldpNeighbor *neighbor);

Decreases the reference count of the object. If the reference count reaches zero, the object will be destroyed.

Since: 1.2

nm_lldp_neighbor_get_attr_names ()

char **
nm_lldp_neighbor_get_attr_names (NMLldpNeighbor *neighbor);

Gets an array of attribute names available for neighbor .

Since: 1.2

nm_lldp_neighbor_get_attr_string_value ()

gboolean
nm_lldp_neighbor_get_attr_string_value
                               (NMLldpNeighbor *neighbor,
                                char *name,
                                const char **out_value);

Gets the string value of attribute with name name on neighbor

Since: 1.2

nm_lldp_neighbor_get_attr_uint_value ()

gboolean
nm_lldp_neighbor_get_attr_uint_value (NMLldpNeighbor *neighbor,
                                      char *name,
                                      guint *out_value);

Gets the uint value of attribute with name name on neighbor

Since: 1.2

nm_lldp_neighbor_get_attr_type ()

const GVariantType *
nm_lldp_neighbor_get_attr_type (NMLldpNeighbor *neighbor,
                                char *name);

Get the type of an attribute.

Since: 1.2

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_REAL

#define NM_DEVICE_REAL "real"

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_NM_PLUGIN_MISSING

#define NM_DEVICE_NM_PLUGIN_MISSING "nm-plugin-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"

NM_DEVICE_PHYSICAL_PORT_ID

#define NM_DEVICE_PHYSICAL_PORT_ID "physical-port-id"

NM_DEVICE_MTU

#define NM_DEVICE_MTU "mtu"

NM_DEVICE_METERED

#define NM_DEVICE_METERED "metered"

NM_DEVICE_LLDP_NEIGHBORS

#define NM_DEVICE_LLDP_NEIGHBORS "lldp-neighbors"

NMDevice

typedef struct _NMDevice NMDevice;

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”    GPtrArray *

The available connections of the device

[type GPtrArray(NMRemoteConnection)]

Flags: Read

The “capabilities” property

  “capabilities”             NMDeviceCapabilities

The capabilities of the device.

Flags: Read

The “device-type” property

  “device-type”              NMDeviceType

The numeric type of the device.

Flags: Read

Default value: NM_DEVICE_TYPE_UNKNOWN

The “dhcp4-config” property

  “dhcp4-config”             NMDhcpConfig *

The IPv4 NMDhcpConfig of the device.

Flags: Read

The “dhcp6-config” property

  “dhcp6-config”             NMDhcpConfig *

The IPv6 NMDhcpConfig 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”               NMIPConfig *

The NMIP4Config of the device.

Flags: Read

The “ip6-config” property

  “ip6-config”               NMIPConfig *

The IPv6 NMIPConfig of the device.

Flags: Read

The “lldp-neighbors” property

  “lldp-neighbors”           GPtrArray *

The LLDP neighbors.

Flags: Read

The “managed” property

  “managed”                  gboolean

Whether the device is managed by NetworkManager.

Flags: Read

Default value: FALSE

The “metered” property

  “metered”                  guint

Whether the device is metered.

Flags: Read

Default value: 0

Since: 1.2

The “mtu” property

  “mtu”                      guint

The MTU of the device.

Flags: Read

Default value: 1500

The “nm-plugin-missing” property

  “nm-plugin-missing”        gboolean

When TRUE indicates that the NetworkManager plugin for the device is not installed.

Flags: Read

Default value: FALSE

Since: 1.2

The “physical-port-id” property

  “physical-port-id”         gchar *

The physical port ID of the device. (See nm_device_get_physical_port_id().)

Flags: Read

Default value: NULL

The “product” property

  “product”                  gchar *

The product string of the device.

Flags: Read

Default value: NULL

The “real” property

  “real”                     gboolean

Whether the device is real or is a placeholder device that could be created automatically by NetworkManager if one of its “available-connections” was activated.

Flags: Read

Default value: FALSE

Since: 1.2

The “state” property

  “state”                    NMDeviceState

The state of the device.

Flags: Read

Default value: NM_DEVICE_STATE_UNKNOWN

The “state-reason” property

  “state-reason”             guint

The reason for the device state.

Flags: Read

Default value: 0

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