NetworkManager::Connection Class

Member Function Documentation

[explicit] Connection::Connection(const QString &path, QObject *parent = nullptr)

Constructs a connection object for the given path

[since 5.8.0] QDBusPendingReply<> Connection::clearSecrets()

Clear the secrets belonging to this network connection profile.

This function was introduced in 5.8.0.

[since 0.9.9.0] bool Connection::isUnsaved() const

If set, indicates that the in-memory state of the connection does not match the on-disk state. This flag will be set when updateUnsaved() is called or when any connection details change, and cleared when the connection is saved to disk via save() or from internal operations.

This function was introduced in 0.9.9.0.

bool Connection::isValid() const

Returns if this connection is valid

QString Connection::name() const

Returns the name of this connection

QString Connection::path() const

Returns the path (DBus) of this connection

QDBusPendingReply<> Connection::remove()

Removes the connection from NetworkManager database, this operation does not ask for confirmation but a policykit rule might prevent it from being removed without the proper password.

[signal] void Connection::removed(const QString &path)

Emitted when the connection was removed

path connections's path.

[since 0.9.9.0] QDBusPendingReply<> Connection::save()

Saves a "dirty" connection (that had previously been updated with updateUnsaved()) to persistent storage.

This function was introduced in 0.9.9.0.

QDBusPendingReply<NMVariantMapMap> Connection::secrets(const QString &setting)

Retrieves this connections's secrets (passwords and / or encryption keys).

setting the setting identifier.

NetworkManager::ConnectionSettings::Ptr Connection::settings()

Returns the settings of this connection

[signal] void Connection::unsavedChanged(bool unsaved)

Emitted when the connection unsaved state changes

QDBusPendingReply<> Connection::update(const NMVariantMapMap &settings)

Update the connection with new settings and properties, replacing all previous settings and properties. Secrets may be part of the update request, and will be either stored in persistent storage or given to a Secret Agent for storage, depending on the request.

[since 0.9.9.0] QDBusPendingReply<> Connection::updateUnsaved(const NMVariantMapMap &settings)

Update the connection with new settings and properties (replacing all previous settings and properties) but do not immediately save the connection to disk. Secrets may be part of the update request and may sent to a Secret Agent for storage, depending on the flags associated with each secret.

Use the save() method to save these changes to disk. Note that unsaved changes will be lost if the connection is reloaded from disk (either automatically on file change or due to an explicit reloadConnections() call).

This function was introduced in 0.9.9.0.

[signal] void Connection::updated()

Emitted when the connection settings changes

QString Connection::uuid() const

Returns the unique identifier of this connection