| libnm-glib Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
enum NMRemoteConnectionError; #define NM_REMOTE_CONNECTION_ERROR GQuark nm_remote_connection_error_quark (void); #define NM_REMOTE_CONNECTION_UNSAVED #define NM_REMOTE_CONNECTION_UPDATED #define NM_REMOTE_CONNECTION_REMOVED NMRemoteConnection; NMRemoteConnectionClass; void (*NMRemoteConnectionResultFunc) (NMRemoteConnection *connection,GError *error,gpointer user_data); typedef NMRemoteConnectionCommitFunc; typedef NMRemoteConnectionDeleteFunc; void (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,GHashTable *secrets,GError *error,gpointer user_data); NMRemoteConnection * nm_remote_connection_new (DBusGConnection *bus,const char *path); void nm_remote_connection_commit_changes (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data); void nm_remote_connection_commit_changes_unsaved (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data); void nm_remote_connection_save (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data); void nm_remote_connection_delete (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data); void nm_remote_connection_get_secrets (NMRemoteConnection *connection,const char *setting_name,NMRemoteConnectionGetSecretsFunc callback,gpointer user_data); gboolean nm_remote_connection_get_unsaved (NMRemoteConnection *connection);
"bus" DBusGConnection* : Write / Construct Only "dbus-connection" DBusGConnection* : Write / Construct Only "dbus-path" gchar* : Write / Construct Only "unsaved" gboolean : Read
typedef enum {
NM_REMOTE_CONNECTION_ERROR_UNKNOWN = 0, /*< nick=UnknownError >*/
NM_REMOTE_CONNECTION_ERROR_DISCONNECTED, /*< nick=Disconnected >*/
} NMRemoteConnectionError;
GQuark nm_remote_connection_error_quark (void);
Registers an error quark for NMRemoteConnection if necessary.
Returns : |
the error quark used for NMRemoteConnection errors. |
typedef struct {
NMConnectionClass parent_class;
/* Signals */
void (*updated) (NMRemoteConnection *connection,
GHashTable *new_settings);
void (*removed) (NMRemoteConnection *connection);
/* Padding for future expansion */
void (*_reserved1) (void);
void (*_reserved2) (void);
void (*_reserved3) (void);
void (*_reserved4) (void);
void (*_reserved5) (void);
void (*_reserved6) (void);
} NMRemoteConnectionClass;
void (*NMRemoteConnectionResultFunc) (NMRemoteConnection *connection,GError *error,gpointer user_data);
Called when NetworkManager has finished an asynchronous operation on a connection, like commit changes, deleting, saving, etc.
|
the connection for which an operation was performed |
|
on failure, a descriptive error |
|
user data passed to function which began the operation |
void (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,GHashTable *secrets,GError *error,gpointer user_data);
Called when NetworkManager returns secrets in response to a request for
secrets via nm_remote_connection_get_secrets().
|
the connection for which secrets were requested |
|
on success, a hash table of hash tables, with each inner hash mapping a setting property to a GValue containing that property's value. [element-type utf8 GLib.HashTable] |
|
on failure, a descriptive error |
|
user data passed to nm_remote_connection_get_secrets()
|
NMRemoteConnection * nm_remote_connection_new (DBusGConnection *bus,const char *path);
Creates a new object representing the remote connection.
|
a valid and connected D-Bus connection |
|
the D-Bus path of the connection as exported by the settings service |
Returns : |
the new remote connection object on success, or NULL on failure |
void nm_remote_connection_commit_changes (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data);
Send any local changes to the settings and properties of this connection to NetworkManager, which will immediately save them to disk.
|
the NMRemoteConnection |
|
a function to be called when the commit completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback. [closure]
|
void nm_remote_connection_commit_changes_unsaved (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data);
Send any local changes to the settings and properties of this connection to
NetworkManager. The changes are not saved to disk until either
nm_remote_connection_save() or nm_remote_connection_commit_changes() is
called.
|
the NMRemoteConnection |
|
a function to be called when the commit completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback. [closure]
|
Since 0.9.10
void nm_remote_connection_save (NMRemoteConnection *connection,NMRemoteConnectionResultFunc 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.
|
the NMRemoteConnection |
|
a function to be called when the save completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback. [closure]
|
Since 0.9.10
void nm_remote_connection_delete (NMRemoteConnection *connection,NMRemoteConnectionResultFunc callback,gpointer user_data);
Delete the connection.
|
the NMRemoteConnection |
|
a function to be called when the delete completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback. [closure]
|
void nm_remote_connection_get_secrets (NMRemoteConnection *connection,const char *setting_name,NMRemoteConnectionGetSecretsFunc callback,gpointer user_data);
Request the connection's secrets.
|
the NMRemoteConnection |
|
the NMSetting object name to get secrets for |
|
a function to be called when the update completes;
must not be NULL. [scope async]
|
|
caller-specific data to be passed to callback. [closure]
|
gboolean nm_remote_connection_get_unsaved (NMRemoteConnection *connection);
|
the NMRemoteConnection |
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. |
Since 0.9.10
"bus" property"bus" DBusGConnection* : Write / Construct Only
The DBusGConnection that the NMRemoteConnection is connected to.
"removed" signalvoid user_function (NMRemoteConnection *connection,
gpointer user_data) : Run First
This signal is emitted when a connection is either deleted or becomes invisible to the current user.
|
a NMConnection |
|
user data set when the signal handler was connected. |
"updated" signalvoid user_function (NMRemoteConnection *connection,
gpointer user_data) : Run First
This signal is emitted when a connection changes, and it is still visible to the user.
|
a NMConnection |
|
user data set when the signal handler was connected. |
"visible" signalvoid user_function (NMRemoteConnection *nmremoteconnection,
gboolean arg1,
gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |