Struct SettingMatch 

pub struct SettingMatch { /* private fields */ }

Available on crate feature v1_14 only.

Match settings

Properties

driver

A list of driver names to match. Each element is a shell wildcard pattern.

See NMSettingMatch:interface-name for how special characters ‘|’, ‘&’, ‘!’ and ‘\’ are used for optional and mandatory matches and inverting the pattern.

Readable | Writeable

interface-name

A list of interface names to match. Each element is a shell wildcard pattern.

An element can be prefixed with a pipe symbol (|) or an ampersand (&). The former means that the element is optional and the latter means that it is mandatory. If there are any optional elements, than the match evaluates to true if at least one of the optional element matches (logical OR). If there are any mandatory elements, then they all must match (logical AND). By default, an element is optional. This means that an element “foo” behaves the same as “|foo”. An element can also be inverted with exclamation mark (!) between the pipe symbol (or the ampersand) and before the pattern. Note that “!foo” is a shortcut for the mandatory match “&!foo”. Finally, a backslash can be used at the beginning of the element (after the optional special characters) to escape the start of the pattern. For example, “&\!a” is an mandatory match for literally “!a”.

Readable | Writeable

kernel-command-line

A list of kernel command line arguments to match. This may be used to check whether a specific kernel command line option is set (or unset, if prefixed with the exclamation mark). The argument must either be a single word, or an assignment (i.e. two words, joined by “=”). In the former case the kernel command line is searched for the word appearing as is, or as left hand side of an assignment. In the latter case, the exact assignment is looked for with right and left hand side matching. Wildcard patterns are not supported.

See NMSettingMatch:interface-name for how special characters ‘|’, ‘&’, ‘!’ and ‘\’ are used for optional and mandatory matches and inverting the match.

Readable | Writeable

path

A list of paths to match against the ID_PATH udev property of devices. ID_PATH represents the topological persistent path of a device. It typically contains a subsystem string (pci, usb, platform, etc.) and a subsystem-specific identifier.

For PCI devices the path has the form “pci-$domain:$bus:$device.$function”, where each variable is an hexadecimal value; for example “pci-0000:0a:00.0”.

The path of a device can be obtained with “udevadm info /sys/class/net/$dev | grep ID_PATH=” or by looking at the “path” property exported by NetworkManager (“nmcli -f general.path device show $dev”).

Each element of the list is a shell wildcard pattern.

See NMSettingMatch:interface-name for how special characters ‘|’, ‘&’, ‘!’ and ‘\’ are used for optional and mandatory matches and inverting the pattern.

Readable | Writeable

Setting

name

The setting’s name, which uniquely identifies the setting within the connection. Each setting type has a name unique to that type, for example “ppp” or “802-11-wireless” or “802-3-ethernet”.

Readable

Implements

SettingExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl SettingMatch

pub fn builder() -> SettingMatchBuilder

Creates a new builder-pattern struct instance to construct SettingMatch objects.

This method returns an instance of SettingMatchBuilder which can be used to create SettingMatch objects.

pub fn add_interface_name(&self, interface_name: &str)

Adds a new interface name to the setting.

interface_name

the interface name to add

pub fn clear_interface_names(&self)

Removes all configured interface names.

pub fn interface_name(&self, idx: i32) -> GString

Since 1.46, access at index “len” is allowed and returns NULL.

idx

index number of the DNS search domain to return

Returns

the interface name at index @idx

pub fn interface_names(&self) -> Vec<GString>

Returns all the interface names.

Returns

the NULL terminated list of configured interface names.

Before 1.26, the returned array was not None terminated and you MUST provide a length.

pub fn num_interface_names(&self) -> u32

Returns

the number of configured interface names

pub fn remove_interface_name(&self, idx: i32)

Removes the interface name at index @idx.

idx

index number of the interface name

pub fn remove_interface_name_by_value(&self, interface_name: &str) -> bool

Removes @interface_name.

interface_name

the interface name to remove

Returns

true if the interface name was found and removed; false if it was not.

pub fn set_interface_name(&self, interface_name: &[&str])

A list of interface names to match. Each element is a shell wildcard pattern.

An element can be prefixed with a pipe symbol (|) or an ampersand (&). The former means that the element is optional and the latter means that it is mandatory. If there are any optional elements, than the match evaluates to true if at least one of the optional element matches (logical OR). If there are any mandatory elements, then they all must match (logical AND). By default, an element is optional. This means that an element “foo” behaves the same as “|foo”. An element can also be inverted with exclamation mark (!) between the pipe symbol (or the ampersand) and before the pattern. Note that “!foo” is a shortcut for the mandatory match “&!foo”. Finally, a backslash can be used at the beginning of the element (after the optional special characters) to escape the start of the pattern. For example, “&\!a” is an mandatory match for literally “!a”.

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

Trait Implementations

impl Clone for SettingMatch

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SettingMatch

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for SettingMatch

type ParamSpec = ParamSpecObject

type SetValue = SettingMatch

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(&str) -> ParamSpecObjectBuilder<'_, SettingMatch>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for SettingMatch

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SettingMatch

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for SettingMatch

type Parent = Setting

impl<OT: ObjectType> PartialEq<OT> for SettingMatch

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for SettingMatch

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for SettingMatch

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for SettingMatch

impl IsA<Setting> for SettingMatch