From 45cb5bb3c0e6edb887cf69b417fcaf7053814a9b Mon Sep 17 00:00:00 2001 From: Aron Xu Date: Tue, 20 Dec 2016 20:06:37 +0800 Subject: Imported Upstream version 1.4.4 --- docs/libnm/html/NMClient.html | 700 +++++++++++++++++++++--------------------- 1 file changed, 350 insertions(+), 350 deletions(-) (limited to 'docs/libnm/html/NMClient.html') diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 2c8913a8..487922bc 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -3,7 +3,7 @@ NMClient: libnm Reference Manual - + @@ -37,7 +37,7 @@

Functions

-
+
@@ -45,7 +45,7 @@ - - - -
-GQuark +GQuark nm_client_error_quark () @@ -92,7 +92,7 @@
-gboolean +gboolean nm_client_get_startup () @@ -100,7 +100,7 @@
-gboolean +gboolean nm_client_get_nm_running () @@ -108,7 +108,7 @@
-gboolean +gboolean nm_client_networking_get_enabled () @@ -116,7 +116,7 @@
-gboolean +gboolean nm_client_networking_set_enabled () @@ -124,7 +124,7 @@
-gboolean +gboolean nm_client_wireless_get_enabled () @@ -140,7 +140,7 @@
-gboolean +gboolean nm_client_wireless_hardware_get_enabled () @@ -148,7 +148,7 @@
-gboolean +gboolean nm_client_wwan_get_enabled () @@ -164,7 +164,7 @@
-gboolean +gboolean nm_client_wwan_hardware_get_enabled () @@ -172,7 +172,7 @@
-gboolean +gboolean nm_client_wimax_get_enabled () @@ -188,7 +188,7 @@
-gboolean +gboolean nm_client_wimax_hardware_get_enabled () @@ -196,7 +196,7 @@
-gboolean +gboolean nm_client_get_logging () @@ -204,7 +204,7 @@
-gboolean +gboolean nm_client_set_logging () @@ -252,7 +252,7 @@
-gboolean +gboolean nm_client_save_hostname () @@ -268,21 +268,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 () @@ -305,7 +305,7 @@
const GPtrArray * +const GPtrArray * nm_client_get_active_connections () @@ -361,7 +361,7 @@
-gboolean +gboolean nm_client_deactivate_connection () @@ -377,14 +377,14 @@
-gboolean +gboolean nm_client_deactivate_connection_finish ()
const GPtrArray * +const GPtrArray * nm_client_get_connections () @@ -432,7 +432,7 @@
-gboolean +gboolean nm_client_load_connections () @@ -448,7 +448,7 @@
-gboolean +gboolean nm_client_load_connections_finish () @@ -456,7 +456,7 @@
-gboolean +gboolean nm_client_reload_connections () @@ -472,7 +472,7 @@
-gboolean +gboolean nm_client_reload_connections_finish () @@ -483,7 +483,7 @@

Properties

-
+
@@ -498,24 +498,24 @@ +GPtrArray * +GPtrArray * - + +GPtrArray * @@ -526,28 +526,28 @@ +GPtrArray * +gchar * - + - + - + @@ -558,7 +558,7 @@ - + @@ -569,37 +569,37 @@ +gchar * - + - + - + - + - + - + @@ -608,7 +608,7 @@

Signals

-
-GPtrArray * active-connections Read
-GPtrArray * all-devices Read
gbooleangboolean can-modify Read
-GPtrArray * connections Read
-GPtrArray * devices Read
-gchar * hostname Read
guintguint metered Read
gbooleangboolean networking-enabled Read / Write
gbooleangboolean nm-running Read
Read
gbooleangboolean startup Read
-gchar * version Read
gbooleangboolean wimax-enabled Read / Write
gbooleangboolean wimax-hardware-enabled Read
gbooleangboolean wireless-enabled Read / Write
gbooleangboolean wireless-hardware-enabled Read
gbooleangboolean wwan-enabled Read / Write
gbooleangboolean wwan-hardware-enabled Read
+
@@ -618,54 +618,54 @@ - + - + - + - + - + - + - + - + - +
void active-connection-addedRun FirstRun First
void active-connection-removedRun FirstRun First
void any-device-addedRun FirstRun First
void any-device-removedRun FirstRun First
void connection-addedRun FirstRun First
void connection-removedRun FirstRun First
void device-addedRun FirstRun First
void device-removedRun FirstRun First
void permission-changedRun FirstRun First

Types and Values

-
+
@@ -820,7 +820,7 @@ ├── NMClientError ├── NMClientPermission ╰── NMClientPermissionResult - GObject + GObject╰── NMClient @@ -828,7 +828,7 @@

Implemented Interfaces

NMClient implements - GInitable and GAsyncInitable.

+ GInitable and GAsyncInitable.

Description

@@ -837,7 +837,7 @@ NMClient implements

Functions

nm_client_error_quark ()

-
GQuark
+
GQuark
 nm_client_error_quark (void);

 
Registers an error quark for NMClient if necessary.

 

@@ -849,15 +849,15 @@ 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 that.

Parameters

-
+
@@ -866,12 +866,12 @@ that.

 - + - + @@ -886,9 +886,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 @@ -896,7 +896,7 @@ nm_client_new_async (

Parameters

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  

error

location for a GError, or NULL

location for a GError, or NULL

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

 - + @@ -927,12 +927,12 @@ 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

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -941,12 +941,12 @@ nm_client_new_finish (

result

- + - + @@ -954,7 +954,7 @@ nm_client_new_finish (

Returns

-

a new NMClient, or NULL on error

+

a new NMClient, or NULL on error

@@ -965,7 +965,7 @@ nm_client_get_version (

Parameters

-

a GAsyncResult

a GAsyncResult

  

error

location for a GError, or NULL

location for a GError, or NULL

  
+
@@ -980,7 +980,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)

@@ -991,7 +991,7 @@ nm_client_get_state (

Parameters

-
+
@@ -1012,13 +1012,13 @@ 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.

 

 
Parameters

-
+
@@ -1039,12 +1039,12 @@ connections at startup.

nm_client_get_nm_running ()

-
gboolean
+
gboolean
 nm_client_get_nm_running (NMClient *client);

 
Determines whether the daemon is running.

 

 
Parameters

-
+
@@ -1059,18 +1059,18 @@ 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.

 

 
Parameters

-
+
@@ -1085,22 +1085,22 @@ 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.

Parameters

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

 - + - + @@ -1127,18 +1127,18 @@ 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.

 

 
Parameters

-

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]
+
@@ -1153,7 +1153,7 @@ nm_client_wireless_get_enabled (

Returns

-

TRUE if wireless is enabled

+

TRUE if wireless is enabled

@@ -1161,11 +1161,11 @@ 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

-
+
@@ -1179,7 +1179,7 @@ nm_client_wireless_set_enabled ( - + @@ -1189,13 +1189,13 @@ 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.

 

 
Parameters

-

enabled

TRUE to enable wireless

TRUE to enable wireless

  
+
@@ -1210,18 +1210,18 @@ 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.

 

 
Parameters

-
+
@@ -1236,7 +1236,7 @@ nm_client_wwan_get_enabled (

Returns

-

TRUE if WWAN is enabled

+

TRUE if WWAN is enabled

@@ -1244,11 +1244,11 @@ 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

-
+
@@ -1262,7 +1262,7 @@ nm_client_wwan_set_enabled (

enabled

- + @@ -1272,12 +1272,12 @@ 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.

 

 
Parameters

-

TRUE to enable WWAN

TRUE to enable WWAN

  
+
@@ -1292,18 +1292,18 @@ 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.

 

 
Parameters

-
+
@@ -1318,7 +1318,7 @@ nm_client_wimax_get_enabled (

Returns

-

TRUE if WiMAX is enabled

+

TRUE if WiMAX is enabled

@@ -1326,11 +1326,11 @@ 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

-
+
@@ -1344,7 +1344,7 @@ nm_client_wimax_set_enabled (

enabled

- + @@ -1354,12 +1354,12 @@ 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.

 

 
Parameters

-

TRUE to enable WiMAX

TRUE to enable WiMAX

  
+
@@ -1374,21 +1374,21 @@ 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

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

- + @@ -1421,21 +1421,21 @@ 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

-

error

return location for a GError, or NULL.

return location for a GError, or NULL.

[allow-none]
+
@@ -1449,18 +1449,18 @@ nm_client_set_logging (

level

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

- + @@ -1468,7 +1468,7 @@ domains separated by ",". (

Returns

-

TRUE on success, FALSE otherwise

+

TRUE on success, FALSE otherwise

@@ -1481,7 +1481,7 @@ nm_client_get_permission_result (

Parameters

-

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).

[allow-none]

error

return location for a GError, or NULL.

return location for a GError, or NULL.

[allow-none]
+
@@ -1517,7 +1517,7 @@ nm_client_get_connectivity (

Parameters

-
+
@@ -1540,8 +1540,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.

@@ -1549,7 +1549,7 @@ the most recent known state without re-checking.

if you do not want to block.

Parameters

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

 - + - + @@ -1584,9 +1584,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(), @@ -1594,7 +1594,7 @@ which (immediately) returns the most recent known state without re-checking, and nm_client_check_connectivity(), which blocks.

Parameters

-

cancellable

a GCancellable

a GCancellable

  

error

return location for a GError

return location for a GError

  
+
@@ -1608,7 +1608,7 @@ re-checking, and

cancellable

- + @@ -1631,13 +1631,13 @@ 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.

Parameters

-

a GCancellable

a GCancellable

  
+
@@ -1651,12 +1651,12 @@ call.

 - + - + @@ -1670,16 +1670,16 @@ 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.

Parameters

-

result

the GAsyncResult

the GAsyncResult

  

error

return location for a GError

return location for a GError

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

 - - + - + @@ -1712,7 +1712,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

@@ -1721,14 +1721,14 @@ 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.

Parameters

-

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

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

 - - + @@ -1769,14 +1769,14 @@ 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

-

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

  
+
@@ -1790,12 +1790,12 @@ nm_client_save_hostname_finish ( - + - + @@ -1803,13 +1803,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
@@ -1817,7 +1817,7 @@ device member of the returned array is, and then you may use device-specific
 methods such as nm_device_ethernet_get_hw_address().

 

 
Parameters

-

result

the result passed to the GAsyncReadyCallback

the result passed to the GAsyncReadyCallback

  

error

return location for GError

return location for GError

  
+
@@ -1832,7 +1832,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]

@@ -1841,7 +1841,7 @@ containing all the NM

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
@@ -1853,7 +1853,7 @@ what kind of device each member of the returned array is, and then you may
 use device-specific methods such as nm_device_ethernet_get_hw_address().

 

 
Parameters

-
+
@@ -1868,7 +1868,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]

@@ -1884,7 +1884,7 @@ nm_client_get_device_by_path (NMDevice from a NMClient.

Parameters

-
+
@@ -1907,7 +1907,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]

@@ -1920,7 +1920,7 @@ nm_client_get_device_by_iface (Gets a NMDevice from a NMClient.

Parameters

-
+
@@ -1943,19 +1943,19 @@ 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.

 

 
Parameters

-
+
@@ -1970,7 +1970,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]

@@ -1989,10 +1989,10 @@ 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

-
+
@@ -2022,7 +2022,7 @@ currently-activating connection that is expected to become the new “primary-connection” upon successful activation.

Parameters

-
+
@@ -2050,9 +2050,9 @@ nm_client_activate_connection_async (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 @@ -2073,7 +2073,7 @@ the new connection, not when it finishes. You can used the returned track the activation to its completion.

Parameters

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

 - + @@ -2132,12 +2132,12 @@ 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

-

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 @@ -2109,7 +2109,7 @@ details of the newly added connection.

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2151,12 +2151,12 @@ nm_client_activate_connection_finish (

result

- + - + @@ -2164,7 +2164,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]

@@ -2179,9 +2179,9 @@ nm_client_add_and_activate_connection_async 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 @@ -2193,7 +2193,7 @@ the new connection, not when it finishes. You can used the returned track the activation to its completion.

Parameters

-

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

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

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

- + @@ -2257,14 +2257,14 @@ 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.

Parameters

-

partial

an NMConnection to add; the connection may be -partially filled (or even NULL) and will be completed by NetworkManager +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 @@ -2233,7 +2233,7 @@ details of the newly added connection.

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2278,12 +2278,12 @@ nm_client_add_and_activate_connection_finish - + - + @@ -2291,7 +2291,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]

@@ -2300,15 +2300,15 @@ 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

-

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

  
+
@@ -2327,12 +2327,12 @@ nm_client_deactivate_connection ( - + - + @@ -2349,13 +2349,13 @@ 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

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  

error

location for a GError, or NULL

location for a GError, or NULL

  
+
@@ -2374,7 +2374,7 @@ nm_client_deactivate_connection_async (

cancellable

- + @@ -2395,15 +2395,15 @@ 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

-

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2417,12 +2417,12 @@ nm_client_deactivate_connection_finish - + - + @@ -2436,11 +2436,11 @@ nm_client_deactivate_connection_finish

nm_client_get_connections ()

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

 

 
Parameters

-

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

  
+
@@ -2473,7 +2473,7 @@ nm_client_get_connection_by_id (

Parameters

-
+
@@ -2495,7 +2495,7 @@ nm_client_get_connection_by_id (

Returns

-

the remote connection object on success, or NULL if no +

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().

@@ -2512,7 +2512,7 @@ nm_client_get_connection_by_path (

Parameters

-
+
@@ -2534,7 +2534,7 @@ nm_client_get_connection_by_path (

Returns

-

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

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().

@@ -2551,7 +2551,7 @@ nm_client_get_connection_by_uuid (

Parameters

-
+
@@ -2573,7 +2573,7 @@ nm_client_get_connection_by_uuid (

Returns

-

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

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().

@@ -2586,13 +2586,13 @@ to void nm_client_add_connection_async (NMClient *client, NMConnection *connection, - gboolean save_to_disk, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + 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.

@@ -2609,7 +2609,7 @@ identical settings to connection completion and/or normalization of connection properties.

Parameters

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

 - + @@ -2657,12 +2657,12 @@ 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

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2676,12 +2676,12 @@ nm_client_add_connection_finish ( - + - + @@ -2689,7 +2689,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]

@@ -2698,27 +2698,27 @@ 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

-

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

  
+
@@ -2732,23 +2732,23 @@ filenames that failed to load.

 - + - - + - + @@ -2756,9 +2756,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).

@@ -2767,15 +2767,15 @@ 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.

Parameters

-

filenames

NULL-terminated array of filenames to load.

NULL-terminated array of filenames to load.

[array zero-terminated=1]

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

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

 - + - + @@ -2815,16 +2815,16 @@ 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.

Parameters

-

filenames

NULL-terminated array of filenames to load.

NULL-terminated array of filenames to load.

[array zero-terminated=1]

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2839,17 +2839,17 @@ nm_client_load_connections_finish ( +NULL-terminated array of filenames that failed to load.

- + - + @@ -2857,24 +2857,24 @@ nm_client_load_connections_finish (

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.

Parameters

-

failures

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

[out][transfer full][array zero-terminated=1]

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

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

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

Returns

-

TRUE on success, FALSE on failure

+

TRUE on success, FALSE on failure

@@ -2909,15 +2909,15 @@ 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.

Parameters

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  

error

return location for GError

return location for GError

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

 - + @@ -2952,14 +2952,14 @@ 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

-

cancellable

a GCancellable, or NULL

a GCancellable, or NULL

  
+
@@ -2973,12 +2973,12 @@ nm_client_reload_connections_finish ( - + - + @@ -2986,7 +2986,7 @@ nm_client_reload_connections_finish (

Returns

-

TRUE on success, FALSE on failure

+

TRUE on success, FALSE on failure

@@ -3178,7 +3178,7 @@ nm_client_reload_connections_finish (

Members

-

result

the result passed to the GAsyncReadyCallback

the result passed to the GAsyncReadyCallback

  

error

return location for GError

return location for GError

  
+
@@ -3328,7 +3328,7 @@ clients can obtain to perform certain tasks on behalf of the current user.

the user requires to obtain a given NMClientPermission

Members

-
+
@@ -3377,7 +3377,7 @@ the user requires to obtain a given NMManagerError, NMSettingsError, NMAgentManagerError, and NMConnectionError.

Members

-
+
@@ -3437,7 +3437,7 @@ likely to become the new

The “active-connections” property

-
  “active-connections”       GPtrArray *
+
  “active-connections”       GPtrArray *

The active connections.

Element-type: NMActiveConnection

Flags: Read

@@ -3445,7 +3445,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

@@ -3454,15 +3454,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 @@ -3481,7 +3481,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

@@ -3489,7 +3489,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

@@ -3498,7 +3498,7 @@ modified by calling

The “metered” property

-
  “metered”                  guint
+
  “metered”                  guint

Whether the connectivity is metered.

Flags: Read

Default value: 0

@@ -3507,7 +3507,7 @@ modified by calling

The “networking-enabled” property

-
  “networking-enabled”       gboolean
+
  “networking-enabled”       gboolean

Whether networking is enabled.

Flags: Read / Write

Default value: TRUE

@@ -3515,7 +3515,7 @@ modified by calling

The “nm-running” property

-
  “nm-running”               gboolean
+
  “nm-running”               gboolean

Whether the daemon is running.

Flags: Read

Default value: FALSE

@@ -3531,7 +3531,7 @@ see

The “startup” property

-
  “startup”                  gboolean
+
  “startup”                  gboolean

Whether the daemon is still starting up.

Flags: Read

Default value: FALSE

@@ -3547,7 +3547,7 @@ see

The “version” property

-
  “version”                  gchar *
+
  “version”                  gchar *

The NetworkManager version.

Flags: Read

Default value: NULL

@@ -3555,7 +3555,7 @@ see

The “wimax-enabled” property

-
  “wimax-enabled”            gboolean
+
  “wimax-enabled”            gboolean

Whether WiMAX functionality is enabled.

Flags: Read / Write

Default value: FALSE

@@ -3563,7 +3563,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

@@ -3571,7 +3571,7 @@ see

The “wireless-enabled” property

-
  “wireless-enabled”         gboolean
+
  “wireless-enabled”         gboolean

Whether wireless is enabled.

Flags: Read / Write

Default value: FALSE

@@ -3579,7 +3579,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

@@ -3587,7 +3587,7 @@ see

The “wwan-enabled” property

-
  “wwan-enabled”             gboolean
+
  “wwan-enabled”             gboolean

Whether WWAN functionality is enabled.

Flags: Read / Write

Default value: FALSE

@@ -3595,7 +3595,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

@@ -3608,11 +3608,11 @@ see void user_function (NMClient *client, NMActiveConnection *active_connection, - gpointer user_data) + gpointer user_data)

Notifies that a NMActiveConnection has been added.

Parameters

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

Flags: Run First

+

Flags: Run First

@@ -3645,11 +3645,11 @@ user_function (void user_function (NMClient *client, NMActiveConnection *active_connection, - gpointer user_data) + gpointer user_data)

Notifies that a NMActiveConnection has been removed.

Parameters

-
+
@@ -3674,20 +3674,20 @@ user_function (
-

Flags: Run First

+

Flags: Run First

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.

Parameters

-
+
@@ -3712,20 +3712,20 @@ regular devices and placeholder devices.

-

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.

Parameters

-
+
@@ -3750,7 +3750,7 @@ regular devices and placeholder devices.

-

Flags: Run First

+

Flags: Run First

@@ -3758,11 +3758,11 @@ regular devices and placeholder devices.

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

Notifies that a NMConnection has been added.

Parameters

-
+
@@ -3787,7 +3787,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

@@ -3795,11 +3795,11 @@ user_function (void user_function (NMClient *client, NMRemoteConnection *connection, - gpointer user_data) + gpointer user_data)

Notifies that a NMConnection has been removed.

Parameters

-
+
@@ -3824,20 +3824,20 @@ 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.

Parameters

-
+
@@ -3862,20 +3862,20 @@ 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.

Parameters

-
+
@@ -3900,20 +3900,20 @@ 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

-
+
@@ -3943,7 +3943,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

-- cgit 1.3.0-6-gf8a5