Top |
Functions
Types and Values
#define | NM_REMOTE_CONNECTION_DBUS_CONNECTION |
#define | NM_REMOTE_CONNECTION_PATH |
#define | NM_REMOTE_CONNECTION_UNSAVED |
#define | NM_REMOTE_CONNECTION_VISIBLE |
NMRemoteConnection |
Functions
nm_remote_connection_update2 ()
void nm_remote_connection_update2 (NMRemoteConnection *connection
,GVariant *settings
,NMSettingsUpdate2Flags flags
,GVariant *args
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously calls the Update2()
D-Bus method.
Parameters
connection |
||
settings |
optional connection to update the settings. |
[allow-none] |
flags |
update-flags |
|
args |
optional arguments. |
[allow-none] |
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the commit operation completes |
|
user_data |
caller-specific data passed to |
Since: 1.10.2
nm_remote_connection_update2_finish ()
GVariant * nm_remote_connection_update2_finish (NMRemoteConnection *connection
,GAsyncResult *result
,GError **error
);
Gets the result of a call to nm_remote_connection_commit_changes_async()
.
nm_remote_connection_commit_changes ()
gboolean nm_remote_connection_commit_changes (NMRemoteConnection *connection
,gboolean save_to_disk
,GCancellable *cancellable
,GError **error
);
Send any local changes to the settings and properties of connection
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.
Parameters
connection |
||
save_to_disk |
whether to persist the changes to disk |
|
cancellable |
a GCancellable, or |
|
error |
nm_remote_connection_commit_changes_async ()
void nm_remote_connection_commit_changes_async (NMRemoteConnection *connection
,gboolean save_to_disk
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously sends any local changes to the settings and properties of
connection
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.
Parameters
connection |
||
save_to_disk |
whether to save the changes to persistent storage |
|
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the commit operation completes |
|
user_data |
caller-specific data passed to |
nm_remote_connection_commit_changes_finish ()
gboolean nm_remote_connection_commit_changes_finish (NMRemoteConnection *connection
,GAsyncResult *result
,GError **error
);
Gets the result of a call to nm_remote_connection_commit_changes_async()
.
nm_remote_connection_save ()
gboolean nm_remote_connection_save (NMRemoteConnection *connection
,GCancellable *cancellable
,GError **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.
nm_remote_connection_save_async ()
void nm_remote_connection_save_async (NMRemoteConnection *connection
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
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.
Parameters
connection |
||
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the save operation completes |
|
user_data |
caller-specific data passed to |
nm_remote_connection_save_finish ()
gboolean nm_remote_connection_save_finish (NMRemoteConnection *connection
,GAsyncResult *result
,GError **error
);
Gets the result of a call to nm_remote_connection_save_async()
.
nm_remote_connection_delete ()
gboolean nm_remote_connection_delete (NMRemoteConnection *connection
,GCancellable *cancellable
,GError **error
);
Deletes the connection.
nm_remote_connection_delete_async ()
void nm_remote_connection_delete_async (NMRemoteConnection *connection
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously deletes the connection.
Parameters
connection |
||
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the delete operation completes |
|
user_data |
caller-specific data passed to |
nm_remote_connection_delete_finish ()
gboolean nm_remote_connection_delete_finish (NMRemoteConnection *connection
,GAsyncResult *result
,GError **error
);
Gets the result of a call to nm_remote_connection_delete_async()
.
nm_remote_connection_get_secrets ()
GVariant * nm_remote_connection_get_secrets (NMRemoteConnection *connection
,const char *setting_name
,GCancellable *cancellable
,GError **error
);
Request the connection's secrets. Note that this is a blocking D-Bus call, not a simple property accessor.
Parameters
connection |
||
setting_name |
the NMSetting object name to get secrets for |
|
cancellable |
a GCancellable, or |
|
error |
nm_remote_connection_get_secrets_async ()
void nm_remote_connection_get_secrets_async (NMRemoteConnection *connection
,const char *setting_name
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously requests the connection's secrets.
Parameters
connection |
||
setting_name |
the NMSetting object name to get secrets for |
|
cancellable |
a GCancellable, or |
|
callback |
callback to be called when the secret request completes |
|
user_data |
caller-specific data passed to |
nm_remote_connection_get_secrets_finish ()
GVariant * nm_remote_connection_get_secrets_finish (NMRemoteConnection *connection
,GAsyncResult *result
,GError **error
);
Gets the result of a call to nm_remote_connection_get_secrets_async()
.
nm_remote_connection_get_unsaved ()
gboolean
nm_remote_connection_get_unsaved (NMRemoteConnection *connection
);
nm_remote_connection_get_visible ()
gboolean
nm_remote_connection_get_visible (NMRemoteConnection *connection
);
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.)
Property Details
The “unsaved”
property
“unsaved” gboolean
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.
Flags: Read
Default value: FALSE
The “visible”
property
“visible” gboolean
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.)
Flags: Read
Default value: FALSE