![]() |
![]() |
![]() |
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 NMRemoteConnection instance, which is
owned by the NMRemoteSettings object and should not be freed by the caller.
The returned list is, however, owned by the caller and should be freed
using g_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 NULL on 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 NULL on 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. |