NMRemoteConnection

NMRemoteConnection

Synopsis

#define             NM_REMOTE_CONNECTION_UPDATED
#define             NM_REMOTE_CONNECTION_REMOVED
                    NMRemoteConnection;
                    NMRemoteConnectionClass;
void                (*NMRemoteConnectionCommitFunc)     (NMRemoteConnection *connection,
                                                         GError *error,
                                                         gpointer user_data);
void                (*NMRemoteConnectionDeleteFunc)     (NMRemoteConnection *connection,
                                                         GError *error,
                                                         gpointer user_data);
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,
                                                         NMRemoteConnectionCommitFunc callback,
                                                         gpointer user_data);
void                nm_remote_connection_delete         (NMRemoteConnection *connection,
                                                         NMRemoteConnectionDeleteFunc callback,
                                                         gpointer user_data);
void                nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
                                                         const char *setting_name,
                                                         NMRemoteConnectionGetSecretsFunc callback,
                                                         gpointer user_data);

Description

Details

NM_REMOTE_CONNECTION_UPDATED

#define NM_REMOTE_CONNECTION_UPDATED         "updated"


NM_REMOTE_CONNECTION_REMOVED

#define NM_REMOTE_CONNECTION_REMOVED         "removed"


NMRemoteConnection

typedef struct {
	NMConnection parent;
} NMRemoteConnection;


NMRemoteConnectionClass

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;


NMRemoteConnectionCommitFunc ()

void                (*NMRemoteConnectionCommitFunc)     (NMRemoteConnection *connection,
                                                         GError *error,
                                                         gpointer user_data);


NMRemoteConnectionDeleteFunc ()

void                (*NMRemoteConnectionDeleteFunc)     (NMRemoteConnection *connection,
                                                         GError *error,
                                                         gpointer user_data);


NMRemoteConnectionGetSecretsFunc ()

void                (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection,
                                                         GHashTable *secrets,
                                                         GError *error,
                                                         gpointer user_data);


nm_remote_connection_new ()

NMRemoteConnection * nm_remote_connection_new           (DBusGConnection *bus,
                                                         const char *path);

Creates a new object representing the remote connection.

bus :

a valid and connected D-Bus connection

path :

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

nm_remote_connection_commit_changes ()

void                nm_remote_connection_commit_changes (NMRemoteConnection *connection,
                                                         NMRemoteConnectionCommitFunc callback,
                                                         gpointer user_data);

Save any local changes to the settings and properties of this connection and save them in the settings service.

connection :

the NMRemoteConnection

callback :

a function to be called when the commit completes. [scope async]

user_data :

caller-specific data to be passed to callback

nm_remote_connection_delete ()

void                nm_remote_connection_delete         (NMRemoteConnection *connection,
                                                         NMRemoteConnectionDeleteFunc callback,
                                                         gpointer user_data);

Delete the connection.

connection :

the NMRemoteConnection

callback :

a function to be called when the delete completes. [scope async][allow-none]

user_data :

caller-specific data to be passed to callback

nm_remote_connection_get_secrets ()

void                nm_remote_connection_get_secrets    (NMRemoteConnection *connection,
                                                         const char *setting_name,
                                                         NMRemoteConnectionGetSecretsFunc callback,
                                                         gpointer user_data);

Request the connection's secrets.

connection :

the NMRemoteConnection

setting_name :

the NMSetting object name to get secrets for

callback :

a function to be called when the update completes. [scope async]

user_data :

caller-specific data to be passed to callback