From 7514efc2f38c9ace4557d4e69d68e7d380389030 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Fri, 26 Aug 2016 02:18:32 +0200 Subject: Imported Upstream version 1.4.0 --- docs/libnm-glib/html/NMRemoteSettings.html | 80 +++++++++++++++--------------- 1 file changed, 40 insertions(+), 40 deletions(-) (limited to 'docs/libnm-glib/html/NMRemoteSettings.html') diff --git a/docs/libnm-glib/html/NMRemoteSettings.html b/docs/libnm-glib/html/NMRemoteSettings.html index 0e1a4139..ef5bff8c 100644 --- a/docs/libnm-glib/html/NMRemoteSettings.html +++ b/docs/libnm-glib/html/NMRemoteSettings.html @@ -8,7 +8,7 @@ - + @@ -284,13 +284,13 @@ which stores network configuration and allows authenticated clients to add, delete, and modify that configuration. The data required to connect to a specific network is called a "connection" and encapsulated by the -NMConnection object. Once a connection is known to NetworkManager, having +NMConnection object. Once a connection is known to NetworkManager, having either been added by a user or read from on-disk storage, the NMRemoteSettings object creates a NMRemoteConnection object which represents this stored connection. Use the NMRemoteConnection object to perform any operations like modification or deletion.

To add a new network connection to the NetworkManager settings service, first -build up a template NMConnection object. Since this connection is not yet +build up a template NMConnection object. Since this connection is not yet added to NetworkManager, it is known only to your program and is not yet an NMRemoteConnection. Then ask NMRemoteSettings to add your connection. When the connection is added successfully, the supplied callback is called @@ -377,16 +377,16 @@ the stored object known to NetworkManager.

static gboolean add_wired_connection (const char *human_name) { - NMConnection *connection; + NMConnection *connection; NMSettingConnection *s_con; NMSettingWired *s_wired; char *uuid; gboolean success; - connection = nm_connection_new (); + connection = nm_connection_new (); /* Build up the 'connection' setting */ - s_con = (NMSettingConnection *) nm_setting_connection_new (); + s_con = (NMSettingConnection *) nm_setting_connection_new (); uuid = nm_utils_uuid_generate (); g_object_set (G_OBJECT (s_con), NM_SETTING_CONNECTION_UUID, uuid, @@ -394,24 +394,24 @@ the stored object known to NetworkManager.

NM_SETTING_CONNECTION_TYPE, NM_SETTING_WIRED_SETTING_NAME, NULL); g_free (uuid); - nm_connection_add_setting (connection, NM_SETTING (s_con)); + nm_connection_add_setting (connection, NM_SETTING (s_con)); /* Add the required 'wired' setting as this is a wired connection */ - nm_connection_add_setting (connection, nm_setting_wired_new ()); + nm_connection_add_setting (connection, nm_setting_wired_new ()); /* Add an 'ipv4' setting using AUTO configuration (eg DHCP) */ - s_ip4 = (NMSettingIP4Config *) nm_setting_ip4_config_new (); + s_ip4 = (NMSettingIP4Config *) nm_setting_ip4_config_new (); g_object_set (G_OBJECT (s_ip4), NM_SETTING_IP4_CONFIG_METHOD, NM_SETTING_IP4_CONFIG_METHOD_AUTO, NULL); - nm_connection_add_setting (connection, NM_SETTING (s_ip4)); + nm_connection_add_setting (connection, NM_SETTING (s_ip4)); /* Ask NetworkManager to store the connection */ - success = nm_remote_settings_add_connection (settings, connection, added_cb, loop); + success = nm_remote_settings_add_connection (settings, connection, added_cb, loop); /* Release the template connection; the actual stored connection will * be returned in added_cb() */ - g_object_unref (connection); + g_object_unref (connection); /* Let glib event loop run and added_cb() will be called when NetworkManager * is done adding the new connection. */ @@ -433,7 +433,7 @@ the stored object known to NetworkManager.

nm_remote_settings_error_quark (void);

Registers an error quark for NMRemoteSettings if necessary.

-

Returns

+

Returns

the error quark used for NMRemoteSettings errors.

@@ -474,7 +474,7 @@ nm_remote_settings_new (nm_remote_settings_new_async() if you want to avoid that.

-

Parameters

+

Parameters

@@ -489,7 +489,7 @@ want to avoid that.

-

Returns

+

Returns

the new remote settings object on success, or NULL on failure

@@ -507,7 +507,7 @@ begins asynchronously initializing it. callbacknm_remote_settings_new_finish() to get the result.

-

Parameters

+

Parameters

@@ -548,7 +548,7 @@ nm_remote_settings_new_finish (GA GError **error);

Gets the result of an nm_remote_settings_new_async() call.

-

Parameters

+

Parameters

@@ -570,7 +570,7 @@ nm_remote_settings_new_finish (GA
-

Returns

+

Returns

a new NMRemoteSettings object, or NULL on error

@@ -580,7 +580,7 @@ nm_remote_settings_new_finish (GA
GSList *
 nm_remote_settings_list_connections (NMRemoteSettings *settings);
-

Parameters

+

Parameters

@@ -595,7 +595,7 @@ nm_remote_settings_list_connections (
-

Returns

+

Returns

a list containing all connections provided by the remote settings service. Each element of the returned list is a NMRemoteConnection instance, which is @@ -615,7 +615,7 @@ nm_remote_settings_get_connection_by_id

Returns the first matching NMRemoteConnection matching a given id .

-

Parameters

+

Parameters

@@ -637,7 +637,7 @@ nm_remote_settings_get_connection_by_id
-

Returns

+

Returns

the remote connection object on success, or NULL if no matching object was found.

[transfer none]

@@ -654,7 +654,7 @@ nm_remote_settings_get_connection_by_path

Returns the NMRemoteConnection representing the connection at path .

-

Parameters

+

Parameters

@@ -676,7 +676,7 @@ nm_remote_settings_get_connection_by_path
-

Returns

+

Returns

the remote connection object on success, or NULL if the object was not known.

[transfer none]

@@ -692,7 +692,7 @@ nm_remote_settings_get_connection_by_uuid

Returns the NMRemoteConnection identified by uuid .

-

Parameters

+

Parameters

@@ -714,7 +714,7 @@ nm_remote_settings_get_connection_by_uuid
-

Returns

+

Returns

the remote connection object on success, or NULL if the object was not known.

[transfer none]

@@ -725,7 +725,7 @@ not known.

nm_remote_settings_add_connection ()

gboolean
 nm_remote_settings_add_connection (NMRemoteSettings *settings,
-                                   NMConnection *connection,
+                                   NMConnection *connection,
                                    NMRemoteSettingsAddConnectionFunc callback,
                                    gpointer user_data);

Requests that the remote settings service add the given settings to a new @@ -741,7 +741,7 @@ identical settings to connection as NetworkManager may perform automatic completion and/or normalization of connection properties.

-

Parameters

+

Parameters

@@ -775,7 +775,7 @@ added, not the object itself

-

Returns

+

Returns

TRUE if the request was successful, FALSE if it failed

@@ -785,7 +785,7 @@ added, not the object itself

gboolean
 nm_remote_settings_add_connection_unsaved
                                (NMRemoteSettings *settings,
-                                NMConnection *connection,
+                                NMConnection *connection,
                                 NMRemoteSettingsAddConnectionFunc callback,
                                 gpointer user_data);

Requests that the remote settings service add the given settings to a new @@ -793,7 +793,7 @@ connection. The connection is not written to disk, which may be done at a later time by calling the connection's nm_remote_connection_commit_changes() method.

-

Parameters

+

Parameters

@@ -827,7 +827,7 @@ added, not the object itself

-

Returns

+

Returns

TRUE if the request was successful, FALSE if it failed

Since: 0.9.10

@@ -853,7 +853,7 @@ then failures will be set to a NULL-terminated array of the filenames that failed to load.

-

Parameters

+

Parameters

@@ -886,7 +886,7 @@ filenames that failed to load.

-

Returns

+

Returns

TRUE if NetworkManager at least tried to load filenames , FALSE if an error occurred (eg, permission denied).

@@ -903,7 +903,7 @@ nm_remote_settings_reload_connections ( -

Parameters

+

Parameters

@@ -925,7 +925,7 @@ the in-memory state matches the on-disk state.

-

Returns

+

Returns

TRUE on success, FALSE on failure

Since: 0.9.10

@@ -941,7 +941,7 @@ nm_remote_settings_save_hostname (Requests that the machine's persistent hostname be set to the specified value or cleared.

-

Parameters

+

Parameters

@@ -976,7 +976,7 @@ hostname operation completes.

-

Returns

+

Returns

TRUE if the request was successful, FALSE if it failed

@@ -987,7 +987,7 @@ hostname operation completes.

enum NMRemoteSettingsError

Describes errors that may result from operations involving a NMRemoteSettings.