Struct RemoteConnection 

pub struct RemoteConnection { /* private fields */ }

Properties

filename

File that stores the connection in case the connection is file-backed.

Readable

flags

The flags of the connection as unsigned integer. The values correspond to the #NMSettingsConnectionFlags enum.

Readable

unsaved

true if the remote connection contains changes that have not been saved to disk, false if the connection is the same as its on-disk representation.

Readable

version-id

The version ID of the profile that is incremented when the profile gets modified. This can be used to track concurrent modifications of the profile.

Readable

visible

true if the remote connection is visible to the current user, false if not. If the connection is not visible then it is essentially useless; it will not contain any settings, and operations such as nm_remote_connection_save() and nm_remote_connection_delete() will always fail. (#NMRemoteSettings will not normally return non-visible connections to callers, but it is possible for a connection’s visibility to change after you already have a reference to it.)

Readable

Object

client

The NMClient instance as returned by nm_object_get_client().

When an NMObject gets removed from the NMClient cache, the NMObject:path property stays unchanged, but this client instance gets reset to None. You can use this property to track removal of the object from the cache.

Readable

path

The D-Bus object path.

The D-Bus path of an object instance never changes, even if the object gets removed from the cache. To see whether the object is still in the cache, check NMObject:client.

Readable

Implements

ObjectExt, ConnectionExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl RemoteConnection

pub fn commit_changes( &self, save_to_disk: bool, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

Send any local changes to the settings and properties of @self to NetworkManager. If @save_to_disk is true, the updated connection will be saved to disk; if false, then only the in-memory representation will be changed.

Deprecated since 1.22

Use nm_remote_connection_commit_changes_async() or GDBusConnection.

save_to_disk

whether to persist the changes to disk

cancellable

a #GCancellable, or None

Returns

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

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

Asynchronously sends any local changes to the settings and properties of @self to NetworkManager. If @save is true, the updated connection will be saved to disk; if false, then only the in-memory representation will be changed.

save_to_disk

whether to save the changes to persistent storage

cancellable

a #GCancellable, or None

callback

callback to be called when the commit operation completes

pub fn commit_changes_future( &self, save_to_disk: bool, ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>

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

Deletes the connection.

Deprecated since 1.22

Use nm_remote_connection_delete_async() or GDBusConnection.

cancellable

a #GCancellable, or None

Returns

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

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

Asynchronously deletes the connection.

cancellable

a #GCancellable, or None

callback

callback to be called when the delete operation completes

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

pub fn filename(&self) -> GString

Available on crate feature v1_12 only.

Returns

file that stores the connection in case the connection is file-backed.

pub fn flags(&self) -> SettingsConnectionFlags

Available on crate feature v1_12 only.

Returns

the flags of the connection of type #NMSettingsConnectionFlags.

pub fn is_unsaved(&self) -> bool

Returns

true if the remote connection contains changes that have not been saved to disk, false if the connection is the same as its on-disk representation.

pub fn is_visible(&self) -> bool

Checks if the connection is visible to the current user. If the connection is not visible then it is essentially useless; it will not contain any settings, and operations such as nm_remote_connection_save() and nm_remote_connection_delete() will always fail. (#NMRemoteSettings will not normally return non-visible connections to callers, but it is possible for a connection’s visibility to change after you already have a reference to it.)

Returns

true if the remote connection is visible to the current user, false if not.

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

Saves the connection to disk if the connection has changes that have not yet been written to disk, or if the connection has never been saved.

Deprecated since 1.22

Use nm_remote_connection_save_async() or GDBusConnection.

cancellable

a #GCancellable, or None

Returns

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

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

Saves the connection to disk if the connection has changes that have not yet been written to disk, or if the connection has never been saved.

cancellable

a #GCancellable, or None

callback

callback to be called when the save operation completes

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

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

Available on crate feature v1_12 only.

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

Available on crate feature v1_12 only.

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

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

Trait Implementations

impl Clone for RemoteConnection

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 RemoteConnection

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

Formats the value using the given formatter.

impl HasParamSpec for RemoteConnection

type ParamSpec = ParamSpecObject

type SetValue = RemoteConnection

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

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

fn param_spec_builder() -> Self::BuilderFn

impl Hash for RemoteConnection

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 RemoteConnection

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 RemoteConnection

type Parent = Object

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

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 RemoteConnection

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 RemoteConnection

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for RemoteConnection

impl IsA<Connection> for RemoteConnection

impl IsA<Object> for RemoteConnection