|  |  |  | libnm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
struct NMRemoteSettings; void (*NMRemoteSettingsAddConnectionFunc) (NMRemoteSettings *settings,NMRemoteConnection *connection,GError *error,gpointer user_data); struct NMRemoteSettingsClass; enum NMRemoteSettingsError; void (*NMRemoteSettingsSaveHostnameFunc) (NMRemoteSettings *settings,GError *error,gpointer user_data); #define NM_REMOTE_SETTINGS_BUS #define NM_REMOTE_SETTINGS_CAN_MODIFY #define NM_REMOTE_SETTINGS_CONNECTIONS_READ #define NM_REMOTE_SETTINGS_ERROR #define NM_REMOTE_SETTINGS_HOSTNAME #define NM_REMOTE_SETTINGS_NEW_CONNECTION #define NM_REMOTE_SETTINGS_SERVICE_RUNNING gboolean nm_remote_settings_add_connection (NMRemoteSettings *settings,NMConnection *connection,NMRemoteSettingsAddConnectionFunc callback,gpointer user_data); GQuark nm_remote_settings_error_quark (void); NMRemoteConnection * nm_remote_settings_get_connection_by_path (NMRemoteSettings *settings,const char *path); NMRemoteConnection * nm_remote_settings_get_connection_by_uuid (NMRemoteSettings *settings,const char *uuid); GSList * nm_remote_settings_list_connections (NMRemoteSettings *settings); NMRemoteSettings * nm_remote_settings_new (DBusGConnection *bus); void nm_remote_settings_new_async (DBusGConnection *bus,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); NMRemoteSettings * nm_remote_settings_new_finish (GAsyncResult *result,GError **error); gboolean nm_remote_settings_save_hostname (NMRemoteSettings *settings,const char *hostname,NMRemoteSettingsSaveHostnameFunc callback,gpointer user_data);
"bus" DBusGConnection* : Read / Write / Construct Only "can-modify" gboolean : Read "hostname" gchar* : Read "service-running" gboolean : Read
void (*NMRemoteSettingsAddConnectionFunc) (NMRemoteSettings *settings,NMRemoteConnection *connection,GError *error,gpointer user_data);
struct NMRemoteSettingsClass {
	GObjectClass parent;
	/* Signals */
	void (*new_connection) (NMRemoteSettings *settings,
	                        NMRemoteConnection *connection);
	void (*connections_read) (NMRemoteSettings *settings);
	/* Padding for future expansion */
	void (*_reserved1) (void);
	void (*_reserved2) (void);
	void (*_reserved3) (void);
	void (*_reserved4) (void);
	void (*_reserved5) (void);
	void (*_reserved6) (void);
};
typedef enum {
	NM_REMOTE_SETTINGS_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
	NM_REMOTE_SETTINGS_ERROR_CONNECTION_REMOVED,     /*< nick=ConnectionRemoved >*/
	NM_REMOTE_SETTINGS_ERROR_CONNECTION_UNAVAILABLE, /*< nick=ConnectionUnavailable >*/
} NMRemoteSettingsError;
Describes errors that may result from operations involving a NMRemoteSettings.
| unknown or unclassified error | |
| the NMRemoteConnection object was removed before it was completely initialized | |
| the NMRemoteConnection object is not visible or otherwise unreadable | 
void (*NMRemoteSettingsSaveHostnameFunc) (NMRemoteSettings *settings,GError *error,gpointer user_data);
gboolean nm_remote_settings_add_connection (NMRemoteSettings *settings,NMConnection *connection,NMRemoteSettingsAddConnectionFunc callback,gpointer user_data);
Requests that the remote settings service add the given settings to a new connection.
| 
 | the NMRemoteSettings | 
| 
 | the connection to add. Note that this object's settings will be added, not the object itself | 
| 
 | callback to be called when the add operation completes. [scope async] | 
| 
 | caller-specific data passed to callback. [closure] | 
| Returns : | TRUE if the request was successful, FALSE if it failed | 
GQuark              nm_remote_settings_error_quark      (void);
Registers an error quark for NMRemoteSettings if necessary.
| Returns : | the error quark used for NMRemoteSettings errors. | 
NMRemoteConnection * nm_remote_settings_get_connection_by_path (NMRemoteSettings *settings,const char *path);
Returns the NMRemoteConnection representing the connection at path.
| 
 | the NMRemoteSettings | 
| 
 | the D-Bus object path of the remote connection | 
| Returns : | the remote connection object on success, or NULL if the object was not known. [transfer none] | 
NMRemoteConnection * nm_remote_settings_get_connection_by_uuid (NMRemoteSettings *settings,const char *uuid);
Returns the NMRemoteConnection identified by uuid.
| 
 | the NMRemoteSettings | 
| 
 | the UUID of the remote connection | 
| Returns : | the remote connection object on success, or NULL if the object was not known. [transfer none] | 
GSList *            nm_remote_settings_list_connections (NMRemoteSettings *settings);
| 
 | the NMRemoteSettings | 
| Returns : | a
list containing all connections provided by the remote settings service.
Each element of the returned list is a NMRemoteConnectioninstance, which is
owned by theNMRemoteSettingsobject and should not be freed by the caller.
The returned list is, however, owned by the caller and should be freed
usingg_slist_free()when no longer required. [transfer container][element-type NMClient.RemoteConnection] | 
NMRemoteSettings *  nm_remote_settings_new              (DBusGConnection *bus);
Creates a new object representing the remote settings service.
Note that this will do blocking D-Bus calls to initialize the
settings object. You can use nm_remote_settings_new_async() if you
want to avoid that.
| 
 | a valid and connected D-Bus connection. [allow-none] | 
| Returns : | the new remote settings object on success, or NULLon failure | 
void nm_remote_settings_new_async (DBusGConnection *bus,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Creates a new object representing the remote settings service and
begins asynchronously initializing it. callback will be called
when it is done; use nm_remote_settings_new_finish() to get the
result.
| 
 | a valid and connected D-Bus connection. [allow-none] | 
| 
 | a GCancellable, or NULL | 
| 
 | callback to call when the settings object is created | 
| 
 | data for callback | 
NMRemoteSettings * nm_remote_settings_new_finish (GAsyncResult *result,GError **error);
Gets the result of an nm_remote_settings_new_async() call.
| 
 | a GAsyncResult | 
| 
 | location for a GError, or NULL | 
| Returns : | a new NMRemoteSettings object, or NULLon error | 
gboolean nm_remote_settings_save_hostname (NMRemoteSettings *settings,const char *hostname,NMRemoteSettingsSaveHostnameFunc callback,gpointer user_data);
Requests that the machine's persistent hostname be set to the specified value or cleared.
| 
 | the NMRemoteSettings | 
| 
 | the new persistent hostname to set, or NULL to clear any existing persistent hostname | 
| 
 | callback to be called when the hostname operation completes. [scope async][allow-none] | 
| 
 | caller-specific data passed to callback. [closure] | 
| Returns : | TRUE if the request was successful, FALSE if it failed | 
"can-modify" property"can-modify" gboolean : Read
Can modify anything (hostname, connections, etc).
Default value: FALSE
"service-running" property"service-running" gboolean : Read
Is service running.
Default value: FALSE
"connections-read" signalvoid                user_function                      (NMRemoteSettings *nmremotesettings,
                                                        gpointer          user_data)             : Run First
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"new-connection" signalvoid                user_function                      (NMRemoteSettings *nmremotesettings,
                                                        GObject          *arg1,
                                                        gpointer          user_data)             : Run First
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. |