DeviceExt

nm_rs::prelude

Trait DeviceExt 

Source 
pub trait DeviceExt: IsA<Device> + 'static {

Show 84 methods    // Provided methods
    fn connection_compatible(
        &self,
        connection: &impl IsA<Connection>,
    ) -> Result<(), Error> { ... }
    fn connection_valid(&self, connection: &impl IsA<Connection>) -> bool { ... }
    fn delete(
        &self,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn delete_async<P: FnOnce(Result<(), Error>) + 'static>(
        &self,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) { ... }
    fn delete_future(
        &self,
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>> { ... }
    fn disconnect(
        &self,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn disconnect_async<P: FnOnce(Result<(), Error>) + 'static>(
        &self,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) { ... }
    fn disconnect_future(
        &self,
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>> { ... }
    fn filter_connections(&self, connections: &[Connection]) -> Vec<Connection> { ... }
    fn active_connection(&self) -> ActiveConnection { ... }
    fn applied_connection(
        &self,
        flags: u32,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(Connection, u64), Error> { ... }
    fn applied_connection_async<P: FnOnce(Result<(Connection, u64), Error>) + 'static>(
        &self,
        flags: u32,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) { ... }
    fn applied_connection_future(
        &self,
        flags: u32,
    ) -> Pin<Box_<dyn Future<Output = Result<(Connection, u64), Error>> + 'static>> { ... }
    fn is_autoconnect(&self) -> bool { ... }
    fn available_connections(&self) -> Vec<RemoteConnection> { ... }
    fn capabilities(&self) -> DeviceCapabilities { ... }
    fn connectivity(&self, addr_family: i32) -> ConnectivityState { ... }
    fn description(&self) -> GString { ... }
    fn device_type(&self) -> DeviceType { ... }
    fn dhcp4_config(&self) -> DhcpConfig { ... }
    fn dhcp6_config(&self) -> DhcpConfig { ... }
    fn driver(&self) -> GString { ... }
    fn driver_version(&self) -> GString { ... }
    fn is_firmware_missing(&self) -> bool { ... }
    fn firmware_version(&self) -> GString { ... }
    fn hw_address(&self) -> GString { ... }
    fn iface(&self) -> GString { ... }
    fn ip4_config(&self) -> IPConfig { ... }
    fn ip6_config(&self) -> IPConfig { ... }
    fn ip_iface(&self) -> GString { ... }
    fn lldp_neighbors(&self) -> Vec<LldpNeighbor> { ... }
    fn is_managed(&self) -> bool { ... }
    fn metered(&self) -> Metered { ... }
    fn mtu(&self) -> u32 { ... }
    fn is_nm_plugin_missing(&self) -> bool { ... }
    fn physical_port_id(&self) -> GString { ... }
    fn product(&self) -> GString { ... }
    fn setting_type(&self) -> Type { ... }
    fn state(&self) -> DeviceState { ... }
    fn state_reason(&self) -> DeviceStateReason { ... }
    fn type_description(&self) -> GString { ... }
    fn udi(&self) -> GString { ... }
    fn vendor(&self) -> GString { ... }
    fn is_real(&self) -> bool { ... }
    fn is_software(&self) -> bool { ... }
    fn reapply(
        &self,
        connection: Option<&impl IsA<Connection>>,
        version_id: u64,
        flags: u32,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn reapply_async<P: FnOnce(Result<(), Error>) + 'static>(
        &self,
        connection: Option<&impl IsA<Connection>>,
        version_id: u64,
        flags: u32,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) { ... }
    fn reapply_future(
        &self,
        connection: Option<&(impl IsA<Connection> + Clone + 'static)>,
        version_id: u64,
        flags: u32,
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>> { ... }
    fn set_autoconnect(&self, autoconnect: bool) { ... }
    fn set_managed(&self, managed: bool) { ... }
    fn interface(&self) -> Option<GString> { ... }
    fn ip_interface(&self) -> Option<GString> { ... }
    fn ip4_connectivity(&self) -> ConnectivityState { ... }
    fn ip6_connectivity(&self) -> ConnectivityState { ... }
    fn connect_state_changed<F: Fn(&Self, u32, u32, u32) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_active_connection_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_autoconnect_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_available_connections_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_capabilities_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_device_type_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_dhcp4_config_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_dhcp6_config_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_driver_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_driver_version_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_firmware_missing_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_firmware_version_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_interface_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_ip_interface_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_ip4_config_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_ip4_connectivity_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_ip6_config_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_ip6_connectivity_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_lldp_neighbors_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_managed_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_metered_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_mtu_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_nm_plugin_missing_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_physical_port_id_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_product_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_real_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_state_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_state_reason_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_udi_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }
    fn connect_vendor_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId { ... }

}
Expand description

Trait containing all Device methods.

§Implementors

Device6Lowpan, DeviceAdsl, DeviceBond, DeviceBridge, DeviceBt, DeviceDummy, DeviceEthernet, DeviceGeneric, [DeviceHsr][struct@crate::DeviceHsr], DeviceIPTunnel, DeviceInfiniband, [DeviceIpvlan][struct@crate::DeviceIpvlan], DeviceLoopback, DeviceMacsec, DeviceMacvlan, DeviceModem, DeviceOlpcMesh, DeviceOvsBridge, DeviceOvsPort, DevicePpp, DeviceTeam, DeviceTun, DeviceVlan, [DeviceVrf][struct@crate::DeviceVrf], DeviceVxlan, DeviceWifiP2P, DeviceWifi, DeviceWimax, DeviceWireGuard, DeviceWpan, Device

Provided Methods§

Source

fn connection_compatible( &self, connection: &impl IsA<Connection>, ) -> Result<(), Error>

Validates a given connection for a given #NMDevice 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 GError when FALSE is returned.

§connection

an #NMConnection 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.

Source

fn connection_valid(&self, connection: &impl IsA<Connection>) -> bool

Validates a given connection for a given #NMDevice 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.

§connection

an #NMConnection 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.

Source

fn delete( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

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

§Deprecated since 1.22

Use nm_device_delete_async() or GDBusConnection.

§cancellable

a #GCancellable, or None

§Returns

true on success, false on error, in which case @error will be set.

Source

fn delete_async<P: FnOnce(Result<(), Error>) + 'static>( &self, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

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

§cancellable

a #GCancellable, or None

§callback

callback to be called when delete operation completes

Source

fn delete_future( &self, ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>

Source

fn disconnect( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

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

§Deprecated since 1.22

Use nm_device_disconnect_async() or GDBusConnection.

§cancellable

a #GCancellable, or None

§Returns

true on success, false on error, in which case @error will be set.

Source

fn disconnect_async<P: FnOnce(Result<(), Error>) + 'static>( &self, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

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

§cancellable

a #GCancellable, or None

§callback

callback to be called when the disconnect operation completes

Source

fn disconnect_future( &self, ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>

Source

fn filter_connections(&self, connections: &[Connection]) -> Vec<Connection>

Filters a given array of connections for a given #NMDevice 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().

§connections

an array of #NMConnections to filter

§Returns

an array of #NMConnections 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().

Source

fn active_connection(&self) -> ActiveConnection

Gets the #NMActiveConnection object which owns this device during activation.

§Returns

the #NMActiveConnection or None if the device is not part of an active connection

Source

fn applied_connection( &self, flags: u32, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(Connection, u64), Error>

Available on crate feature v1_2 only.

Fetch the currently applied connection on the device.

§Deprecated since 1.22

Use nm_device_get_applied_connection_async() or GDBusConnection.

§flags

the flags argument. See #NMDeviceReapplyFlags.

§cancellable

a #GCancellable, or None

§Returns

a NMConnection 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

Source

fn applied_connection_async<P: FnOnce(Result<(Connection, u64), Error>) + 'static>( &self, flags: u32, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

Available on crate feature v1_2 only.

Asynchronously begins and gets the currently applied connection.

§flags

the flags argument. See #NMDeviceReapplyFlags.

§cancellable

a #GCancellable, or None

§callback

callback to be called when the reapply operation completes

Source

fn applied_connection_future( &self, flags: u32, ) -> Pin<Box_<dyn Future<Output = Result<(Connection, u64), Error>> + 'static>>

Available on crate feature v1_2 only.
Source

fn is_autoconnect(&self) -> bool

Whether the #NMDevice can be autoconnected.

§Returns

true if the device is allowed to be autoconnected

Source

fn available_connections(&self) -> Vec<RemoteConnection>

Gets the #NMRemoteConnections currently known to the daemon that could be activated on @self.

§Returns

the #GPtrArray containing #NMRemoteConnections. This is the internal copy used by the connection, and must not be modified.

Source

fn capabilities(&self) -> DeviceCapabilities

Gets the device’ capabilities.

§Returns

the capabilities

Source

fn connectivity(&self, addr_family: i32) -> ConnectivityState

Available on crate feature v1_16 only.

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.

§addr_family

network address family

§Returns

the current connectivity state

Source

fn description(&self) -> GString

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

§Returns

a description of @self. If either the vendor or the product name is unknown, this returns the interface name.

Source

fn device_type(&self) -> DeviceType

Returns the numeric type of the #NMDevice, ie Ethernet, Wi-Fi, etc.

§Returns

the device type

Examples found in repository?
examples/get_device_type.rs (line 11)
4fn print_devices(client: &Client) {
5    let devices = client.devices();
6
7    for device in devices {
8        let name = device.iface();
9        println!(
10            "The network interface {name} is a {:#?} device.",
11            device.device_type()
12        );
13    }
14}
Source

fn dhcp4_config(&self) -> DhcpConfig

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.

§Returns

the IPv4 #NMDhcpConfig, or None if the device is not activated or not using DHCP.

Source

fn dhcp6_config(&self) -> DhcpConfig

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.

§Returns

the IPv6 #NMDhcpConfig, or None if the device is not activated or not using DHCPv6.

Source

fn driver(&self) -> GString

Gets the driver of the #NMDevice.

§Returns

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

Source

fn driver_version(&self) -> GString

Gets the driver version of the #NMDevice.

§Returns

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

Source

fn is_firmware_missing(&self) -> bool

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

§Returns

true if firmware required for the device’s operation is likely to be missing.

Source

fn firmware_version(&self) -> GString

Gets the firmware version of the #NMDevice.

§Returns

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

Source

fn hw_address(&self) -> GString

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

§Returns

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

Source

fn iface(&self) -> GString

Gets the interface name of the #NMDevice.

§Returns

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

Examples found in repository?
examples/get_device_type.rs (line 8)
4fn print_devices(client: &Client) {
5    let devices = client.devices();
6
7    for device in devices {
8        let name = device.iface();
9        println!(
10            "The network interface {name} is a {:#?} device.",
11            device.device_type()
12        );
13    }
14}
Source

fn ip4_config(&self) -> IPConfig

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.

§Returns

the IPv4 #NMIPConfig, or None if the device is not activated.

Source

fn ip6_config(&self) -> IPConfig

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.

§Returns

the IPv6 #NMIPConfig or None if the device is not activated.

Source

fn ip_iface(&self) -> GString

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

§Returns

the IP traffic interface of the device. This is the internal string used by the device, and must not be modified.

Source

fn lldp_neighbors(&self) -> Vec<LldpNeighbor>

Available on crate feature v1_2 only.

Gets the list of neighbors discovered through LLDP.

§Returns

the #GPtrArray containing #NMLldpNeighbors. 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.

Source

fn is_managed(&self) -> bool

Whether the #NMDevice is managed by NetworkManager.

§Returns

true if the device is managed by NetworkManager

Source

fn metered(&self) -> Metered

Available on crate feature v1_2 only.

Gets the metered setting of a #NMDevice.

§Returns

the metered setting.

Source

fn mtu(&self) -> u32

Gets the MTU of the #NMDevice.

§Returns

the MTU of the device in bytes.

Source

fn is_nm_plugin_missing(&self) -> bool

Available on crate feature v1_2 only.

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

§Returns

true if the device plugin not installed.

Source

fn physical_port_id(&self) -> GString

Gets the physical port ID of the #NMDevice. If non-None, 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.)

§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.

Source

fn product(&self) -> GString

Gets the product string of the #NMDevice.

§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 g_strcompress(), however the result may not be valid UTF-8.

Source

fn setting_type(&self) -> Type

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

§Returns

@self’s associated #NMSetting type

Source

fn state(&self) -> DeviceState

Gets the current #NMDevice state.

§Returns

the current device state

Source

fn state_reason(&self) -> DeviceStateReason

Gets the reason for entering the current #NMDevice state.

§Returns

the reason for entering the current device state

Source

fn type_description(&self) -> GString

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

§Returns

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

Source

fn udi(&self) -> GString

Gets the Unique Device Identifier of the #NMDevice.

§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.

Source

fn vendor(&self) -> GString

Gets the vendor string of the #NMDevice.

§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 g_strcompress(), however the result may not be valid UTF-8.

Source

fn is_real(&self) -> bool

Available on crate feature v1_2 only.
§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 #NMDevice:available-connections was activated.

Source

fn is_software(&self) -> bool

Whether the device is a software device.

§Returns

true if @self is a software device, false if it is a hardware device.

Source

fn reapply( &self, connection: Option<&impl IsA<Connection>>, version_id: u64, flags: u32, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

Available on crate feature v1_2 only.

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

§Deprecated since 1.22

Use nm_device_reapply_async() or GDBusConnection.

§connection

the #NMConnection to replace the applied settings with or None to reuse existing

§version_id

zero or the expected version id of the applied connection. If specified and the version id mismatches, the call fails without modification. This allows one to catch concurrent accesses.

§flags

always set this to zero

§cancellable

a #GCancellable, or None

§Returns

true on success, false on error, in which case @error will be set.

Source

fn reapply_async<P: FnOnce(Result<(), Error>) + 'static>( &self, connection: Option<&impl IsA<Connection>>, version_id: u64, flags: u32, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

Available on crate feature v1_2 only.

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

§connection

the #NMConnection to replace the applied settings with or None to reuse existing

§version_id

zero or the expected version id of the applied connection. If specified and the version id mismatches, the call fails without modification. This allows one to catch concurrent accesses.

§flags

always set this to zero

§cancellable

a #GCancellable, or None

§callback

callback to be called when the reapply operation completes

Source

fn reapply_future( &self, connection: Option<&(impl IsA<Connection> + Clone + 'static)>, version_id: u64, flags: u32, ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>

Available on crate feature v1_2 only.
Source

fn set_autoconnect(&self, autoconnect: bool)

Enables or disables automatic activation of the #NMDevice.

§Deprecated since 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 NMClient cache client side.

§autoconnect

true to enable autoconnecting

Source

fn set_managed(&self, managed: bool)

Available on crate feature v1_2 only.

Enables or disables management of #NMDevice by NetworkManager.

§Deprecated since 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 NMClient cache client side. Also, it does not emit a property changed signal.

§managed

true to make the device managed by NetworkManager.

Source

fn interface(&self) -> Option<GString>

The interface of the device.

Source

fn ip_interface(&self) -> Option<GString>

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

Source

fn ip4_connectivity(&self) -> ConnectivityState

Available on crate feature v1_16 only.

The IPv4 connectivity state of the device.

Source

fn ip6_connectivity(&self) -> ConnectivityState

Available on crate feature v1_16 only.

The IPv6 connectivity state of the device.

Source

fn connect_state_changed<F: Fn(&Self, u32, u32, u32) + 'static>( &self, f: F, ) -> SignalHandlerId

Notifies the state change of a #NMDevice.

§new_state

the new state of the device

§old_state

the previous state of the device

§reason

the reason describing the state change

Source

fn connect_active_connection_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_autoconnect_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_available_connections_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_capabilities_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_device_type_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_dhcp4_config_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_dhcp6_config_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_driver_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Source

fn connect_driver_version_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_firmware_missing_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_firmware_version_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_interface_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_ip_interface_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_ip4_config_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_ip4_connectivity_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_16 only.
Source

fn connect_ip6_config_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_ip6_connectivity_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_16 only.
Source

fn connect_lldp_neighbors_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_managed_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_metered_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_2 only.
Source

fn connect_mtu_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Source

fn connect_nm_plugin_missing_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_2 only.
Source

fn connect_physical_port_id_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_product_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_real_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Available on crate feature v1_2 only.
Source

fn connect_state_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Source

fn connect_state_reason_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Source

fn connect_udi_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Source

fn connect_vendor_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§

Source§

impl<O: IsA<Device>> DeviceExt for O