NM.Device¶

Methods¶

Inherited:: NM.Object (2), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`disambiguate_names` (devices)
	`connection_compatible` (connection)
	`connection_valid` (connection)
	`delete` (cancellable)
	`delete_async` (cancellable, callback, *user_data)
	`delete_finish` (result)
	`disconnect` (cancellable)
	`disconnect_async` (cancellable, callback, *user_data)
	`disconnect_finish` (result)
	`filter_connections` (connections)
	`get_active_connection` ()
	`get_applied_connection` (flags, cancellable)
	`get_applied_connection_async` (flags, cancellable, callback, *user_data)
	`get_applied_connection_finish` (result)
	`get_autoconnect` ()
	`get_available_connections` ()
	`get_capabilities` ()
	`get_connectivity` (addr_family)
	`get_description` ()
	`get_device_type` ()
	`get_dhcp4_config` ()
	`get_dhcp6_config` ()
	`get_driver` ()
	`get_driver_version` ()
	`get_firmware_missing` ()
	`get_firmware_version` ()
	`get_hw_address` ()
	`get_iface` ()
	`get_interface_flags` ()
	`get_ip4_config` ()
	`get_ip6_config` ()
	`get_ip_iface` ()
	`get_lldp_neighbors` ()
	`get_managed` ()
	`get_metered` ()
	`get_mtu` ()
	`get_nm_plugin_missing` ()
	`get_path` ()
	`get_physical_port_id` ()
	`get_ports` ()
	`get_product` ()
	`get_setting_type` ()
	`get_state` ()
	`get_state_reason` ()
	`get_type_description` ()
	`get_udi` ()
	`get_vendor` ()
	`is_real` ()
	`is_software` ()
	`reapply` (connection, version_id, flags, cancellable)
	`reapply_async` (connection, version_id, flags, cancellable, callback, *user_data)
	`reapply_finish` (result)
	`set_autoconnect` (autoconnect)
	`set_managed` (managed)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Inherited:: NM.Object (2)

Name	Type	Flags
`active-connection`	`NM.ActiveConnection`	r
`autoconnect`	`bool`	r/w
`available-connections`	`GLib.PtrArray`	r
`capabilities`	`NM.DeviceCapabilities`	r
`device-type`	`NM.DeviceType`	r
`dhcp4-config`	`NM.DhcpConfig`	r
`dhcp6-config`	`NM.DhcpConfig`	r
`driver`	`str`	r
`driver-version`	`str`	r
`firmware-missing`	`bool`	r
`firmware-version`	`str`	r
`hw-address`	`str`	r
`interface`	`str`	r
`interface-flags`	`int`	r
`ip4-config`	`NM.IPConfig`	r
`ip4-connectivity`	`NM.ConnectivityState`	r
`ip6-config`	`NM.IPConfig`	r
`ip6-connectivity`	`NM.ConnectivityState`	r
`ip-interface`	`str`	r
`lldp-neighbors`	`GLib.PtrArray`	r
`managed`	`bool`	r
`metered`	`int`	r
`mtu`	`int`	r
`nm-plugin-missing`	`bool`	r
`physical-port-id`	`str`	r
`ports`	`GLib.PtrArray`	r
`product`	`str`	r
`real`	`bool`	r
`state`	`NM.DeviceState`	r
`state-reason`	`int`	r
`udi`	`str`	r
`vendor`	`str`	r

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`state-changed`	Notifies the state change of a `NM.Device`.

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class NM.Device(**kwargs)¶

Bases:: NM.Object
Abstract:: Yes
Structure:: NM.DeviceClass

classmethod disambiguate_names(devices)¶

Parameters:: devices ([NM.Device]) – an array of NM.Device
Returns:: the device names
Return type:: [str]

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

connection_compatible(connection)¶

Parameters:: connection (NM.Connection) – an NM.Connection to validate against self
Raises:: GLib.Error
Returns:: True if the connection may be activated with this device, False if is incompatible with the device’s capabilities and characteristics.
Return type:: bool

Validates a given connection for a given NM.Device object and returns whether the connection may be activated with the device. For example if self 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 GLib.Error when False is returned.

connection_valid(connection)¶

Parameters:: connection (NM.Connection) – an NM.Connection to validate against self
Returns:: True if the connection may be activated with this device, False if is incompatible with the device’s capabilities and characteristics.
Return type:: bool

Validates a given connection for a given NM.Device object and returns whether the connection may be activated with the device. For example if self 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.

delete(cancellable)¶

Parameters:: cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
Raises:: GLib.Error
Returns:: True on success, False on error, in which case error will be set.
Return type:: bool

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

Deprecated since version 1.22: Use NM.Device.delete_async() or Gio.DBusConnection.

delete_async(cancellable, callback, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
callback (Gio.AsyncReadyCallback or None) – callback to be called when delete operation completes
user_data (object or None) – caller-specific data passed to callback

Asynchronously begins deleting the software device. Hardware devices can’t be deleted.

delete_finish(result)¶

Parameters:: result (Gio.AsyncResult) – the result passed to the Gio.AsyncReadyCallback
Raises:: GLib.Error
Returns:: True on success, False on error, in which case error will be set.
Return type:: bool

Gets the result of a call to NM.Device.delete_async().

disconnect(cancellable)¶

Parameters:: cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
Raises:: GLib.Error
Returns:: True on success, False on error, in which case error will be set.
Return type:: bool

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

Deprecated since version 1.22: Use NM.Device.disconnect_async() or Gio.DBusConnection.

disconnect_async(cancellable, callback, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
callback (Gio.AsyncReadyCallback or None) – callback to be called when the disconnect operation completes
user_data (object or None) – caller-specific data passed to callback

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

disconnect_finish(result)¶

Parameters:: result (Gio.AsyncResult) – the result passed to the Gio.AsyncReadyCallback
Raises:: GLib.Error
Returns:: True on success, False on error, in which case error will be set.
Return type:: bool

Gets the result of a call to NM.Device.disconnect_async().

filter_connections(connections)¶

Parameters:

connections ([NM.Connection]) – an array of NM.Connections to filter

Returns:

an array of NM.Connections that could be activated with the given self. The array should be freed with g_ptr_array_unref() when it is no longer required.

WARNING: the transfer annotation for this function may not work correctly with bindings. See https://gitlab.gnome.org/GNOME/gobject-introspection/-/issues/305. You can filter the list yourself with NM.Device.connection_valid().

Return type:

[NM.Connection]

Filters a given array of connections for a given NM.Device object and returns connections which may be activated with the device. For example if self 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().

get_active_connection()¶

Returns:: the NM.ActiveConnection or None if the device is not part of an active connection
Return type:: NM.ActiveConnection

Gets the NM.ActiveConnection object which owns this device during activation.

get_applied_connection(flags, cancellable)¶

Parameters:

flags (int) – the flags argument. See NM.DeviceReapplyFlags.
cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None

Raises:

GLib.Error

Returns:

a NM.Connection with the currently applied settings or None on error.

The connection is as received from D-Bus and might not validate according to NM.Connection.verify().

version_id:: returns the current version id of the applied connection

Return type:

(NM.Connection, version_id: int)

Fetch the currently applied connection on the device.

New in version 1.2.

Deprecated since version 1.22: Use NM.Device.get_applied_connection_async() or Gio.DBusConnection.

get_applied_connection_async(flags, cancellable, callback, *user_data)¶

Parameters:

flags (int) – the flags argument. See NM.DeviceReapplyFlags.
cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
callback (Gio.AsyncReadyCallback or None) – callback to be called when the reapply operation completes
user_data (object or None) – caller-specific data passed to callback

Asynchronously begins and gets the currently applied connection.

New in version 1.2.

get_applied_connection_finish(result)¶

Parameters:

result (Gio.AsyncResult) – the result passed to the Gio.AsyncReadyCallback

Raises:

GLib.Error

Returns:

a currently applied NM.Connection or None in case of error.

The connection is as received from D-Bus and might not validate according to NM.Connection.verify().

version_id:: the current version id of the applied connection.

Return type:

(NM.Connection, version_id: int)

Gets the result of a call to NM.Device.get_applied_connection_async().

New in version 1.2.

get_autoconnect()¶

Returns:: True if the device is allowed to be autoconnected
Return type:: bool

Whether the NM.Device can be autoconnected.

get_available_connections()¶

Returns:: the GLib.PtrArray containing NM.RemoteConnections. This is the internal copy used by the connection, and must not be modified.
Return type:: [NM.RemoteConnection]

Gets the NM.RemoteConnections currently known to the daemon that could be activated on self.

get_capabilities()¶

Returns:: the capabilities
Return type:: NM.DeviceCapabilities

Gets the device’ capabilities.

get_connectivity(addr_family)¶

Parameters:: addr_family (int) – network address family
Returns:: the current connectivity state
Return type:: NM.ConnectivityState

The connectivity state of the device for given address family. Supported address families are %AF_INET for IPv4, %AF_INET6 for IPv6 or %AF_UNSPEC for any.

New in version 1.16.

get_description()¶

Returns:: a description of self. If either the vendor or the product name is unknown, this returns the interface name.
Return type:: str

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

get_device_type()¶

Returns:: the device type
Return type:: NM.DeviceType

Returns the numeric type of the NM.Device, ie Ethernet, Wi-Fi, etc.

get_dhcp4_config()¶

Returns:: the IPv4 NM.DhcpConfig, or None if the device is not activated or not using DHCP.
Return type:: NM.DhcpConfig

Gets the current IPv4 NM.DhcpConfig associated with the NM.Device.

You can alternatively use NM.ActiveConnection.get_dhcp4_config(), which also works with VPN connections.

get_dhcp6_config()¶

Returns:: the IPv6 NM.DhcpConfig, or None if the device is not activated or not using DHCPv6.
Return type:: NM.DhcpConfig

Gets the current IPv6 NM.DhcpConfig associated with the NM.Device.

You can alternatively use NM.ActiveConnection.get_dhcp6_config(), which also works with VPN connections.

get_driver()¶

Returns:: the driver of the device. This is the internal string used by the device, and must not be modified.
Return type:: str

Gets the driver of the NM.Device.

get_driver_version()¶

Returns:: the version of the device driver. This is the internal string used by the device, and must not be modified.
Return type:: str

Gets the driver version of the NM.Device.

get_firmware_missing()¶

Returns:: True if firmware required for the device’s operation is likely to be missing.
Return type:: bool

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

get_firmware_version()¶

Returns:: the firmware version of the device. This is the internal string used by the device, and must not be modified.
Return type:: str

Gets the firmware version of the NM.Device.

get_hw_address()¶

Returns:: the current MAC of the device, or None. This is the internal string used by the device, and must not be modified.
Return type:: str

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

get_iface()¶

Returns:: the interface of the device. This is the internal string used by the device, and must not be modified.
Return type:: str

Gets the interface name of the NM.Device.

get_interface_flags()¶

Returns:: the flags
Return type:: NM.DeviceInterfaceFlags

Gets the interface flags of the device.

New in version 1.22.

get_ip4_config()¶

Returns:: the IPv4 NM.IPConfig, or None if the device is not activated.
Return type:: NM.IPConfig

Gets the current IPv4 NM.IPConfig associated with the NM.Device.

You can alternatively use NM.ActiveConnection.get_ip4_config(), which also works with VPN connections.

get_ip6_config()¶

Returns:: the IPv6 NM.IPConfig or None if the device is not activated.
Return type:: NM.IPConfig

Gets the current IPv6 NM.IPConfig associated with the NM.Device.

You can alternatively use NM.ActiveConnection.get_ip6_config(), which also works with VPN connections.

get_ip_iface()¶

Returns:: the IP traffic interface of the device. This is the internal string used by the device, and must not be modified.
Return type:: str

Gets the IP interface name of the NM.Device over which IP traffic flows when the device is in the ACTIVATED state.

get_lldp_neighbors()¶

Returns:: the GLib.PtrArray containing NM.LldpNeighbor s. This is the internal copy used by the device and must not be modified. The library never modifies the returned array and thus it is safe for callers to reference and keep using it.
Return type:: [NM.LldpNeighbor]

Gets the list of neighbors discovered through LLDP.

New in version 1.2.

get_managed()¶

Returns:: True if the device is managed by NetworkManager
Return type:: bool

Whether the NM.Device is managed by NetworkManager.

get_metered()¶

Returns:: the metered setting.
Return type:: NM.Metered

Gets the metered setting of a NM.Device.

New in version 1.2.

get_mtu()¶

Returns:: the MTU of the device in bytes.
Return type:: int

Gets the MTU of the NM.Device.

get_nm_plugin_missing()¶

Returns:: True if the device plugin not installed.
Return type:: bool

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

New in version 1.2.

get_path()¶

Returns:

the path of the device.

The string is backslash escaped (C escaping) for invalid characters. The escaping can be reverted with GLib.strcompress(), however the result may not be valid UTF-8.

Return type:

str

Gets the path of the NM.Device as exposed by the udev property ID_PATH.

New in version 1.26.

get_physical_port_id()¶

Returns:: the physical port ID of the device, or None if the port ID is unknown. This is the internal string used by the device and must not be modified.
Return type:: str

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

get_ports()¶

Returns:: the GLib.PtrArray containing NM.Devices that are ports of self. This is the internal copy used by the device and must not be modified.
Return type:: [NM.Device]

Gets the devices currently set as port of self.

New in version 1.34.

get_product()¶

Returns:

the product name of the device. This is the internal string used by the device, and must not be modified.

The string is backslash escaped (C escaping) for invalid characters. The escaping can be reverted with GLib.strcompress(), however the result may not be valid UTF-8.

Return type:

str

Gets the product string of the NM.Device.

get_setting_type()¶

Returns:: self's associated NM.Setting type
Return type:: GObject.GType

Gets the (primary) NM.Setting subtype associated with connections that can be used on self.

get_state()¶

Returns:: the current device state
Return type:: NM.DeviceState

Gets the current NM.Device state.

get_state_reason()¶

Returns:: the reason for entering the current device state
Return type:: NM.DeviceStateReason

Gets the reason for entering the current NM.Device state.

get_type_description()¶

Returns:: the type description of the device. This is the internal string used by the device, and must not be modified.
Return type:: str

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

get_udi()¶

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.
Return type:: str

Gets the Unique Device Identifier of the NM.Device.

get_vendor()¶

Returns:

the vendor name of the device. This is the internal string used by the device, and must not be modified.

The string is backslash escaped (C escaping) for invalid characters. The escaping can be reverted with GLib.strcompress(), however the result may not be valid UTF-8.

Return type:

str

Gets the vendor string of the NM.Device.

is_real()¶

Returns:: True if the device exists, or False if it is a placeholder device that could be automatically created by NetworkManager if one of its NM.Device :available-connections was activated.
Return type:: bool

New in version 1.2.

is_software()¶

Returns:: True if self is a software device, False if it is a hardware device.
Return type:: bool

Whether the device is a software device.

reapply(connection, version_id, flags, cancellable)¶

Parameters:

connection (NM.Connection or None) – the NM.Connection to replace the applied settings with or None to reuse existing
version_id (int) – zero or the expected version id of the applied connection. If specified and the version id mismatches, the call fails without modification. This allows to catch concurrent accesses.
flags (int) – always set this to zero
cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None

Raises:

GLib.Error

Returns:

True on success, False on error, in which case error will be set.

Return type:

bool

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

New in version 1.2.

Deprecated since version 1.22: Use NM.Device.reapply_async() or Gio.DBusConnection.

reapply_async(connection, version_id, flags, cancellable, callback, *user_data)¶

Parameters:

connection (NM.Connection or None) – the NM.Connection to replace the applied settings with or None to reuse existing
version_id (int) – zero or the expected version id of the applied connection. If specified and the version id mismatches, the call fails without modification. This allows to catch concurrent accesses.
flags (int) – always set this to zero
cancellable (Gio.Cancellable or None) – a Gio.Cancellable, or None
callback (Gio.AsyncReadyCallback or None) – callback to be called when the reapply operation completes
user_data (object or None) – caller-specific data passed to callback

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

New in version 1.2.

reapply_finish(result)¶

Parameters:: result (Gio.AsyncResult) – the result passed to the Gio.AsyncReadyCallback
Raises:: GLib.Error
Returns:: True on success, False on error, in which case error will be set.
Return type:: bool

Gets the result of a call to NM.Device.reapply_async().

New in version 1.2.

set_autoconnect(autoconnect)¶

Parameters:: autoconnect (bool) – True to enable autoconnecting

Enables or disables automatic activation of the NM.Device.

Deprecated since version 1.22: Use the async command NM.Client.dbus_set_property() on NM.Object.get_path(), %NM_DBUS_INTERFACE_DEVICE to set “Autoconnect” property to a “(b)” value. This function is deprecated because it calls a synchronous D-Bus method and modifies the content of the NM.Client cache client side.

set_managed(managed)¶

Parameters:: managed (bool) – True to make the device managed by NetworkManager.

Enables or disables management of NM.Device by NetworkManager.

New in version 1.2.

Deprecated since version 1.22: Use the async command NM.Client.dbus_set_property() on NM.Object.get_path(), interface %NM_DBUS_INTERFACE_DEVICE to set the “Managed” property to a “(b)” boolean value. This function is deprecated because it calls a synchronous D-Bus method and modifies the content of the NM.Client cache client side. Also, it does not emit a property changed signal.

Signal Details¶

NM.Device.signals.state_changed(device, new_state, old_state, reason)¶

Signal Name:

state-changed

Flags:

RUN_FIRST

Parameters:

device (NM.Device) – The object which received the signal
new_state (int) – the new state of the device
old_state (int) – the previous state of the device
reason (int) – the reason describing the state change

Notifies the state change of a NM.Device.

Property Details¶

NM.Device.props.active_connection¶

Name:: active-connection
Type:: NM.ActiveConnection
Default Value:: None
Flags:: READABLE

The NM.ActiveConnection object that “owns” this device during activation.

NM.Device.props.autoconnect¶

Name:: autoconnect
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE

Whether the device can auto-activate a connection.

The property setter is a synchronous D-Bus call. This is deprecated since 1.22.

NM.Device.props.available_connections¶

Name:: available-connections
Type:: GLib.PtrArray
Default Value:: None
Flags:: READABLE

The available connections of the device

NM.Device.props.capabilities¶

Name:: capabilities
Type:: NM.DeviceCapabilities
Default Value:: NM.DeviceCapabilities.NONE
Flags:: READABLE

The capabilities of the device.

NM.Device.props.device_type¶

Name:: device-type
Type:: NM.DeviceType
Default Value:: NM.DeviceType.UNKNOWN
Flags:: READABLE

The numeric type of the device.

NM.Device.props.dhcp4_config¶

Name:: dhcp4-config
Type:: NM.DhcpConfig
Default Value:: None
Flags:: READABLE

The IPv4 NM.DhcpConfig of the device.

NM.Device.props.dhcp6_config¶

Name:: dhcp6-config
Type:: NM.DhcpConfig
Default Value:: None
Flags:: READABLE

The IPv6 NM.DhcpConfig of the device.

NM.Device.props.driver¶

Name:: driver
Type:: str
Default Value:: None
Flags:: READABLE

The driver of the device.

NM.Device.props.driver_version¶

Name:: driver-version
Type:: str
Default Value:: None
Flags:: READABLE

The version of the device driver.

NM.Device.props.firmware_missing¶

Name:: firmware-missing
Type:: bool
Default Value:: False
Flags:: READABLE

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

NM.Device.props.firmware_version¶

Name:: firmware-version
Type:: str
Default Value:: None
Flags:: READABLE

The firmware version of the device.

NM.Device.props.hw_address¶

Name:: hw-address
Type:: str
Default Value:: None
Flags:: READABLE

The hardware address of the device.

New in version 1.24.

NM.Device.props.interface¶

Name:: interface
Type:: str
Default Value:: None
Flags:: READABLE

The interface of the device.

NM.Device.props.interface_flags¶

Name:: interface-flags
Type:: int
Default Value:: 0
Flags:: READABLE

The interface flags.

New in version 1.22.

NM.Device.props.ip4_config¶

Name:: ip4-config
Type:: NM.IPConfig
Default Value:: None
Flags:: READABLE

The #NMIP4Config of the device.

NM.Device.props.ip4_connectivity¶

Name:: ip4-connectivity
Type:: NM.ConnectivityState
Default Value:: NM.ConnectivityState.UNKNOWN
Flags:: READABLE

The IPv4 connectivity state of the device.

New in version 1.16.

NM.Device.props.ip6_config¶

Name:: ip6-config
Type:: NM.IPConfig
Default Value:: None
Flags:: READABLE

The IPv6 NM.IPConfig of the device.

NM.Device.props.ip6_connectivity¶

Name:: ip6-connectivity
Type:: NM.ConnectivityState
Default Value:: NM.ConnectivityState.UNKNOWN
Flags:: READABLE

The IPv6 connectivity state of the device.

New in version 1.16.

NM.Device.props.ip_interface¶

Name:: ip-interface
Type:: str
Default Value:: None
Flags:: READABLE

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

NM.Device.props.lldp_neighbors¶

Name:: lldp-neighbors
Type:: GLib.PtrArray
Default Value:: None
Flags:: READABLE

The LLDP neighbors.

NM.Device.props.managed¶

Name:: managed
Type:: bool
Default Value:: False
Flags:: READABLE

Whether the device is managed by NetworkManager.

NM.Device.props.metered¶

Name:: metered
Type:: int
Default Value:: 0
Flags:: READABLE

Whether the device is metered.

New in version 1.2.

NM.Device.props.mtu¶

Name:: mtu
Type:: int
Default Value:: 0
Flags:: READABLE

The MTU of the device.

NM.Device.props.nm_plugin_missing¶

Name:: nm-plugin-missing
Type:: bool
Default Value:: False
Flags:: READABLE

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

New in version 1.2.

NM.Device.props.physical_port_id¶

Name:: physical-port-id
Type:: str
Default Value:: None
Flags:: READABLE

The physical port ID of the device. (See NM.Device.get_physical_port_id().)

NM.Device.props.ports¶

Name:: ports
Type:: GLib.PtrArray
Default Value:: None
Flags:: READABLE

The port devices of the controller device. For devices that cannot be controllers this is likely to be always empty.

New in version 1.34.

NM.Device.props.product¶

Name:: product
Type:: str
Default Value:: None
Flags:: READABLE

The product string of the device.

NM.Device.props.real¶

Name:: real
Type:: bool
Default Value:: False
Flags:: READABLE

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

New in version 1.2.

NM.Device.props.state¶

Name:: state
Type:: NM.DeviceState
Default Value:: NM.DeviceState.UNKNOWN
Flags:: READABLE

The state of the device.

NM.Device.props.state_reason¶

Name:: state-reason
Type:: int
Default Value:: 0
Flags:: READABLE

The reason for the device state.

NM.Device.props.udi¶

Name:: udi
Type:: str
Default Value:: None
Flags:: READABLE

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.

NM.Device.props.vendor¶

Name:: vendor
Type:: str
Default Value:: None
Flags:: READABLE

The vendor string of the device.