Device

---

Object Hierarchy:

Description:

Content:

Constants:

• public const string ACTIVE_CONNECTION
• public const string AUTOCONNECT
• public const string AVAILABLE_CONNECTIONS
• public const string CAPABILITIES
• public const string DEVICE_TYPE
• public const string DHCP4_CONFIG
• public const string DHCP6_CONFIG
• public const string DRIVER
• public const string DRIVER_VERSION
• public const string FIRMWARE_MISSING
• public const string FIRMWARE_VERSION
• public const string INTERFACE
• public const string IP4_CONFIG
• public const string IP6_CONFIG
• public const string IP_INTERFACE
• public const string MANAGED
• public const string MTU
• public const string PHYSICAL_PORT_ID
• public const string PRODUCT
• public const string REAL
• public const string STATE
• public const string STATE_REASON
• public const string UDI
• public const string VENDOR

Properties:

• public string @interface { owned get; }
  The interface of the device.
• public ActiveConnection active_connection { get; }
  The ActiveConnection object that "owns" this device during activation.
• public bool autoconnect { get; set; }
  Whether the device can auto-activate a connection.
• public ObjectArray available_connections { get; }
  The available connections (#NMRemoteConnection) of the device
• public uint capabilities { get; }
  The capabilities of the device.
• public uint device_type { get; }
  The numeric type of the device.
• public DHCP4Config dhcp4_config { get; }
  The DHCP4Config of the device.
• public DHCP6Config dhcp6_config { get; }
  The DHCP6Config of the device.
• public string driver { get; }
  The driver of the device.
• public string driver_version { get; }
  The version of the device driver.
• public bool firmware_missing { get; }
  When true indicates the device is likely missing firmware required for its operation.
• public string firmware_version { get; }
  The firmware version of the device.
• public IP4Config ip4_config { get; }
  The IP4Config of the device.
• public IP6Config ip6_config { get; }
  The IP6Config of the device.
• public string ip_interface { owned get; }
  The IP interface of the device which should be used for all IP-related operations like addressing and routing.
• public bool managed { get; }
  Whether the device is managed by NetworkManager.
• public uint mtu { get; }
  The MTU of the device.
• public string physical_port_id { get; }
  The physical port ID of the device.
• public string product { get; }
  The product string of the device.
• public bool real { get; }
  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.
• public uint state { get; }
  The state of the device.
• public string udi { get; }
  An operating-system specific device hardware identifier; this is not unique to a specific hardware device across reboots or hotplugs.
• public string vendor { get; }
  The vendor string of the device.

Static methods:

• public static string[] disambiguate_names (Device[] devices)
  Generates a list of short-ish unique presentation names for the devices in devices.

Creation methods:

• public Device (Connection connection, string path)
  Creates a new Device.

Methods:

• public void @delete (DeviceCallbackFn? callback)
  Deletes the software device.
• public virtual bool connection_compatible (Connection connection) throws Error
  Validates a given connection for a given Device object and returns whether the connection may be activated with the device.
• public bool connection_valid (Connection connection)
  Validates a given connection for a given Device object and returns whether the connection may be activated with the device.
• public void disconnect (DeviceCallbackFn? callback)
  Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.
• public SList<unowned Connection> filter_connections (SList<Connection> connections)
  Filters a given list of connections for a given Device object and return connections which may be activated with the device.
• public unowned ActiveConnection get_active_connection ()
  Gets the ActiveConnection object which owns this device during activation.
• public bool get_autoconnect ()
  Whether the Device can be autoconnected.
• public unowned GenericArray<RemoteConnection> get_available_connections ()
  Gets the RemoteConnections currently known to the daemon that could be activated on this.
• public DeviceCapabilities get_capabilities ()
  Gets the device' capabilities.
• public unowned string get_description ()
  Gets a description of this, based on its vendor and product names.
• public DeviceType get_device_type ()
  Returns the numeric type of the Device, ie Ethernet, Wi-Fi, etc.
• public unowned DHCP4Config get_dhcp4_config ()
  Gets the current DHCP4Config associated with the Device.
• public unowned DHCP6Config get_dhcp6_config ()
  Gets the current DHCP6Config associated with the Device.
• public unowned string get_driver ()
  Gets the driver of the Device.
• public unowned string get_driver_version ()
  Gets the driver version of the Device.
• public bool get_firmware_missing ()
  Indicates that firmware required for the device's operation is likely to be missing.
• public unowned string get_firmware_version ()
  Gets the firmware version of the Device.
• public virtual unowned string get_hw_address ()
  Gets the current a hardware address (MAC) for the this.
• public unowned string get_iface ()
  Gets the interface name of the Device.
• public unowned IP4Config get_ip4_config ()
  Gets the current IP4Config associated with the Device.
• public unowned IP6Config get_ip6_config ()
  Gets the current IP6Config associated with the Device.
• public unowned string get_ip_iface ()
  Gets the IP interface name of the Device over which IP traffic flows when the device is in the ACTIVATED state.
• public bool get_managed ()
  Whether the Device is managed by NetworkManager.
• public uint32 get_mtu ()
  Gets the MTU of the Device.
• public unowned string get_physical_port_id ()
  Gets the physical port ID of the Device.
• public unowned string get_product ()
  Gets the product string of the Device.
• public virtual Type get_setting_type ()
  Gets the (primary) Setting subtype associated with connections that can be used on this.
• public DeviceState get_state ()
  Gets the current Device state.
• public DeviceState get_state_reason (out DeviceStateReason reason)
  Gets the current Device state (return value) and the reason for entering the state (reason argument).
• public virtual unowned string get_type_description ()
  Gets a (non-localized) description of the type of device that this is.
• public unowned string get_udi ()
  Gets the Unique Device Identifier of the Device.
• public unowned string get_vendor ()
  Gets the vendor string of the Device.
• public bool is_real ()
• public bool is_software ()
  Whether the device is a software device.
• public void set_autoconnect (bool autoconnect)
  Enables or disables automatic activation of the Device .
• public void set_managed (bool managed)
  Enables or disables management of Device by NetworkManager.

Signals:

• public virtual signal void state_changed (uint new_state, uint old_state, uint reason)
  Notifies the state change of a Device.

Inherited Members: