Device

---

Object Hierarchy:

Description:

Content:

Constants:

• public const string @6LOWPAN_HW_ADDRESS
• public const string @6LOWPAN_PARENT
• public const string ACTIVE_CONNECTION
• public const string ADSL_CARRIER
• public const string AUTOCONNECT
• public const string AVAILABLE_CONNECTIONS
• public const string BOND_CARRIER
• public const string BOND_HW_ADDRESS
• public const string BOND_SLAVES
• public const string BRIDGE_CARRIER
• public const string BRIDGE_HW_ADDRESS
• public const string BRIDGE_SLAVES
• public const string BT_CAPABILITIES
• public const string BT_HW_ADDRESS
• public const string BT_NAME
• 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 DUMMY_HW_ADDRESS
• public const string ETHERNET_CARRIER
• public const string ETHERNET_HW_ADDRESS
• public const string ETHERNET_PERMANENT_HW_ADDRESS
• public const string ETHERNET_S390_SUBCHANNELS
• public const string ETHERNET_SPEED
• public const string FIRMWARE_MISSING
• public const string FIRMWARE_VERSION
• public const string GENERIC_HW_ADDRESS
• public const string GENERIC_TYPE_DESCRIPTION
• public const string GENEVE_DF
• public const string GENEVE_DST_PORT
• public const string GENEVE_ID
• public const string GENEVE_REMOTE
• public const string GENEVE_TOS
• public const string GENEVE_TTL
• public const string HSR_MULTICAST_SPEC
• public const string HSR_PORT1
• public const string HSR_PORT2
• public const string HSR_PRP
• public const string HSR_SUPERVISION_ADDRESS
• public const string HW_ADDRESS
• public const string INFINIBAND_CARRIER
• public const string INFINIBAND_HW_ADDRESS
• public const string INTERFACE
• public const string INTERFACE_FLAGS
• public const string IP4_CONFIG
• public const string IP4_CONNECTIVITY
• public const string IP6_CONFIG
• public const string IP6_CONNECTIVITY
• public const string IPVLAN_MODE
• public const string IPVLAN_PARENT
• public const string IPVLAN_PRIVATE
• public const string IPVLAN_VEPA
• public const string IP_INTERFACE
• public const string IP_TUNNEL_ENCAPSULATION_LIMIT
• public const string IP_TUNNEL_FLAGS
• public const string IP_TUNNEL_FLOW_LABEL
• public const string IP_TUNNEL_FWMARK
• public const string IP_TUNNEL_INPUT_KEY
• public const string IP_TUNNEL_LOCAL
• public const string IP_TUNNEL_MODE
• public const string IP_TUNNEL_OUTPUT_KEY
• public const string IP_TUNNEL_PARENT
• public const string IP_TUNNEL_PATH_MTU_DISCOVERY
• public const string IP_TUNNEL_REMOTE
• public const string IP_TUNNEL_TOS
• public const string IP_TUNNEL_TTL
• public const string LLDP_NEIGHBORS
• public const string MACSEC_CIPHER_SUITE
• public const string MACSEC_ENCODING_SA
• public const string MACSEC_ENCRYPT
• public const string MACSEC_ES
• public const string MACSEC_HW_ADDRESS
• public const string MACSEC_ICV_LENGTH
• public const string MACSEC_INCLUDE_SCI
• public const string MACSEC_PARENT
• public const string MACSEC_PROTECT
• public const string MACSEC_REPLAY_PROTECT
• public const string MACSEC_SCB
• public const string MACSEC_SCI
• public const string MACSEC_VALIDATION
• public const string MACSEC_WINDOW
• public const string MACVLAN_HW_ADDRESS
• public const string MACVLAN_MODE
• public const string MACVLAN_NO_PROMISC
• public const string MACVLAN_PARENT
• public const string MACVLAN_TAP
• public const string MANAGED
• public const string METERED
• public const string MODEM_APN
• public const string MODEM_CURRENT_CAPABILITIES
• public const string MODEM_DEVICE_ID
• public const string MODEM_MODEM_CAPABILITIES
• public const string MODEM_OPERATOR_CODE
• public const string MTU
• public const string NM_PLUGIN_MISSING
• public const string OLPC_MESH_ACTIVE_CHANNEL
• public const string OLPC_MESH_COMPANION
• public const string OLPC_MESH_HW_ADDRESS
• public const string OVS_BRIDGE_SLAVES
• public const string OVS_PORT_SLAVES
• public const string PATH
• public const string PHYSICAL_PORT_ID
• public const string PORTS
• public const string PRODUCT
• public const string REAL
• public const string STATE
• public const string STATE_REASON
• public const string TEAM_CARRIER
• public const string TEAM_CONFIG
• public const string TEAM_HW_ADDRESS
• public const string TEAM_SLAVES
• public const string TUN_GROUP
• public const string TUN_HW_ADDRESS
• public const string TUN_MODE
• public const string TUN_MULTI_QUEUE
• public const string TUN_NO_PI
• public const string TUN_OWNER
• public const string TUN_VNET_HDR
• public const string UDI
• public const string VENDOR
• public const string VETH_PEER
• public const string VLAN_CARRIER
• public const string VLAN_HW_ADDRESS
• public const string VLAN_PARENT
• public const string VLAN_VLAN_ID
• public const string VRF_TABLE
• public const string VXLAN_AGEING
• public const string VXLAN_CARRIER
• public const string VXLAN_DST_PORT
• public const string VXLAN_GROUP
• public const string VXLAN_HW_ADDRESS
• public const string VXLAN_ID
• public const string VXLAN_L2MISS
• public const string VXLAN_L3MISS
• public const string VXLAN_LEARNING
• public const string VXLAN_LIMIT
• public const string VXLAN_LOCAL
• public const string VXLAN_PARENT
• public const string VXLAN_PROXY
• public const string VXLAN_RSC
• public const string VXLAN_SRC_PORT_MAX
• public const string VXLAN_SRC_PORT_MIN
• public const string VXLAN_TOS
• public const string VXLAN_TTL
• public const string WIFI_ACCESS_POINTS
• public const string WIFI_ACTIVE_ACCESS_POINT
• public const string WIFI_BITRATE
• public const string WIFI_CAPABILITIES
• public const string WIFI_HW_ADDRESS
• public const string WIFI_LAST_SCAN
• public const string WIFI_MODE
• public const string WIFI_P2P_HW_ADDRESS
• public const string WIFI_P2P_PEERS
• public const string WIFI_P2P_WFDIES
• public const string WIFI_PERMANENT_HW_ADDRESS
• public const string WIMAX_ACTIVE_NSP
• public const string WIMAX_BSID
• public const string WIMAX_CENTER_FREQUENCY
• public const string WIMAX_CINR
• public const string WIMAX_HW_ADDRESS
• public const string WIMAX_NSPS
• public const string WIMAX_RSSI
• public const string WIMAX_TX_POWER
• public const string WIREGUARD_FWMARK
• public const string WIREGUARD_LISTEN_PORT
• public const string WIREGUARD_PUBLIC_KEY
• public const string WPAN_HW_ADDRESS

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 GenericArray<RemoteConnection> available_connections { get; }
  The available connections of the device
• public DeviceCapabilities capabilities { get; }
  The capabilities of the device.
• public DeviceType device_type { get; }
  The numeric type of the device.
• public DhcpConfig dhcp4_config { get; }
  The IPv4 DhcpConfig of the device.
• public DhcpConfig dhcp6_config { get; }
  The IPv6 DhcpConfig 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 string hw_address { get; }
  The hardware address of the device.
• public uint interface_flags { get; }
  The interface flags.
• public IPConfig ip4_config { get; }
  The NMIP4Config of the device.
• public ConnectivityState ip4_connectivity { get; }
  The IPv4 connectivity state of the device.
• public IPConfig ip6_config { get; }
  The IPv6 IPConfig of the device.
• public ConnectivityState ip6_connectivity { get; }
  The IPv6 connectivity state 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 GenericArray<LldpNeighbor> lldp_neighbors { get; }
  The LLDP neighbors.
• public bool managed { get; }
  Whether the device is managed by NetworkManager.
• public uint metered { get; }
  Whether the device is metered.
• public uint mtu { get; }
  The MTU of the device.
• public bool nm_plugin_missing { get; }
  When true indicates that the NetworkManager plugin for the device is not installed.
• public string path { get; }
• public string physical_port_id { get; }
  The physical port ID of the device.
• public GenericArray<Device> ports { get; }
  The port devices of the controller 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 DeviceState state { get; }
  The state of the device.
• public uint state_reason { get; }
  The reason for the device state.
• 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:

• protected Device ()

Methods:

• public bool @delete (Cancellable? cancellable = null) throws Error
  Deletes the software device.
• public 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 async bool delete_async (Cancellable? cancellable) throws Error
  Asynchronously begins deleting the software device.
• public bool disconnect (Cancellable? cancellable = null) throws Error
  Disconnects the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.
• public async bool disconnect_async (Cancellable? cancellable) throws Error
  Asynchronously begins disconnecting the device if currently connected, and prevents the device from automatically connecting to networks until the next manual network connection request.
• public GenericArray<Connection> filter_connections (GenericArray<Connection> connections)
  Filters a given array of connections for a given Device object and returns 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 Connection get_applied_connection (uint32 flags, out uint64 version_id, Cancellable? cancellable = null) throws Error
  Fetch the currently applied connection on the device.
• public async Connection get_applied_connection_async (uint32 flags, Cancellable? cancellable, out uint64 version_id) throws Error
  Asynchronously begins and gets the currently applied connection.
• 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 ConnectivityState get_connectivity (int addr_family)
  The connectivity state of the device for given address family.
• 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 DhcpConfig get_dhcp4_config ()
  Gets the current IPv4 DhcpConfig associated with the Device.
• public unowned DhcpConfig get_dhcp6_config ()
  Gets the current IPv6 DhcpConfig 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 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 DeviceInterfaceFlags get_interface_flags ()
  Gets the interface flags of the device.
• public unowned IPConfig get_ip4_config ()
  Gets the current IPv4 IPConfig associated with the Device.
• public unowned IPConfig get_ip6_config ()
  Gets the current IPv6 IPConfig 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 unowned GenericArray<LldpNeighbor> get_lldp_neighbors ()
  Gets the list of neighbors discovered through LLDP.
• public bool get_managed ()
  Whether the Device is managed by NetworkManager.
• public Metered get_metered ()
  Gets the metered setting of a Device .
• public uint32 get_mtu ()
  Gets the MTU of the Device.
• public bool get_nm_plugin_missing ()
  Indicates that the NetworkManager plugin for the device is not installed.
• public unowned string get_path ()
  Gets the path of the Device as exposed by the udev property ID_PATH.
• public unowned string get_physical_port_id ()
  Gets the physical port ID of the Device .
• public unowned GenericArray<Device> get_ports ()
  Gets the devices currently set as port of this.
• public unowned string get_product ()
  Gets the product string of the Device .
• public 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 DeviceStateReason get_state_reason ()
  Gets the reason for entering the current Device state.
• public 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 bool reapply (Connection? connection, uint64 version_id, uint32 flags, Cancellable? cancellable = null) throws Error
  Attempts to update device with changes to the currently active connection made since it was last applied.
• public async bool reapply_async (Connection? connection, uint64 version_id, uint32 flags, Cancellable? cancellable) throws Error
  Asynchronously begins an attempt to update device with changes to the currently active connection made since it was last applied.
• 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.
• public async bool set_managed_async (DeviceManaged managed, DeviceManagedFlags flags, Cancellable? cancellable) throws Error
  Asynchronously begins setting the managed state of the device.

Signals:

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

Inherited Members: