From d9c99a29a0d3384c9c3d2adce430f5cb1134ab6a Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Wed, 30 Mar 2016 00:56:30 +0200 Subject: Imported Upstream version 1.1.92 --- docs/libnm/html/NMClient.html | 578 +++++++++++++++++++++--------------------- 1 file changed, 293 insertions(+), 285 deletions(-) (limited to 'docs/libnm/html/NMClient.html') diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 2be7c5e8..1e51c552 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -44,7 +44,7 @@ -GQuark +GQuark nm_client_error_quark () @@ -91,7 +91,7 @@ -gboolean +gboolean nm_client_get_startup () @@ -99,7 +99,7 @@ -gboolean +gboolean nm_client_get_nm_running () @@ -107,7 +107,7 @@ -gboolean +gboolean nm_client_networking_get_enabled () @@ -115,7 +115,7 @@ -gboolean +gboolean nm_client_networking_set_enabled () @@ -123,7 +123,7 @@ -gboolean +gboolean nm_client_wireless_get_enabled () @@ -139,7 +139,7 @@ -gboolean +gboolean nm_client_wireless_hardware_get_enabled () @@ -147,7 +147,7 @@ -gboolean +gboolean nm_client_wwan_get_enabled () @@ -163,7 +163,7 @@ -gboolean +gboolean nm_client_wwan_hardware_get_enabled () @@ -171,7 +171,7 @@ -gboolean +gboolean nm_client_wimax_get_enabled () @@ -187,7 +187,7 @@ -gboolean +gboolean nm_client_wimax_hardware_get_enabled () @@ -195,7 +195,7 @@ -gboolean +gboolean nm_client_get_logging () @@ -203,7 +203,7 @@ -gboolean +gboolean nm_client_set_logging () @@ -251,7 +251,7 @@ -gboolean +gboolean nm_client_save_hostname () @@ -267,21 +267,21 @@ -gboolean +gboolean nm_client_save_hostname_finish () -const GPtrArray * +const GPtrArray * nm_client_get_devices () -const GPtrArray * +const GPtrArray * nm_client_get_all_devices () @@ -304,7 +304,7 @@ -const GPtrArray * +const GPtrArray * nm_client_get_active_connections () @@ -360,7 +360,7 @@ -gboolean +gboolean nm_client_deactivate_connection () @@ -376,14 +376,14 @@ -gboolean +gboolean nm_client_deactivate_connection_finish () -const GPtrArray * +const GPtrArray * nm_client_get_connections () @@ -431,7 +431,7 @@ -gboolean +gboolean nm_client_load_connections () @@ -447,7 +447,7 @@ -gboolean +gboolean nm_client_load_connections_finish () @@ -455,7 +455,7 @@ -gboolean +gboolean nm_client_reload_connections () @@ -471,7 +471,7 @@ -gboolean +gboolean nm_client_reload_connections_finish () @@ -497,24 +497,24 @@ -GPtrArray * +GPtrArray * active-connections Read -GPtrArray * +GPtrArray * all-devices Read -gboolean +gboolean can-modify Read -GPtrArray * +GPtrArray * connections Read @@ -525,28 +525,28 @@ -GPtrArray * +GPtrArray * devices Read -gchar * +gchar * hostname Read -guint +guint metered Read -gboolean +gboolean networking-enabled Read / Write -gboolean +gboolean nm-running Read @@ -557,7 +557,7 @@ Read -gboolean +gboolean startup Read @@ -568,37 +568,37 @@ -gchar * +gchar * version Read -gboolean +gboolean wimax-enabled Read / Write -gboolean +gboolean wimax-hardware-enabled Read -gboolean +gboolean wireless-enabled Read / Write -gboolean +gboolean wireless-hardware-enabled Read -gboolean +gboolean wwan-enabled Read / Write -gboolean +gboolean wwan-hardware-enabled Read @@ -617,37 +617,37 @@ void any-device-added -Run First +Run First void any-device-removed -Run First +Run First void connection-added -Run First +Run First void connection-removed -Run First +Run First void device-added -Run First +Run First void device-removed -Run First +Run First void permission-changed -Run First +Run First @@ -793,11 +793,11 @@

Object Hierarchy

-
    GEnum
+
    GEnum
     ├── NMClientError
     ├── NMClientPermission
     ╰── NMClientPermissionResult
-    GObject
+    GObject
     ╰── NMClient
@@ -808,7 +808,7 @@

Functions

nm_client_error_quark ()

-
GQuark
+
GQuark
 nm_client_error_quark (void);

 
Registers an error quark for NMClient if necessary.

 

@@ -820,8 +820,8 @@ nm_client_error_quark (void
 
nm_client_new ()

 
NMClient *
-nm_client_new (GCancellable *cancellable,
-               GError **error);

+nm_client_new (GCancellable *cancellable,
+               GError **error);

Creates a new NMClient.

Note that this will do blocking D-Bus calls to initialize the client. You can use nm_client_new_async() if you want to avoid @@ -837,12 +837,12 @@ that.

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

 

error

-

location for a GError, or NULL

+

location for a GError, or NULL

  @@ -857,9 +857,9 @@ that.

nm_client_new_async ()

void
-nm_client_new_async (GCancellable *cancellable,
-                     GAsyncReadyCallback callback,
-                     gpointer user_data);
+nm_client_new_async (GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Creates a new NMClient and begins asynchronously initializing it. callback will be called when it is done; use @@ -876,7 +876,7 @@ the callback can be invoked with two first parameters as NULL.

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

  @@ -898,8 +898,8 @@ the callback can be invoked with two first parameters as NULL.

nm_client_new_finish ()

NMClient *
-nm_client_new_finish (GAsyncResult *result,
-                      GError **error);
+nm_client_new_finish (GAsyncResult *result, + GError **error);

Gets the result of an nm_client_new_async() call.

Parameters

@@ -912,12 +912,12 @@ nm_client_new_finish (

result

-

a GAsyncResult

+

a GAsyncResult

 

error

-

location for a GError, or NULL

+

location for a GError, or NULL

  @@ -925,7 +925,7 @@ nm_client_new_finish (

Returns

-

a new NMClient, or NULL on error

+

a new NMClient, or NULL on error

@@ -951,7 +951,7 @@ nm_client_get_version (

Returns

-

string with the version (or NULL if NetworkManager is not running)

+

string with the version (or NULL if NetworkManager is not running)

@@ -983,7 +983,7 @@ nm_client_get_state (

nm_client_get_startup ()

-
gboolean
+
gboolean
 nm_client_get_startup (NMClient *client);

 
Tests whether the daemon is still in the process of activating
 connections at startup.

@@ -1010,7 +1010,7 @@ connections at startup.

 

 

 
nm_client_get_nm_running ()

-
gboolean
+
gboolean
 nm_client_get_nm_running (NMClient *client);

 
Determines whether the daemon is running.

 

@@ -1030,13 +1030,13 @@ nm_client_get_nm_running (
 
Returns

-
 TRUE if the daemon is running

+
 TRUE if the daemon is running

 

 

 

 

 
nm_client_networking_get_enabled ()

-
gboolean
+
gboolean
 nm_client_networking_get_enabled (NMClient *client);

 
Whether networking is enabled or disabled.

 

@@ -1056,16 +1056,16 @@ nm_client_networking_get_enabled (
 

 
Returns

-
 TRUE if networking is enabled, FALSE if networking is disabled

+
 TRUE if networking is enabled, FALSE if networking is disabled

 

 

 

 

 
nm_client_networking_set_enabled ()

-
gboolean
+
gboolean
 nm_client_networking_set_enabled (NMClient *client,
-                                  gboolean enabled,
-                                  GError **error);

+                                  gboolean enabled,
+                                  GError **error);

 
Enables or disables networking.  When networking is disabled, all controlled
 interfaces are disconnected and deactivated.  When networking is enabled,
 all controlled interfaces are available for activation.

@@ -1085,12 +1085,12 @@ all controlled interfaces are available for activation.

 
 
 
enabled

-
TRUE to set networking enabled, FALSE to set networking disabled

+
TRUE to set networking enabled, FALSE to set networking disabled

  
 
 
 
error

-
 return location for a GError, or NULL. 

+
 return location for a GError, or NULL. 

 [allow-none]
 
 
@@ -1098,13 +1098,13 @@ all controlled interfaces are available for activation.

 

 

 
Returns

-
 TRUE on success, FALSE otherwise

+
 TRUE on success, FALSE otherwise

 

 

 

 

 
nm_client_wireless_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wireless_get_enabled (NMClient *client);

 
Determines whether the wireless is enabled.

 

@@ -1124,7 +1124,7 @@ nm_client_wireless_get_enabled (
 

 
Returns

-
 TRUE if wireless is enabled

+
 TRUE if wireless is enabled

 

 

 

@@ -1132,7 +1132,7 @@ nm_client_wireless_get_enabled (
nm_client_wireless_set_enabled ()

 
void
 nm_client_wireless_set_enabled (NMClient *client,
-                                gboolean enabled);

+                                gboolean enabled);

 
Enables or disables wireless devices.

 

 
Parameters

@@ -1150,7 +1150,7 @@ nm_client_wireless_set_enabled (
 
 
enabled

-
TRUE to enable wireless

+
TRUE to enable wireless

  
 
 
@@ -1160,7 +1160,7 @@ nm_client_wireless_set_enabled (
 

 
nm_client_wireless_hardware_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wireless_hardware_get_enabled
                                (NMClient *client);

 
Determines whether the wireless hardware is enabled.

@@ -1181,13 +1181,13 @@ nm_client_wireless_hardware_get_enabled
 

 

 
Returns

-
 TRUE if the wireless hardware is enabled

+
 TRUE if the wireless hardware is enabled

 

 

 

 

 
nm_client_wwan_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wwan_get_enabled (NMClient *client);

 
Determines whether WWAN is enabled.

 

@@ -1207,7 +1207,7 @@ nm_client_wwan_get_enabled (
 
Returns

-
 TRUE if WWAN is enabled

+
 TRUE if WWAN is enabled

 

 

 

@@ -1215,7 +1215,7 @@ nm_client_wwan_get_enabled (
nm_client_wwan_set_enabled ()

 
void
 nm_client_wwan_set_enabled (NMClient *client,
-                            gboolean enabled);

+                            gboolean enabled);

Enables or disables WWAN devices.

Parameters

@@ -1233,7 +1233,7 @@ nm_client_wwan_set_enabled (

enabled

-

TRUE to enable WWAN

+

TRUE to enable WWAN

  @@ -1243,7 +1243,7 @@ nm_client_wwan_set_enabled (

nm_client_wwan_hardware_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wwan_hardware_get_enabled (NMClient *client);

 
Determines whether the WWAN hardware is enabled.

 

@@ -1263,13 +1263,13 @@ nm_client_wwan_hardware_get_enabled (
 

 
Returns

-
 TRUE if the WWAN hardware is enabled

+
 TRUE if the WWAN hardware is enabled

 

 

 

 

 
nm_client_wimax_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wimax_get_enabled (NMClient *client);

 
Determines whether WiMAX is enabled.

 

@@ -1289,7 +1289,7 @@ nm_client_wimax_get_enabled (
 
Returns

-
 TRUE if WiMAX is enabled

+
 TRUE if WiMAX is enabled

 

 

 

@@ -1297,7 +1297,7 @@ nm_client_wimax_get_enabled (
nm_client_wimax_set_enabled ()

 
void
 nm_client_wimax_set_enabled (NMClient *client,
-                             gboolean enabled);

+                             gboolean enabled);

Enables or disables WiMAX devices.

Parameters

@@ -1315,7 +1315,7 @@ nm_client_wimax_set_enabled (

enabled

-

TRUE to enable WiMAX

+

TRUE to enable WiMAX

  @@ -1325,7 +1325,7 @@ nm_client_wimax_set_enabled (

nm_client_wimax_hardware_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wimax_hardware_get_enabled (NMClient *client);

 
Determines whether the WiMAX hardware is enabled.

 

@@ -1345,17 +1345,17 @@ nm_client_wimax_hardware_get_enabled (
 
Returns

-
 TRUE if the WiMAX hardware is enabled

+
 TRUE if the WiMAX hardware is enabled

nm_client_get_logging ()

-
gboolean
+
gboolean
 nm_client_get_logging (NMClient *client,
                        char **level,
                        char **domains,
-                       GError **error);

+                       GError **error);

Gets NetworkManager current logging level and domains.

Parameters

@@ -1384,7 +1384,7 @@ a list of domains separated by ",".

error

-

return location for a GError, or NULL.

+

return location for a GError, or NULL.

[allow-none] @@ -1392,17 +1392,17 @@ a list of domains separated by ",".

Returns

-

TRUE on success, FALSE otherwise

+

TRUE on success, FALSE otherwise

nm_client_set_logging ()

-
gboolean
+
gboolean
 nm_client_set_logging (NMClient *client,
                        const char *level,
                        const char *domains,
-                       GError **error);

+                       GError **error);

Sets NetworkManager logging level and/or domains.

Parameters

@@ -1420,18 +1420,18 @@ nm_client_set_logging (

level

-

logging level to set (NULL or an empty string for no change).

+

logging level to set (NULL or an empty string for no change).

[allow-none]

domains

logging domains to set. The string should be a list of log -domains separated by ",". (NULL or an empty string for no change).

+domains separated by ",". (NULL or an empty string for no change).

[allow-none]

error

-

return location for a GError, or NULL.

+

return location for a GError, or NULL.

[allow-none] @@ -1439,7 +1439,7 @@ domains separated by ",". (

Returns

-

TRUE on success, FALSE otherwise

+

TRUE on success, FALSE otherwise

@@ -1511,8 +1511,8 @@ connectivity state first before returning any information.

nm_client_check_connectivity ()

NMConnectivityState
 nm_client_check_connectivity (NMClient *client,
-                              GCancellable *cancellable,
-                              GError **error);
+ GCancellable *cancellable, + GError **error);

Updates the network connectivity state and returns the (new) current state. Contrast nm_client_get_connectivity(), which returns the most recent known state without re-checking.

@@ -1534,12 +1534,12 @@ if you do not want to block.

cancellable

-

a GCancellable

+

a GCancellable

 

error

-

return location for a GError

+

return location for a GError

  @@ -1555,9 +1555,9 @@ if you do not want to block.

nm_client_check_connectivity_async ()

void
 nm_client_check_connectivity_async (NMClient *client,
-                                    GCancellable *cancellable,
-                                    GAsyncReadyCallback callback,
-                                    gpointer user_data);
+ GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously updates the network connectivity state and invokes callback when complete. Contrast nm_client_get_connectivity(), @@ -1579,7 +1579,7 @@ re-checking, and

cancellable

-

a GCancellable

+

a GCancellable

  @@ -1602,8 +1602,8 @@ re-checking, and

nm_client_check_connectivity_finish ()

NMConnectivityState
 nm_client_check_connectivity_finish (NMClient *client,
-                                     GAsyncResult *result,
-                                     GError **error);
+ GAsyncResult *result, + GError **error);

Retrieves the result of an nm_client_check_connectivity_async() call.

@@ -1622,12 +1622,12 @@ call.

result

-

the GAsyncResult

+

the GAsyncResult

 

error

-

return location for a GError

+

return location for a GError

  @@ -1641,11 +1641,11 @@ call.

nm_client_save_hostname ()

-
gboolean
+
gboolean
 nm_client_save_hostname (NMClient *client,
                          const char *hostname,
-                         GCancellable *cancellable,
-                         GError **error);

+                         GCancellable *cancellable,
+                         GError **error);

Requests that the machine's persistent hostname be set to the specified value or cleared.

@@ -1664,18 +1664,18 @@ or cleared.

hostname

-

the new persistent hostname to set, or NULL to +

the new persistent hostname to set, or NULL to clear any existing persistent hostname.

[allow-none]

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

 

error

-

return location for GError

+

return location for GError

  @@ -1683,7 +1683,7 @@ clear any existing persistent hostname.

Returns

-

TRUE if the request was successful, FALSE if it failed

+

TRUE if the request was successful, FALSE if it failed

@@ -1692,9 +1692,9 @@ clear any existing persistent hostname. 

void
 nm_client_save_hostname_async (NMClient *client,
                                const char *hostname,
-                               GCancellable *cancellable,
-                               GAsyncReadyCallback callback,
-                               gpointer user_data);
+ GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Requests that the machine's persistent hostname be set to the specified value or cleared.

@@ -1713,13 +1713,13 @@ or cleared.

hostname

-

the new persistent hostname to set, or NULL to +

the new persistent hostname to set, or NULL to clear any existing persistent hostname.

[allow-none]

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

  @@ -1740,10 +1740,10 @@ clear any existing persistent hostname.

nm_client_save_hostname_finish ()

-
gboolean
+
gboolean
 nm_client_save_hostname_finish (NMClient *client,
-                                GAsyncResult *result,
-                                GError **error);

+                                GAsyncResult *result,
+                                GError **error);

Gets the result of an nm_client_save_hostname_async() call.

Parameters

@@ -1761,12 +1761,12 @@ nm_client_save_hostname_finish (

result

-

the result passed to the GAsyncReadyCallback

+

the result passed to the GAsyncReadyCallback

 

error

-

return location for GError

+

return location for GError

  @@ -1774,13 +1774,13 @@ nm_client_save_hostname_finish (

Returns

-

TRUE if the request was successful, FALSE if it failed

+

TRUE if the request was successful, FALSE if it failed

nm_client_get_devices ()

-
const GPtrArray *
+
const GPtrArray *
 nm_client_get_devices (NMClient *client);

 
Gets all the known network devices.  Use nm_device_get_type() or the
 NM_IS_DEVICE_XXXX functions to determine what kind of
@@ -1803,7 +1803,7 @@ methods such as 
 
Returns

-
 a GPtrArray
+
 a GPtrArray
 containing all the NMDevices.  The returned array is owned by the
 NMClient object and should not be modified. 

 
[transfer none][element-type NMDevice]

@@ -1812,7 +1812,7 @@ containing all the NMDevices
 

 
nm_client_get_all_devices ()

-
const GPtrArray *
+
const GPtrArray *
 nm_client_get_all_devices (NMClient *client);

 
Gets both real devices and device placeholders (eg, software devices which
 do not currently exist, but could be created automatically by NetworkManager
@@ -1839,7 +1839,7 @@ use device-specific methods such as 
 
Returns

-
 a GPtrArray
+
 a GPtrArray
 containing all the NMDevices.  The returned array is owned by the
 NMClient object and should not be modified. 

 
[transfer none][element-type NMDevice]

@@ -1878,7 +1878,7 @@ nm_client_get_device_by_path (
 
Returns

 
 the NMDevice for the given object_path
-or NULL if none is found. 

+or NULL if none is found. 

 
[transfer none]
@@ -1914,14 +1914,14 @@ nm_client_get_device_by_iface (

Returns

the NMDevice for the given iface -or NULL if none is found.

+or NULL if none is found.

[transfer none]

nm_client_get_active_connections ()

-
const GPtrArray *
+
const GPtrArray *
 nm_client_get_active_connections (NMClient *client);

 
Gets the active connections.

 

@@ -1941,7 +1941,7 @@ nm_client_get_active_connections (
 

 
Returns

-
 a GPtrArray
+
 a GPtrArray
 containing all the active NMActiveConnections.
 The returned array is owned by the client and should not be modified. 

 
[transfer none][element-type NMActiveConnection]

@@ -1960,7 +1960,7 @@ the default route. If there is a VPN active with the default route,
 then this function returns the active connection that contains the
 route to the VPN endpoint.

 
If there is no default route, or the default route is over a
-non-NetworkManager-recognized device, this will return NULL.

+non-NetworkManager-recognized device, this will return NULL.

 

 
Parameters

 

@@ -2018,12 +2018,12 @@ any. 
nm_client_activate_connection_async ()
void
 nm_client_activate_connection_async (NMClient *client,
-                                     NMConnection *connection,
+                                     NMConnection *connection,
                                      NMDevice *device,
                                      const char *specific_object,
-                                     GCancellable *cancellable,
-                                     GAsyncReadyCallback callback,
-                                     gpointer user_data);

+                                     GCancellable *cancellable,
+                                     GAsyncReadyCallback callback,
+                                     gpointer user_data);
Asynchronously starts a connection to a particular network using the
 configuration settings from connection
  and the network device device
@@ -2058,7 +2058,7 @@ track the activation to its completion.

-
+
@@ -2070,7 +2070,7 @@ track the activation to its completion.

-
+
@@ -2103,8 +2103,8 @@ details of the newly added connection. 
nm_client_activate_connection_finish ()
NMActiveConnection *
 nm_client_activate_connection_finish (NMClient *client,
-                                      GAsyncResult *result,
-                                      GError **error);

+                                      GAsyncResult *result,
+                                      GError **error);
Gets the result of a call to nm_client_activate_connection_async().

 
Parameters

@@ -2122,12 +2122,12 @@ nm_client_activate_connection_finish (
result

-

+
-
+
@@ -2135,7 +2135,7 @@ nm_client_activate_connection_finish (
 
Returns

-
 the new NMActiveConnection on success, NULL on
+
 the new NMActiveConnection on success, NULL on
 failure, in which case error
 will be set. 

 
[transfer full]

@@ -2147,12 +2147,12 @@ will be set. 

 
void
 nm_client_add_and_activate_connection_async
                                (NMClient *client,
-                                NMConnection *partial,
+                                NMConnection *partial,
                                 NMDevice *device,
                                 const char *specific_object,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);

+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
 
Adds a new connection using the given details (if any) as a template,
 automatically filling in missing settings with the capabilities of the given
 device and specific object.  The new connection is then asynchronously
@@ -2178,8 +2178,8 @@ track the activation to its completion.

 
 
-
@@ -2194,7 +2194,7 @@ before being added. 

 
-
+
@@ -2228,11 +2228,11 @@ details of the newly added connection. 

 
NMActiveConnection *
 nm_client_add_and_activate_connection_finish
                                (NMClient *client,
-                                GAsyncResult *result,
-                                GError **error);

+                                GAsyncResult *result,
+                                GError **error);
 
Gets the result of a call to nm_client_add_and_activate_connection_async().

 
You can call nm_active_connection_get_connection() on the returned
-NMActiveConnection to find the path of the created NMConnection.

+NMActiveConnection to find the path of the created NMConnection.

 

 
Parameters

 

 
 
 
 
 

 
connection
 an NMConnection. 
 an NMConnection. 

 [allow-none]
 

 

 
specific_object

 
 the object path of a connection-type-specific
 object this activation should use. This parameter is currently ignored for
-wired and mobile broadband connections, and the value of NULL should be used
+wired and mobile broadband connections, and the value of NULL should be used
 (ie, no specific object).  For Wi-Fi or WiMAX connections, pass the object
 path of a NMAccessPoint or NMWimaxNsp owned by device
 , which you can
@@ -2080,7 +2080,7 @@ details of the newly added connection. 

 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
 
 
 
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 

 
partial
 an NMConnection to add; the connection may be
-partially filled (or even NULL) and will be completed by NetworkManager
+
 an NMConnection to add; the connection may be
+partially filled (or even NULL) and will be completed by NetworkManager
 using the given device
 and specific_object
 before being added. 
specific_object

 
 the object path of a connection-type-specific
 object this activation should use. This parameter is currently ignored for
-wired and mobile broadband connections, and the value of NULL should be used
+wired and mobile broadband connections, and the value of NULL should be used
 (ie, no specific object).  For Wi-Fi or WiMAX connections, pass the object
 path of a NMAccessPoint or NMWimaxNsp owned by device
 , which you can
@@ -2204,7 +2204,7 @@ details of the newly added connection. 

 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

@@ -2249,12 +2249,12 @@ nm_client_add_and_activate_connection_finish
 
 
-
+
-
+
@@ -2262,7 +2262,7 @@ nm_client_add_and_activate_connection_finish
 
 

 
Returns

-
 the new NMActiveConnection on success, NULL on
+
 the new NMActiveConnection on success, NULL on
 failure, in which case error
 will be set. 

 
[transfer full]

@@ -2271,11 +2271,11 @@ will be set. 

 

 

 
nm_client_deactivate_connection ()

-
gboolean
+
gboolean
 nm_client_deactivate_connection (NMClient *client,
                                  NMActiveConnection *active,
-                                 GCancellable *cancellable,
-                                 GError **error);

+                                 GCancellable *cancellable,
+                                 GError **error);

 
Deactivates an active NMActiveConnection.

 

 
Parameters

@@ -2298,12 +2298,12 @@ nm_client_deactivate_connection (
 

-
+
-
+
@@ -2320,9 +2320,9 @@ nm_client_deactivate_connection (void
 nm_client_deactivate_connection_async (NMClient *client,
                                        NMActiveConnection *active,
-                                       GCancellable *cancellable,
-                                       GAsyncReadyCallback callback,
-                                       gpointer user_data);
+                                       GCancellable *cancellable,
+                                       GAsyncReadyCallback callback,
+                                       gpointer user_data);
 
Asynchronously deactivates an active NMActiveConnection.

 

 
Parameters

@@ -2345,7 +2345,7 @@ nm_client_deactivate_connection_async (
cancellable

-

+
@@ -2366,11 +2366,11 @@ nm_client_deactivate_connection_async (
 
nm_client_deactivate_connection_finish ()

-
gboolean
+
gboolean
 nm_client_deactivate_connection_finish
                                (NMClient *client,
-                                GAsyncResult *result,
-                                GError **error);

+                                GAsyncResult *result,
+                                GError **error);

 
Gets the result of a call to nm_client_deactivate_connection_async().

 

 
Parameters

@@ -2388,12 +2388,12 @@ nm_client_deactivate_connection_finish
 

-
+
-
+
@@ -2407,7 +2407,7 @@ nm_client_deactivate_connection_finish
 

 

 
nm_client_get_connections ()

-
const GPtrArray *
+
const GPtrArray *
 nm_client_get_connections (NMClient *client);

 

 
Parameters

@@ -2428,7 +2428,9 @@ nm_client_get_connections (
Returns

 
 an array
 containing all connections provided by the remote settings service.  The
-returned array is owned by the NMClient object and should not be modified. 

+returned array is owned by the NMClient object and should not be modified.

+
The connections are as received from D-Bus and might not validate according
+to nm_connection_verify(). 

 
[transfer none][element-type NMRemoteConnection]

 

 

@@ -2464,8 +2466,10 @@ nm_client_get_connection_by_id (
 

 
Returns

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

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

+
The connection is as received from D-Bus and might not validate according
+to nm_connection_verify(). 

 
[transfer none]

 

 
@@ -2501,8 +2505,10 @@ nm_client_get_connection_by_path (
 

 
Returns

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

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

+
The connection is as received from D-Bus and might not validate according
+to nm_connection_verify(). 

 
[transfer none]

 

 
@@ -2538,8 +2544,10 @@ nm_client_get_connection_by_uuid (
 

 
Returns

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

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

+
The connection is as received from D-Bus and might not validate according
+to nm_connection_verify(). 

 
[transfer none]

 

 
@@ -2548,14 +2556,14 @@ not known. 

 
nm_client_add_connection_async ()

 
void
 nm_client_add_connection_async (NMClient *client,
-                                NMConnection *connection,
-                                gboolean save_to_disk,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);

+                                NMConnection *connection,
+                                gboolean save_to_disk,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
 
Requests that the remote settings service add the given settings to a new
 connection.  If save_to_disk
- is TRUE, the connection is immediately written
+ is TRUE, the connection is immediately written
 to disk; otherwise it is initially only stored in memory, but may be saved
 later by calling the connection's nm_remote_connection_commit_changes()
 method.

@@ -2597,7 +2605,7 @@ added, not the object itself

 
 
-
+
@@ -2620,8 +2628,8 @@ added, not the object itself

 
nm_client_add_connection_finish ()

 
NMRemoteConnection *
 nm_client_add_connection_finish (NMClient *client,
-                                 GAsyncResult *result,
-                                 GError **error);

+                                 GAsyncResult *result,
+                                 GError **error);
 
Gets the result of a call to nm_client_add_connection_async().

 

 
Parameters

@@ -2639,12 +2647,12 @@ nm_client_add_connection_finish (
 

-
+
-
+
@@ -2652,7 +2660,7 @@ nm_client_add_connection_finish (
 

 
Returns

-
 the new NMRemoteConnection on success, NULL on
+
 the new NMRemoteConnection on success, NULL on
 failure, in which case error
 will be set. 

 
[transfer full]

@@ -2661,23 +2669,23 @@ will be set. 

 

 

 
nm_client_load_connections ()

-
gboolean
+
gboolean
 nm_client_load_connections (NMClient *client,
                             char **filenames,
                             char ***failures,
-                            GCancellable *cancellable,
-                            GError **error);

+                            GCancellable *cancellable,
+                            GError **error);

 
Requests that the remote settings service load or reload the given files,
 adding or updating the connections described within.

 
The changes to the indicated files will not yet be reflected in
 client
 's connections array when the function returns.

 
If all of the indicated files were successfully loaded, the
-function will return TRUE, and failures
- will be set to NULL. If
+function will return TRUE, and failures
+ will be set to NULL. If
 NetworkManager tried to load the files, but some (or all) failed,
 then failures
- will be set to a NULL-terminated array of the
+ will be set to a NULL-terminated array of the
 filenames that failed to load.

 

 
Parameters

@@ -2695,23 +2703,23 @@ filenames that failed to load.

 
 

-
+
-
-
+
-
+
@@ -2719,9 +2727,9 @@ filenames that failed to load. 

 
 

 
Returns

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

+FALSE if an error occurred (eg, permission denied).

 

 
 

@@ -2730,9 +2738,9 @@ filenames that failed to load. 

 
void
 nm_client_load_connections_async (NMClient *client,
                                   char **filenames,
-                                  GCancellable *cancellable,
-                                  GAsyncReadyCallback callback,
-                                  gpointer user_data);

+                                  GCancellable *cancellable,
+                                  GAsyncReadyCallback callback,
+                                  gpointer user_data);
 
Requests that the remote settings service asynchronously load or reload the
 given files, adding or updating the connections described within.

 
See nm_client_load_connections() for more details.

@@ -2752,12 +2760,12 @@ given files, adding or updating the connections described within.

 
 
-
+
-
+
@@ -2778,11 +2786,11 @@ given files, adding or updating the connections described within.

 

 

 
nm_client_load_connections_finish ()

-
gboolean
+
gboolean
 nm_client_load_connections_finish (NMClient *client,
                                    char ***failures,
-                                   GAsyncResult *result,
-                                   GError **error);

+                                   GAsyncResult *result,
+                                   GError **error);

 
Gets the result of an nm_client_load_connections_async() call.

 
See nm_client_load_connections() for more details.

 

@@ -2801,18 +2809,18 @@ nm_client_load_connections_finish (
 

-
-
+
-
+
@@ -2820,18 +2828,18 @@ filenames that failed to load. 

 
 

 
Returns

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

+FALSE if an error occurred (eg, permission denied).

 

 
 

 

 
nm_client_reload_connections ()

-
gboolean
+
gboolean
 nm_client_reload_connections (NMClient *client,
-                              GCancellable *cancellable,
-                              GError **error);

+                              GCancellable *cancellable,
+                              GError **error);

 
Requests that the remote settings service reload all connection
 files from disk, adding, updating, and removing connections until
 the in-memory state matches the on-disk state.

@@ -2851,12 +2859,12 @@ the in-memory state matches the on-disk state.

 
 

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

 
 

 
Returns

-
 TRUE on success, FALSE on failure

+
 TRUE on success, FALSE on failure

 

 
 

@@ -2872,9 +2880,9 @@ the in-memory state matches the on-disk state.

 
nm_client_reload_connections_async ()

 
void
 nm_client_reload_connections_async (NMClient *client,
-                                    GCancellable *cancellable,
-                                    GAsyncReadyCallback callback,
-                                    gpointer user_data);

+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data);
 
Requests that the remote settings service begin reloading all connection
 files from disk, adding, updating, and removing connections until the
 in-memory state matches the on-disk state.

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

 
 
-
+
@@ -2915,10 +2923,10 @@ in-memory state matches the on-disk state.

 

 

 
nm_client_reload_connections_finish ()

-
gboolean
+
gboolean
 nm_client_reload_connections_finish (NMClient *client,
-                                     GAsyncResult *result,
-                                     GError **error);

+                                     GAsyncResult *result,
+                                     GError **error);

 
Gets the result of an nm_client_reload_connections_async() call.

 

 
Parameters

@@ -2936,12 +2944,12 @@ nm_client_reload_connections_finish (
 

-
+
-
+
@@ -2949,7 +2957,7 @@ nm_client_reload_connections_finish (
 

 
Returns

-
 TRUE on success, FALSE on failure

+
 TRUE on success, FALSE on failure

 

 
 
@@ -3353,7 +3361,7 @@ likely to become the new 
 
The “active-connections” property

-
  “active-connections”       GPtrArray *

+
  “active-connections”       GPtrArray *

 
The active connections.

 
Element-type: NMActiveConnection

 
Flags: Read

@@ -3361,7 +3369,7 @@ likely to become the new 
 
The “all-devices” property

-
  “all-devices”              GPtrArray *

+
  “all-devices”              GPtrArray *

 
List of both real devices and device placeholders.

 
Element-type: NMDevice

 
Flags: Read

@@ -3370,15 +3378,15 @@ likely to become the new 
 
The “can-modify” property

-
  “can-modify”               gboolean

-
If TRUE, adding and modifying connections is supported.

+
  “can-modify”               gboolean

+
If TRUE, adding and modifying connections is supported.

 
Flags: Read

 
Default value: FALSE

 
 

 

 
The “connections” property

-
  “connections”              GPtrArray *

+
  “connections”              GPtrArray *

 
The list of configured connections that are available to the user. (Note
 that this differs from the underlying D-Bus property, which may also
 contain the object paths of connections that the user does not have
@@ -3397,7 +3405,7 @@ permission to read the details of.)

 

 

 
The “devices” property

-
  “devices”                  GPtrArray *

+
  “devices”                  GPtrArray *

 
List of real network devices.  Does not include placeholder devices.

 
Element-type: NMDevice

 
Flags: Read

@@ -3405,7 +3413,7 @@ permission to read the details of.)

 

 

 
The “hostname” property

-
  “hostname”                 gchar *

+
  “hostname”                 gchar *

 
The machine hostname stored in persistent configuration. This can be
 modified by calling nm_client_save_hostname().

 
Flags: Read

@@ -3414,7 +3422,7 @@ modified by calling 
 

 
The “metered” property

-
  “metered”                  guint

+
  “metered”                  guint

 
Whether the connectivity is metered.

 
Flags: Read

 
Default value: 0

@@ -3423,7 +3431,7 @@ modified by calling 
 

 
The “networking-enabled” property

-
  “networking-enabled”       gboolean

+
  “networking-enabled”       gboolean

 
Whether networking is enabled.

 
Flags: Read / Write

 
Default value: TRUE

@@ -3431,7 +3439,7 @@ modified by calling 
 

 
The “nm-running” property

-
  “nm-running”               gboolean

+
  “nm-running”               gboolean

 
Whether the daemon is running.

 
Flags: Read

 
Default value: FALSE

@@ -3447,7 +3455,7 @@ see 
 

 
The “startup” property

-
  “startup”                  gboolean

+
  “startup”                  gboolean

 
Whether the daemon is still starting up.

 
Flags: Read

 
Default value: FALSE

@@ -3463,7 +3471,7 @@ see 
 

 
The “version” property

-
  “version”                  gchar *

+
  “version”                  gchar *

 
The NetworkManager version.

 
Flags: Read

 
Default value: NULL

@@ -3471,7 +3479,7 @@ see 
 

 
The “wimax-enabled” property

-
  “wimax-enabled”            gboolean

+
  “wimax-enabled”            gboolean

 
Whether WiMAX functionality is enabled.

 
Flags: Read / Write

 
Default value: FALSE

@@ -3479,7 +3487,7 @@ see 
 

 
The “wimax-hardware-enabled” property

-
  “wimax-hardware-enabled”   gboolean

+
  “wimax-hardware-enabled”   gboolean

 
Whether the WiMAX hardware is enabled.

 
Flags: Read

 
Default value: FALSE

@@ -3487,7 +3495,7 @@ see 
 

 
The “wireless-enabled” property

-
  “wireless-enabled”         gboolean

+
  “wireless-enabled”         gboolean

 
Whether wireless is enabled.

 
Flags: Read / Write

 
Default value: FALSE

@@ -3495,7 +3503,7 @@ see 
 

 
The “wireless-hardware-enabled” property

-
  “wireless-hardware-enabled” gboolean

+
  “wireless-hardware-enabled” gboolean

 
Whether the wireless hardware is enabled.

 
Flags: Read

 
Default value: TRUE

@@ -3503,7 +3511,7 @@ see 
 

 
The “wwan-enabled” property

-
  “wwan-enabled”             gboolean

+
  “wwan-enabled”             gboolean

 
Whether WWAN functionality is enabled.

 
Flags: Read / Write

 
Default value: FALSE

@@ -3511,7 +3519,7 @@ see 
 

 
The “wwan-hardware-enabled” property

-
  “wwan-hardware-enabled”    gboolean

+
  “wwan-hardware-enabled”    gboolean

 
Whether the WWAN hardware is enabled.

 
Flags: Read

 
Default value: FALSE

@@ -3523,8 +3531,8 @@ see 
The “any-device-added” signal

 
void
 user_function (NMClient *client,
-               GObject  *device,
-               gpointer  user_data)

+               GObject  *device,
+               gpointer  user_data)
 
Notifies that a NMDevice is added.  This signal is emitted for both
 regular devices and placeholder devices.

 

@@ -3554,15 +3562,15 @@ regular devices and placeholder devices.

 
 

 
result
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 

 
result
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
result
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 

 
filenames
NULL-terminated array of filenames to load
NULL-terminated array of filenames to load

  
 

 

 
failures
 on return, a NULL-terminated array of
+
 on return, a NULL-terminated array of
 filenames that failed to load. 

 [out][transfer full]
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
error
return location for GError
return location for GError

  
 

 

 
filenames
NULL-terminated array of filenames to load
NULL-terminated array of filenames to load

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
failures
 on return, a NULL-terminated array of
+
 on return, a NULL-terminated array of
 filenames that failed to load. 

 [out][transfer full]
 

 

 
result
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
location for a GError, or NULL
location for a GError, or NULL

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
error
return location for GError
return location for GError

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
result
the result passed to the GAsyncReadyCallback
the result passed to the GAsyncReadyCallback

  
 

 

 
error
return location for GError
return location for GError

  
 

 

 

-
Flags: Run First

+
Flags: Run First

 

 

 

 
The “any-device-removed” signal

 
void
 user_function (NMClient *client,
-               GObject  *device,
-               gpointer  user_data)

+               GObject  *device,
+               gpointer  user_data)

Notifies that a NMDevice is removed. This signal is emitted for both regular devices and placeholder devices.

@@ -3592,7 +3600,7 @@ regular devices and placeholder devices.

-

Flags: Run First

+

Flags: Run First

@@ -3600,8 +3608,8 @@ regular devices and placeholder devices.

void
 user_function (NMClient           *client,
                NMRemoteConnection *connection,
-               gpointer            user_data)
-

Notifies that a NMConnection has been added.

+ gpointer user_data) +

Notifies that a NMConnection has been added.

Parameters

@@ -3629,7 +3637,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

@@ -3637,8 +3645,8 @@ user_function (void user_function (NMClient *client, NMRemoteConnection *connection, - gpointer user_data) -

Notifies that a NMConnection has been removed.

+ gpointer user_data) +

Notifies that a NMConnection has been removed.

Parameters

@@ -3666,15 +3674,15 @@ user_function (
-

Flags: Run First

+

Flags: Run First

The “device-added” signal

void
 user_function (NMClient *client,
-               GObject  *device,
-               gpointer  user_data)
+ GObject *device, + gpointer user_data)

Notifies that a NMDevice is added. This signal is not emitted for placeholder devices.

@@ -3704,15 +3712,15 @@ placeholder devices.

-

Flags: Run First

+

Flags: Run First

The “device-removed” signal

void
 user_function (NMClient *client,
-               GObject  *device,
-               gpointer  user_data)
+ GObject *device, + gpointer user_data)

Notifies that a NMDevice is removed. This signal is not emitted for placeholder devices.

@@ -3742,16 +3750,16 @@ placeholder devices.

-

Flags: Run First

+

Flags: Run First

The “permission-changed” signal

void
 user_function (NMClient *client,
-               guint     permission,
-               guint     result,
-               gpointer  user_data)
+ guint permission, + guint result, + gpointer user_data)

Notifies that a permission has changed

Parameters

@@ -3785,7 +3793,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

-- cgit 1.3.0-6-gf8a5