From 34bb501be08aa2b313d88e67d6e0a7e0a3f9cfa6 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Sun, 5 May 2024 00:07:30 +0200 Subject: New upstream version 1.47.90 --- docs/libnm/html/NMClient.html | 1034 ++++++++++++++++++++--------------------- 1 file changed, 517 insertions(+), 517 deletions(-) (limited to 'docs/libnm/html/NMClient.html') diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 7e923ca9..3c5f5d9c 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -45,7 +45,7 @@ -GQuark +GQuark nm_client_error_quark () @@ -90,7 +90,7 @@ -gboolean +gboolean nm_dns_entry_get_vpn () @@ -130,7 +130,7 @@ -GDBusConnection * +GDBusConnection * nm_client_get_dbus_connection () @@ -138,7 +138,7 @@ -GMainContext * +GMainContext * nm_client_get_main_context () @@ -146,7 +146,7 @@ -GObject * +GObject * nm_client_get_context_busy_watcher () @@ -167,7 +167,7 @@ -const guint32 * +const guint32 * nm_client_get_version_info () @@ -183,7 +183,7 @@ -gboolean +gboolean nm_client_get_startup () @@ -191,7 +191,7 @@ -gboolean +gboolean nm_client_get_nm_running () @@ -215,14 +215,14 @@ -gboolean +gboolean nm_client_networking_get_enabled () -const guint32 * +const guint32 * nm_client_get_capabilities () @@ -230,7 +230,7 @@ -gboolean +gboolean nm_client_networking_set_enabled () @@ -238,7 +238,7 @@ -gboolean +gboolean nm_client_wireless_get_enabled () @@ -254,7 +254,7 @@ -gboolean +gboolean nm_client_wireless_hardware_get_enabled () @@ -262,7 +262,7 @@ -gboolean +gboolean nm_client_wwan_get_enabled () @@ -278,7 +278,7 @@ -gboolean +gboolean nm_client_wwan_hardware_get_enabled () @@ -286,7 +286,7 @@ -gboolean +gboolean nm_client_wimax_get_enabled () @@ -302,7 +302,7 @@ -gboolean +gboolean nm_client_wimax_hardware_get_enabled () @@ -318,7 +318,7 @@ -gboolean +gboolean nm_client_connectivity_check_get_available () @@ -326,7 +326,7 @@ -gboolean +gboolean nm_client_connectivity_check_get_enabled () @@ -349,7 +349,7 @@ -gboolean +gboolean nm_client_get_logging () @@ -357,7 +357,7 @@ -gboolean +gboolean nm_client_set_logging () @@ -413,7 +413,7 @@ -gboolean +gboolean nm_client_save_hostname () @@ -429,21 +429,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 () @@ -466,7 +466,7 @@ -const GPtrArray * +const GPtrArray * nm_client_get_active_connections () @@ -538,7 +538,7 @@ -gboolean +gboolean nm_client_deactivate_connection () @@ -554,14 +554,14 @@ -gboolean +gboolean nm_client_deactivate_connection_finish () -const GPtrArray * +const GPtrArray * nm_client_get_connections () @@ -625,7 +625,7 @@ -gboolean +gboolean nm_client_load_connections () @@ -641,7 +641,7 @@ -gboolean +gboolean nm_client_load_connections_finish () @@ -649,7 +649,7 @@ -gboolean +gboolean nm_client_reload_connections () @@ -665,7 +665,7 @@ -gboolean +gboolean nm_client_reload_connections_finish () @@ -686,14 +686,14 @@ -const GPtrArray * +const GPtrArray * nm_client_get_dns_configuration () -const GPtrArray * +const GPtrArray * nm_client_get_checkpoints () @@ -725,7 +725,7 @@ -gboolean +gboolean nm_client_checkpoint_destroy_finish () @@ -741,7 +741,7 @@ -GHashTable * +GHashTable * nm_client_checkpoint_rollback_finish () @@ -757,7 +757,7 @@ -gboolean +gboolean nm_client_checkpoint_adjust_rollback_timeout_finish () @@ -773,7 +773,7 @@ -gboolean +gboolean nm_client_reload_finish () @@ -789,7 +789,7 @@ -GVariant * +GVariant * nm_client_dbus_call_finish () @@ -805,7 +805,7 @@ -gboolean +gboolean nm_client_dbus_set_property_finish () @@ -821,7 +821,7 @@ -gboolean +gboolean nm_utils_file_is_certificate () @@ -829,7 +829,7 @@ -gboolean +gboolean nm_utils_file_is_private_key () @@ -837,7 +837,7 @@ -gboolean +gboolean nm_utils_file_is_pkcs12 () @@ -853,7 +853,7 @@ -gboolean +gboolean nm_client_wait_shutdown_finish () @@ -879,36 +879,36 @@ -GPtrArray * +GPtrArray * active-connections Read -GPtrArray * +GPtrArray * all-devices Read -gboolean +gboolean can-modify Read -GArray * +GArray * capabilities Read -GPtrArray * +GPtrArray * checkpoints Read -GPtrArray * +GPtrArray * connections Read @@ -918,12 +918,12 @@ Read -gboolean +gboolean connectivity-check-available Read -gboolean +gboolean connectivity-check-enabled Read / Write @@ -935,7 +935,7 @@ -GDBusConnection * +GDBusConnection * dbus-connection Read / Write / Construct Only @@ -947,13 +947,13 @@ -GPtrArray * +GPtrArray * devices Read -GPtrArray * +GPtrArray * dns-configuration Read @@ -976,22 +976,22 @@ Read -guint +guint instance-flags Read / Write / Construct -guint +guint metered Read -gboolean +gboolean networking-enabled Read / Write -gboolean +gboolean nm-running Read @@ -1007,12 +1007,12 @@ Read -guint +guint radio-flags Read -gboolean +gboolean startup Read @@ -1029,37 +1029,37 @@ -GArray * +GArray * version-info 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 @@ -1078,47 +1078,47 @@ void active-connection-added -Run First +Run First void active-connection-removed -Run First +Run First 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 @@ -1338,7 +1338,7 @@ ╰── NMClientError GFlags ╰── NMClientInstanceFlags - GObject + GObject ╰── NMClient @@ -1346,7 +1346,7 @@

Implemented Interfaces

NMClient implements - GInitable and GAsyncInitable.

+ GInitable and GAsyncInitable.

Description

@@ -1355,7 +1355,7 @@ NMClient implements

Functions

nm_client_error_quark ()

-
GQuark
+
GQuark
 nm_client_error_quark (void);

 
Registers an error quark for NMClient if necessary.

 

@@ -1501,7 +1501,7 @@ nm_dns_entry_get_priority (
 
nm_dns_entry_get_vpn ()

-
gboolean
+
gboolean
 nm_dns_entry_get_vpn (NMDnsEntry *entry);

 
Gets whether the entry refers to VPN name servers.

 

@@ -1521,7 +1521,7 @@ nm_dns_entry_get_vpn (
 
Returns

-
 TRUE if the entry refers to VPN name servers

+
 TRUE if the entry refers to VPN name servers

 

 
Since: 1.6

 

@@ -1529,29 +1529,29 @@ nm_dns_entry_get_vpn (
 
nm_client_new ()

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

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

Creates a new NMClient synchronously.

Note that this will block until a NMClient instance is fully initialized. -This does nothing beside calling g_initable_new(). You are free to call -g_initable_new() or g_object_new()/g_initable_init() directly for more +This does nothing beside calling g_initable_new(). You are free to call +g_initable_new() or g_object_new()/g_initable_init() directly for more control, to set GObject properties or get access to the NMClient instance while it is still initializing.

Using the synchronous initialization creates an NMClient instance -that uses an internal GMainContext. This context is invisible to the +that uses an internal GMainContext. This context is invisible to the user. This introduces an additional overhead that is payed not only during object initialization, but for the entire lifetime of this object. -Also, due to this internal GMainContext, the events are no longer -in sync with other messages from GDBusConnection (but all events +Also, due to this internal GMainContext, the events are no longer +in sync with other messages from GDBusConnection (but all events of the NMClient will themselves still be ordered). For a serious program, you should therefore avoid these problems by -using g_async_initable_init_async() or nm_client_new_async() instead. +using g_async_initable_init_async() or nm_client_new_async() instead. The sync initialization is still useful for simple scripts or interactive testing for example via pygobject.

Creating an NMClient instance can only fail for two reasons. First, if you didn't -provide a NM_CLIENT_DBUS_CONNECTION and the call to g_bus_get() -fails. You can avoid that by using g_initable_new() directly and +provide a NM_CLIENT_DBUS_CONNECTION and the call to g_bus_get() +fails. You can avoid that by using g_initable_new() directly and set a D-Bus connection. Second, if you cancelled the creation. If you do that, then note that after the failure there might still be idle actions pending @@ -1571,12 +1571,12 @@ does not cause a failure.

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

 

error

-

location for a GError, or NULL

+

location for a GError, or NULL

  @@ -1591,20 +1591,20 @@ does not cause a failure.

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 asynchronously. callback will be called when it is done. Use nm_client_new_finish() to get the result.

-

This does nothing beside calling g_async_initable_new_async(). You are free to -call g_async_initable_new_async() or g_object_new()/g_async_initable_init_async() +

This does nothing beside calling g_async_initable_new_async(). You are free to +call g_async_initable_new_async() or g_object_new()/g_async_initable_init_async() directly for more control, to set GObject properties or get access to the NMClient instance while it is still initializing.

Creating an NMClient instance can only fail for two reasons. First, if you didn't -provide a NM_CLIENT_DBUS_CONNECTION and the call to g_bus_get() -fails. You can avoid that by using g_async_initable_new_async() directly and +provide a NM_CLIENT_DBUS_CONNECTION and the call to g_bus_get() +fails. You can avoid that by using g_async_initable_new_async() directly and set a D-Bus connection. Second, if you cancelled the creation. If you do that, then note that after the failure there might still be idle actions pending @@ -1624,7 +1624,7 @@ does not cause a failure.

cancellable

-

a GCancellable, or NULL

+

a GCancellable, or NULL

  @@ -1646,8 +1646,8 @@ does not cause a failure.

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

@@ -1660,12 +1660,12 @@ nm_client_new_finish (

result

-

a GAsyncResult

+

a GAsyncResult

 

error

-

location for a GError, or NULL

+

location for a GError, or NULL

  @@ -1673,7 +1673,7 @@ nm_client_new_finish (

Returns

-

a new NMClient, or NULL on error

+

a new NMClient, or NULL on error

@@ -1705,9 +1705,9 @@ nm_client_get_instance_flags (

nm_client_get_dbus_connection ()

-
GDBusConnection *
+
GDBusConnection *
 nm_client_get_dbus_connection (NMClient *client);

-
Gets the GDBusConnection of the instance. This can be either passed when
+
Gets the GDBusConnection of the instance. This can be either passed when
 constructing the instance (as "dbus-connection" property), or it will be
 automatically initialized during async/sync init.

 

@@ -1727,7 +1727,7 @@ automatically initialized during async/sync init.

 

 

 
Returns

-
the D-Bus connection of the client, or NULL if none is set. 

+
the D-Bus connection of the client, or NULL if none is set. 

 
[transfer none]

 

 
Since: 1.22

@@ -1735,10 +1735,10 @@ automatically initialized during async/sync init.

 

 

 
nm_client_get_main_context ()

-
GMainContext *
+
GMainContext *
 nm_client_get_main_context (NMClient *self);

 
The NMClient instance is permanently associated with the current
-thread default GMainContext, referenced the time when the instance
+thread default GMainContext, referenced the time when the instance
 was created. To receive events, the user must iterate this context
 and can use it to synchronize access to the client.

 
Note that even after NMClient instance got destroyed, there might
@@ -1762,7 +1762,7 @@ the 
 

 
Returns

-
the GMainContext of the client. 

+
the GMainContext of the client. 

 
[transfer none]

 

 
Since: 1.22

@@ -1770,7 +1770,7 @@ the 
 

 
nm_client_get_context_busy_watcher ()

-
GObject *
+
GObject *
 nm_client_get_context_busy_watcher (NMClient *self);

 

 
Parameters

@@ -1804,14 +1804,14 @@ GMainContext running to ensure everything is cleaned up? The answer is
 this GObject. Subscribe a weak reference to the returned object and keep
 iterating the main context until the object got unreferenced.

 
Note that after the NMClient instance gets destroyed, all outstanding operations
-will be cancelled right away. That means, the user needs to iterate the GMainContext
+will be cancelled right away. That means, the user needs to iterate the GMainContext
 a bit longer, but it is guaranteed that the cleanup happens soon after.

 
The way of using the context-busy-watch, is by registering a weak pointer to
 see when it gets destroyed. That means, user code should not take additional
 references on this object to not keep it alive longer.

 
If you plan to exit the program after releasing the NMClient instance
 you may not need to worry about these "leaks". Also, if you anyway plan to continue
-iterating the GMainContext afterwards, then you don't need to care when exactly
+iterating the GMainContext afterwards, then you don't need to care when exactly
 NMClient is gone completely. 

 
[transfer none]

 

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

 

 

 

 

 
nm_client_get_version_info ()

-
const guint32 *
+
const guint32 *
 nm_client_get_version_info (NMClient *client,
-                            gsize *length);

+                            gsize *length);

 
If available, the first element in the array is NM_VERSION which
 encodes the daemon version as "(major << 16 | minor << 8 | micro)".
 The following elements are a bitfield of NMVersionInfoCapabilities
@@ -1905,7 +1905,7 @@ that indicate that the daemon supports a certain capability.

 

 
Returns

 
the
-list of capabilities reported by the server or NULL
+list of capabilities reported by the server or NULL
 if the capabilities are unknown. 

 
[transfer none][array length=length]

 

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

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

 

 

 
nm_client_get_nm_running ()

-
gboolean
+
gboolean
 nm_client_get_nm_running (NMClient *client);

 
Determines whether the daemon is running.

 

@@ -1987,7 +1987,7 @@ nm_client_get_nm_running (
 
Returns

-
 TRUE if the daemon is running

+
 TRUE if the daemon is running

 

 

 

@@ -2022,7 +2022,7 @@ nm_client_get_object_by_path (
Returns

 
the NMObject instance that is
 cached under dbus_path
-, or NULL if no such object exists. 

+, or NULL if no such object exists. 

 
[transfer none]

 

 
Since: 1.24

@@ -2056,7 +2056,7 @@ nm_client_get_metered (
 
nm_client_networking_get_enabled ()

-
gboolean
+
gboolean
 nm_client_networking_get_enabled (NMClient *client);

 
Whether networking is enabled or disabled.

 

@@ -2076,15 +2076,15 @@ 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_get_capabilities ()

-
const guint32 *
+
const guint32 *
 nm_client_get_capabilities (NMClient *client,
-                            gsize *length);

+                            gsize *length);

 

 
Parameters

 

@@ -2110,7 +2110,7 @@ nm_client_get_capabilities (
 
Returns

 
the
-list of capabilities reported by the server or NULL
+list of capabilities reported by the server or NULL
 if the capabilities are unknown.
 The numeric values correspond to NMCapability enum.
 The array is terminated by a numeric zero sentinel
@@ -2123,10 +2123,10 @@ at position length
 

 

 
nm_client_networking_set_enabled ()

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

+                                  gboolean enabled,
+                                  GError **error);

 

 
nm_client_networking_set_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_call() on NM_DBUS_PATH,
@@ -2151,12 +2151,12 @@ all controlled interfaces are available for activation.

 
 

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

 

@@ -2190,7 +2190,7 @@ nm_client_wireless_get_enabled (
 

 
Returns

-
 TRUE if wireless is enabled

+
 TRUE if wireless is enabled

 

 

 

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

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

+                                gboolean enabled);

 

 
nm_client_wireless_set_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_set_property() on NM_DBUS_PATH,
@@ -2221,7 +2221,7 @@ nm_client_wireless_set_enabled (
 

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

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

 

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

-
 TRUE if WWAN is enabled

+
 TRUE if WWAN is enabled

 

 

 

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

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

+                            gboolean enabled);
 

 
nm_client_wwan_set_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_set_property() on NM_DBUS_PATH,
@@ -2309,7 +2309,7 @@ nm_client_wwan_set_enabled (
enabled

-

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

 

@@ -2339,13 +2339,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);

 

 
nm_client_wimax_get_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

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

-
 TRUE if WiMAX is enabled

+
 TRUE if WiMAX is enabled

 

 

 

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

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

+                             gboolean enabled);

 

 
nm_client_wimax_set_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

 
This function does nothing because WiMax is no longer supported.

@@ -2399,7 +2399,7 @@ nm_client_wimax_set_enabled (
enabled

-

+
@@ -2409,7 +2409,7 @@ nm_client_wimax_set_enabled (
 
nm_client_wimax_hardware_get_enabled ()

-
gboolean
+
gboolean
 nm_client_wimax_hardware_get_enabled (NMClient *client);

 

 
nm_client_wimax_hardware_get_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

@@ -2433,7 +2433,7 @@ nm_client_wimax_hardware_get_enabled (
 
Returns

-
 TRUE if the WiMAX hardware is enabled

+
 TRUE if the WiMAX hardware is enabled

 

 
 

@@ -2466,7 +2466,7 @@ nm_client_get_radio_flags (
 
nm_client_connectivity_check_get_available ()

-
gboolean
+
gboolean
 nm_client_connectivity_check_get_available
                                (NMClient *client);

 
Determine whether connectivity checking is available.  This
@@ -2489,14 +2489,14 @@ configuration file.

 
 

 
Returns

-
 TRUE if connectivity checking is available.

+
 TRUE if connectivity checking is available.

 

 
Since: 1.10

 
 

 

 
nm_client_connectivity_check_get_enabled ()

-
gboolean
+
gboolean
 nm_client_connectivity_check_get_enabled
                                (NMClient *client);

 
Determine whether connectivity checking is enabled.

@@ -2517,7 +2517,7 @@ nm_client_connectivity_check_get_enabled
 

 

 
Returns

-
 TRUE if connectivity checking is enabled.

+
 TRUE if connectivity checking is enabled.

 

 
Since: 1.10

 
@@ -2527,7 +2527,7 @@ nm_client_connectivity_check_get_enabled
 
void
 nm_client_connectivity_check_set_enabled
                                (NMClient *client,
-                                gboolean enabled);

+                                gboolean enabled);

 

 
nm_client_connectivity_check_set_enabled has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_set_property() on NM_DBUS_PATH,
@@ -2552,7 +2552,7 @@ have any effect.

 
 

-
+
@@ -2592,11 +2592,11 @@ connectivity.

 

 

 
nm_client_get_logging ()

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

+                       GError **error);

 

 
nm_client_get_logging has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_call() on NM_DBUS_PATH,
@@ -2631,7 +2631,7 @@ a list of domains separated by ",". 

 
 

-
+
@@ -2639,17 +2639,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);

 

 
nm_client_set_logging has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use the async command nm_client_dbus_call() on NM_DBUS_PATH,
@@ -2672,18 +2672,18 @@ nm_client_set_logging (
level

-

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

 
-
+
@@ -2691,7 +2691,7 @@ domains separated by ",". (
 
Returns

-
 TRUE on success, FALSE otherwise

+
 TRUE on success, FALSE otherwise

 
 
 

@@ -2794,8 +2794,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);
 

 
nm_client_check_connectivity has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use nm_client_check_connectivity_async() or GDBusConnection.

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

 
 

-
+
-
+
@@ -2842,9 +2842,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(),
@@ -2866,7 +2866,7 @@ re-checking, and 
cancellable

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

 

@@ -2909,12 +2909,12 @@ call.

 

-
+
-
+
@@ -2928,11 +2928,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);

 

 
nm_client_save_hostname has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use nm_client_save_hostname_async() or GDBusConnection.

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

 
 

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

 

 
 

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

 

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

 
 

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

@@ -3052,12 +3052,12 @@ nm_client_save_hostname_finish (
 

-
+
-
+
@@ -3065,13 +3065,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
@@ -3094,7 +3094,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]

@@ -3103,7 +3103,7 @@ containing all the NMDevices.  The returned array is o
 

 

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

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

 

 

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

 

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

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

 

 
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

  
 

 

 
enabled
TRUE to enable wireless
TRUE to enable wireless

  
 

 
TRUE to enable WWAN
TRUE to enable WWAN

  
 

 
TRUE to enable WiMAX
TRUE to enable WiMAX

  
 

 

 
enabled
TRUE to enable connectivity checking
TRUE to enable connectivity checking

  
 

 

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

  
 

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

 [nullable]
 

 

 
domains

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

 

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

  
 

 

 
cancellable
a GCancellable
a GCancellable

  
 

 

 
error
return location for a GError
return location for a GError

  
 

 
a GCancellable
a GCancellable

  
 

 

 

 
result
the GAsyncResult
the GAsyncResult

  
 

 

 
error
return location for a GError
return location for a GError

  
 

 

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

 [nullable]
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

 
error
return location for GError
return location for GError

  
 

 

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

 [nullable]
 

 

 
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

  
 

 

@@ -3312,9 +3312,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
@@ -3361,7 +3361,7 @@ track the activation to its completion.

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

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

-

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

@@ -3441,9 +3441,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
@@ -3470,7 +3470,7 @@ track the activation to its completion.

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

 
-
+
@@ -3520,8 +3520,8 @@ If the variant is floating, it will be consumed. 

 
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.

@@ -3541,12 +3541,12 @@ nm_client_add_and_activate_connection_finish
 
-
+
-
+
@@ -3554,7 +3554,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]

@@ -3569,10 +3569,10 @@ nm_client_add_and_activate_connection2
                                 NMConnection *partial,
                                 NMDevice *device,
                                 const char *specific_object,
-                                GVariant *options,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);
+                                GVariant *options,
+                                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
@@ -3612,7 +3612,7 @@ by the daemon:

 

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

 
-
+
-
+
@@ -3667,9 +3667,9 @@ details of the newly added connection. 

 
NMActiveConnection *
 nm_client_add_and_activate_connection2_finish
                                (NMClient *client,
-                                GAsyncResult *result,
-                                GVariant **out_result,
-                                GError **error);

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

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

@@ -3689,12 +3689,12 @@ nm_client_add_and_activate_connection2_finish
 
-
+
-
+
@@ -3709,7 +3709,7 @@ output is implemented yet. 

 
 

 
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]

@@ -3719,11 +3719,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);

 

 
nm_client_deactivate_connection has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use nm_client_deactivate_connection_async() or GDBusConnection.

@@ -3750,12 +3750,12 @@ nm_client_deactivate_connection (
 

-
+
-
+
@@ -3772,9 +3772,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

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

-

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

@@ -3840,12 +3840,12 @@ nm_client_deactivate_connection_finish
 

-
+
-
+
@@ -3859,7 +3859,7 @@ nm_client_deactivate_connection_finish
 

 

 
nm_client_get_connections ()

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

 

 
Parameters

@@ -3918,7 +3918,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(). 

@@ -3957,7 +3957,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(). 

@@ -3996,7 +3996,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(). 

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

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

 
 

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

@@ -4099,12 +4099,12 @@ nm_client_add_connection_finish (
 

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

@@ -4123,13 +4123,13 @@ will be set. 

 
nm_client_add_connection2 ()

 
void
 nm_client_add_connection2 (NMClient *client,
-                           GVariant *settings,
+                           GVariant *settings,
                            NMSettingsAddConnection2Flags flags,
-                           GVariant *args,
-                           gboolean ignore_out_result,
-                           GCancellable *cancellable,
-                           GAsyncReadyCallback callback,
-                           gpointer user_data);

+                           GVariant *args,
+                           gboolean ignore_out_result,
+                           GCancellable *cancellable,
+                           GAsyncReadyCallback callback,
+                           gpointer user_data);
 
Call AddConnection2() D-Bus API asynchronously.

 

 
Parameters

@@ -4147,7 +4147,7 @@ nm_client_add_connection2 (
settings

-

+
@@ -4157,24 +4157,24 @@ nm_client_add_connection2 (
args

-
-
+
@@ -4198,9 +4198,9 @@ under the hood always calls AddConnection2().
<
 
nm_client_add_connection2_finish ()

 
NMRemoteConnection *
 nm_client_add_connection2_finish (NMClient *client,
-                                  GAsyncResult *result,
-                                  GVariant **out_result,
-                                  GError **error);

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

 
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
@@ -3371,7 +3371,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
+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
@@ -3496,7 +3496,7 @@ If the variant is floating, it will be consumed. 

 

 

 
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

  
 

 

 
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
 (i.e., no specific object).  For Wi-Fi or WiMAX connections, pass the object
 path of a NMAccessPoint or NMWimaxNsp owned by device
 , which you can
@@ -3637,12 +3637,12 @@ details of the newly added connection. 

 

 

 
options
a GVariant containing a dictionary with options, or NULL
a GVariant containing a dictionary with options, 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

  
 

 

 
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

  
 

 
the "a{sa{sv}}" GVariant with the content of the setting.
the "a{sa{sv}}" GVariant with the content of the setting.

  
 

 
the "a{sv}" GVariant with extra argument or NULL
+
the "a{sv}" GVariant with extra argument or NULL
 for no extra arguments. 

 [nullable]
 

 

 
ignore_out_result

 
this function wraps AddConnection2(), which has an
-additional result "a{sv}" output parameter. By setting this to TRUE,
+additional result "a{sv}" output parameter. By setting this to TRUE,
 you signal that you are not interested in that output parameter.
 This allows the function to fall back to AddConnection() and AddConnectionUnsaved(),
 which is interesting if you run against an older server version that does
-not yet provide AddConnection2(). By setting this to FALSE, the function
+not yet provide AddConnection2(). By setting this to FALSE, the function
 under the hood always calls AddConnection2().

  
 

 

 
cancellable
a GCancellable, or NULL
a GCancellable, or NULL

  
 

 

@@ -4217,15 +4217,15 @@ nm_client_add_connection2_finish (
 
-
+
+parameter of nm_client_add_connection2() must not be set to TRUE. 

 
@@ -4247,12 +4247,12 @@ parameter of 
 

 
nm_client_load_connections ()

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

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

 

 
nm_client_load_connections has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use nm_client_load_connections_async() or GDBusConnection.

@@ -4263,11 +4263,11 @@ adding or updating the connections described within.

 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

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

 

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

 
 

 
Returns

-
 TRUE on success.

+
 TRUE on success.

 
Warning: before libnm 1.22, the boolean return value was inconsistent.
 That is made worse, because when running against certain server versions
 before 1.20, the server would return wrong values for success/failure.
@@ -4330,9 +4330,9 @@ With 1.22, the return value is consistent with 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.

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

 
 

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

 

@@ -4402,17 +4402,17 @@ nm_client_load_connections_finish (
 

+NULL-terminated array of filenames that failed to load. 

 
-
+
-
+
@@ -4420,7 +4420,7 @@ nm_client_load_connections_finish (
 

 
Returns

-
 TRUE on success.
+
 TRUE on success.
 Note that even in the success case, you might have individual failures
 .

 

@@ -4428,10 +4428,10 @@ Note that even in the success case, you might have individual 
 
nm_client_reload_connections ()

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

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

 

 
nm_client_reload_connections has been deprecated since version 1.22 and should not be used in newly-written code.

 
Use nm_client_reload_connections_async() or GDBusConnection.

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

 
 

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

 
 

 
Returns

-
 TRUE on success, FALSE on failure

+
 TRUE on success, FALSE on failure

 

 
 

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

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

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

@@ -4540,12 +4540,12 @@ nm_client_reload_connections_finish (
 

-
+
-
+
@@ -4553,7 +4553,7 @@ nm_client_reload_connections_finish (
 

 
Returns

-
 TRUE on success, FALSE on failure

+
 TRUE on success, FALSE on failure

 

 
 

@@ -4579,7 +4579,7 @@ nm_client_get_dns_mode (
 
Returns

-
 the DNS processing mode, or NULL in case the
+
 the DNS processing mode, or NULL in case the
 value is not available.

 
 
Since: 1.6

@@ -4607,7 +4607,7 @@ nm_client_get_dns_rc_manager (
 
Returns

-
 the resolv.conf manager or NULL in case the
+
 the resolv.conf manager or NULL in case the
 value is not available.

 
 
Since: 1.6

@@ -4615,7 +4615,7 @@ value is not available.

 

 

 
nm_client_get_dns_configuration ()

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

 
Gets the current DNS configuration

 

@@ -4635,8 +4635,8 @@ nm_client_get_dns_configuration (
 

 
Returns

-
a GPtrArray
-containing NMDnsEntry elements or NULL in case the value is not
+
a GPtrArray
+containing NMDnsEntry elements or NULL in case the value is not
 available.  The returned array is owned by the NMClient object
 and should not be modified. 

 
[transfer none][element-type NMDnsEntry]

@@ -4646,7 +4646,7 @@ and should not be modified. 

 

 

 
nm_client_get_checkpoints ()

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

 
Gets all the active checkpoints.

 

@@ -4666,7 +4666,7 @@ nm_client_get_checkpoints (
 
Returns

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

 
[transfer none][element-type NMCheckpoint]

@@ -4678,12 +4678,12 @@ containing all the 
nm_client_checkpoint_create ()

 
void
 nm_client_checkpoint_create (NMClient *client,
-                             const GPtrArray *devices,
-                             guint32 rollback_timeout,
+                             const GPtrArray *devices,
+                             guint32 rollback_timeout,
                              NMCheckpointCreateFlags flags,
-                             GCancellable *cancellable,
-                             GAsyncReadyCallback callback,
-                             gpointer user_data);

+                             GCancellable *cancellable,
+                             GAsyncReadyCallback callback,
+                             gpointer user_data);

 
Creates a checkpoint of the current networking configuration
 for given interfaces. An empty devices
  argument means all
@@ -4722,7 +4722,7 @@ checkpoint should be created. 

 
 

-
+
@@ -4746,8 +4746,8 @@ checkpoint should be created. 

 
nm_client_checkpoint_create_finish ()

 
NMCheckpoint *
 nm_client_checkpoint_create_finish (NMClient *client,
-                                    GAsyncResult *result,
-                                    GError **error);

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

 

 
Parameters

@@ -4765,12 +4765,12 @@ nm_client_checkpoint_create_finish (
 

-
+
-
+
@@ -4778,7 +4778,7 @@ nm_client_checkpoint_create_finish (
 

 
Returns

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

 
[transfer full]

@@ -4791,9 +4791,9 @@ will be set. 

 
void
 nm_client_checkpoint_destroy (NMClient *client,
                               const char *checkpoint_path,
-                              GCancellable *cancellable,
-                              GAsyncReadyCallback callback,
-                              gpointer user_data);

+                              GCancellable *cancellable,
+                              GAsyncReadyCallback callback,
+                              gpointer user_data);
 
Destroys an existing checkpoint without performing a rollback.

 

 
Parameters

@@ -4816,7 +4816,7 @@ nm_client_checkpoint_destroy (
cancellable

-

+
@@ -4838,10 +4838,10 @@ nm_client_checkpoint_destroy (
 
nm_client_checkpoint_destroy_finish ()

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

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

 
Gets the result of a call to nm_client_checkpoint_destroy().

 

 
Parameters

@@ -4859,12 +4859,12 @@ nm_client_checkpoint_destroy_finish (
 

-
+
-
+
@@ -4872,7 +4872,7 @@ nm_client_checkpoint_destroy_finish (
 

 
Returns

-
 TRUE on success or FALSE on failure, in which case
+
 TRUE on success or FALSE on failure, in which case
 error
 will be set.

 

@@ -4884,9 +4884,9 @@ will be set.

 
void
 nm_client_checkpoint_rollback (NMClient *client,
                                const char *checkpoint_path,
-                               GCancellable *cancellable,
-                               GAsyncReadyCallback callback,
-                               gpointer user_data);

+                               GCancellable *cancellable,
+                               GAsyncReadyCallback callback,
+                               gpointer user_data);
 
Performs the rollback of a checkpoint before the timeout is reached.

 

 
Parameters

@@ -4909,7 +4909,7 @@ nm_client_checkpoint_rollback (
 

-
+
@@ -4931,10 +4931,10 @@ nm_client_checkpoint_rollback (
 

 
nm_client_checkpoint_rollback_finish ()

-
GHashTable *
+
GHashTable *
 nm_client_checkpoint_rollback_finish (NMClient *client,
-                                      GAsyncResult *result,
-                                      GError **error);

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

 
Gets the result of a call to nm_client_checkpoint_rollback().

 

 
Parameters

@@ -4952,12 +4952,12 @@ nm_client_checkpoint_rollback_finish (
result

-

+
-
+
@@ -4979,10 +4979,10 @@ D-Bus path; each result is a NMClient *client,
                                 const char *checkpoint_path,
-                                guint32 add_timeout,
-                                GCancellable *cancellable,
-                                GAsyncReadyCallback callback,
-                                gpointer user_data);
+                                guint32 add_timeout,
+                                GCancellable *cancellable,
+                                GAsyncReadyCallback callback,
+                                gpointer user_data);
 
Resets the timeout for the checkpoint with path checkpoint_path
 
 to timeout_add
@@ -5014,7 +5014,7 @@ Set to zero, to disable the timeout.

 
 
-
+
@@ -5036,11 +5036,11 @@ Set to zero, to disable the timeout.

 

 

 
nm_client_checkpoint_adjust_rollback_timeout_finish ()

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

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

 
Gets the result of a call to nm_client_checkpoint_adjust_rollback_timeout().

 

 
Parameters

@@ -5058,12 +5058,12 @@ nm_client_checkpoint_adjust_rollback_timeout_finish
 

-
+
-
+
@@ -5071,7 +5071,7 @@ nm_client_checkpoint_adjust_rollback_timeout_finish
 
 

 
Returns

-
 TRUE on success or FALSE on failure.

+
 TRUE on success or FALSE on failure.

 

 
Since: 1.12

 
@@ -5081,9 +5081,9 @@ nm_client_checkpoint_adjust_rollback_timeout_finish
 
void
 nm_client_reload (NMClient *client,
                   NMManagerReloadFlags flags,
-                  GCancellable *cancellable,
-                  GAsyncReadyCallback callback,
-                  gpointer user_data);

+                  GCancellable *cancellable,
+                  GAsyncReadyCallback callback,
+                  gpointer user_data);
 
Reload NetworkManager's configuration and perform certain updates, like
 flushing caches or rewriting external state to disk. This is similar to
 sending SIGHUP to NetworkManager but it allows for more fine-grained control
@@ -5111,7 +5111,7 @@ PolicyKit and contrary to signals it is synchronous.

 
 
-
+
@@ -5133,10 +5133,10 @@ PolicyKit and contrary to signals it is synchronous.

 

 

 
nm_client_reload_finish ()

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

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

 
Gets the result of a call to nm_client_reload().

 

 
Parameters

@@ -5154,12 +5154,12 @@ nm_client_reload_finish (
result

-

+
-
+
@@ -5167,7 +5167,7 @@ nm_client_reload_finish (
 
Returns

-
 TRUE on success or FALSE on failure.

+
 TRUE on success or FALSE on failure.

 
 
Since: 1.22

 
@@ -5179,19 +5179,19 @@ nm_client_dbus_call (const char *object_path,
                      const char *interface_name,
                      const char *method_name,
-                     GVariant *parameters,
-                     const GVariantType *reply_type,
+                     GVariant *parameters,
+                     const GVariantType *reply_type,
                      int timeout_msec,
-                     GCancellable *cancellable,
-                     GAsyncReadyCallback callback,
-                     gpointer user_data);
-
Call g_dbus_connection_call() on the current name owner with the specified
-arguments. Most importantly, this invokes g_dbus_connection_call() with the
-client's GMainContext, so that the response is always in order with other
-events D-Bus events. Of course, the call uses GTask and will invoke the
-callback on the current g_main_context_get_thread_default().

-
This API is merely a convenient wrapper for g_dbus_connection_call(). You can
-also use g_dbus_connection_call() directly, with the same effect.

+                     GCancellable *cancellable,
+                     GAsyncReadyCallback callback,
+                     gpointer user_data);
+
Call g_dbus_connection_call() on the current name owner with the specified
+arguments. Most importantly, this invokes g_dbus_connection_call() with the
+client's GMainContext, so that the response is always in order with other
+events D-Bus events. Of course, the call uses GTask and will invoke the
+callback on the current g_main_context_get_thread_default().

+
This API is merely a convenient wrapper for g_dbus_connection_call(). You can
+also use g_dbus_connection_call() directly, with the same effect.

 

 
Parameters

 

 
result
the GAsyncResult
the GAsyncResult

  
 

 

 
out_result

 
the output
-GVariant from AddConnection2().
+GVariant from AddConnection2().
 If you care about the output result, then the "ignore_out_result"
-parameter of nm_client_add_connection2() must not be set to TRUE. 
[out][optional][nullable][transfer full]
 

 

 

 
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

  
 

 

 
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

  
 

 
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

  
 

 

 
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

  
 

 

 
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

  
 

 
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

  
 

 
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

  
 

 

 
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

  
 

 

@@ -5223,31 +5223,31 @@ also use 
parameters

-
+
+tuple), or NULL. 

 
+timeout or G_MAXINT for no timeout

 
-
+
-
@@ -5265,10 +5265,10 @@ method invocation. 

 

 

 
nm_client_dbus_call_finish ()

-
GVariant *
+
GVariant *
 nm_client_dbus_call_finish (NMClient *client,
-                            GAsyncResult *result,
-                            GError **error);

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

 
Gets the result of a call to nm_client_dbus_call().

 

 
Parameters

@@ -5286,12 +5286,12 @@ nm_client_dbus_call_finish (
result

-

+
-
+
@@ -5299,7 +5299,7 @@ nm_client_dbus_call_finish (
 
Returns

-
the result GVariant or NULL on error. 

+
the result GVariant or NULL on error. 

 
[transfer full]

 
 
Since: 1.24

@@ -5312,11 +5312,11 @@ nm_client_dbus_set_property (const char *object_path,
                              const char *interface_name,
                              const char *property_name,
-                             GVariant *value,
+                             GVariant *value,
                              int timeout_msec,
-                             GCancellable *cancellable,
-                             GAsyncReadyCallback callback,
-                             gpointer user_data);
+                             GCancellable *cancellable,
+                             GAsyncReadyCallback callback,
+                             gpointer user_data);
 
Like nm_client_dbus_call() but calls "Set" on the standard "org.freedesktop.DBus.Properties"
 D-Bus interface.

 

@@ -5350,24 +5350,24 @@ D-Bus interface.

 
 

-
+
+timeout or G_MAXINT for no timeout

 
-
+
-
@@ -5385,10 +5385,10 @@ method invocation. 

 

 

 
nm_client_dbus_set_property_finish ()

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

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

 
Gets the result of a call to nm_client_dbus_set_property().

 

 
Parameters

@@ -5406,12 +5406,12 @@ nm_client_dbus_set_property_finish (
 

-
+
-
+
@@ -5419,7 +5419,7 @@ nm_client_dbus_set_property_finish (
 

 
Returns

-
 TRUE on success or FALSE on failure.

+
 TRUE on success or FALSE on failure.

 

 
Since: 1.24

 
@@ -5429,10 +5429,10 @@ nm_client_dbus_set_property_finish (void
 nm_utils_print (int output_mode,
                 const char *msg);
-
The only purpose of this function is to give access to g_print()
-or g_printerr() from pygobject. libnm can do debug logging by
-setting LIBNM_CLIENT_DEBUG and uses thereby g_printerr() or
-g_print(). A plain "print()" function in python is not in sync
+
The only purpose of this function is to give access to g_print()
+or g_printerr() from pygobject. libnm can do debug logging by
+setting LIBNM_CLIENT_DEBUG and uses thereby g_printerr() or
+g_print(). A plain "print()" function in python is not in sync
 with these functions (it implements additional buffering). By
 using nm_utils_print(), the same logging mechanisms can be used.

 
LIBNM_CLIENT_DEBUG is a list of keywords separated by commas. The keyword
@@ -5440,7 +5440,7 @@ using g_critical() and WARN messages with g_warning(). Together with G_DEBUG="fatal-warnings"
+g_critical() and WARN messages with g_warning(). Together with G_DEBUG="fatal-warnings"
 or G_DEBUG="fatal-critical" this can be used to abort the program on errors.
 Note that all <error> messages imply an unexpected data on the D-Bus API
 (due to a bug). <warn> also implies unexepected data, but that can happen
@@ -5465,10 +5465,10 @@ are supported since 1.46.

 
-
@@ -5486,7 +5486,7 @@ a trailing newline.

 

 

 
nm_utils_file_is_certificate ()

-
gboolean
+
gboolean
 nm_utils_file_is_certificate (const char *filename);

 
Tests if filename
  has a valid extension for an X.509 certificate file
@@ -5509,15 +5509,15 @@ recognized by NetworkManager.

 

 

 
Returns

-
 TRUE if the file is a certificate, FALSE if it is not

+
 TRUE if the file is a certificate, FALSE if it is not

 

 
 

 

 
nm_utils_file_is_private_key ()

-
gboolean
+
gboolean
 nm_utils_file_is_private_key (const char *filename,
-                              gboolean *out_encrypted);

+                              gboolean *out_encrypted);

 
Tests if filename
  has a valid extension for an X.509 private key file
 (".der", ".key", ".pem", or ".p12"), and contains a private key in a format
@@ -5546,13 +5546,13 @@ recognized by NetworkManager.

 

 

 
Returns

-
 TRUE if the file is a private key, FALSE if it is not

+
 TRUE if the file is a private key, FALSE if it is not

 

 
 

 

 
nm_utils_file_is_pkcs12 ()

-
gboolean
+
gboolean
 nm_utils_file_is_pkcs12 (const char *filename);

 
Tests if filename
  is a PKCS#12 file.

@@ -5573,7 +5573,7 @@ nm_utils_file_is_pkcs12 (const ch
 

 

 
Returns

-
 TRUE if the file is PKCS#12, FALSE if it is not

+
 TRUE if the file is PKCS#12, FALSE if it is not

 

 
 

@@ -5581,10 +5581,10 @@ nm_utils_file_is_pkcs12 (const ch
 
nm_client_wait_shutdown ()

 
void
 nm_client_wait_shutdown (NMClient *client,
-                         gboolean integrate_maincontext,
-                         GCancellable *cancellable,
-                         GAsyncReadyCallback callback,
-                         gpointer user_data);

+                         gboolean integrate_maincontext,
+                         GCancellable *cancellable,
+                         GAsyncReadyCallback callback,
+                         gpointer user_data);
 
The way to stop NMClient is by unrefing it. That will cancel all
 internally pending async operations. However, as async operations in
 NMClient use GTask, hence they cannot complete right away. Instead,
@@ -5594,22 +5594,22 @@ the client's main context.

 everything is wrapped up. nm_client_get_context_busy_watcher()
 helps to watch how long that will be.

 
This function automates that waiting. Like all glib async operations
-this honors the current g_main_context_get_thread_default().

+this honors the current g_main_context_get_thread_default().

 
In any case, to complete the shutdown, nm_client_get_main_context()
-must be iterated. If the current g_main_context_get_thread_default() is
+must be iterated. If the current g_main_context_get_thread_default() is
 the same as nm_client_get_main_context(), then integrate_maincontext
 
 is ignored. In that case, the caller is required to iterate the context
-for shutdown to complete. Otherwise, if g_main_context_get_thread_default()
+for shutdown to complete. Otherwise, if g_main_context_get_thread_default()
 differs from nm_client_get_main_context() and integrate_maincontext
 
-is FALSE, the caller must make sure that both contexts are iterated
+is FALSE, the caller must make sure that both contexts are iterated
 until completion. Otherwise, if integrate_maincontext
- is TRUE, then
-nm_client_get_main_context() will be integrated in g_main_context_get_thread_default().
+ is TRUE, then
+nm_client_get_main_context() will be integrated in g_main_context_get_thread_default().
 This means, the caller gives nm_client_get_main_context() up until the waiting
 completes, the function will acquire the context and hook it into
-g_main_context_get_thread_default().
+g_main_context_get_thread_default().
 It is a bug to request integrate_maincontext
  while having nm_client_get_main_context()
 acquired or iterated otherwise because a context can only be acquired once
@@ -5627,7 +5627,7 @@ The latter case is useful if the client has a separate context and you hand it
 over to another GMainContext to wrap up.

 
The main use is to have a NMClient and a separate GMainContext on a worker
 thread. When being done, you can hand over the cleanup of the context
-to g_main_context_default(), assuming that the main thread iterates
+to g_main_context_default(), assuming that the main thread iterates
 the default context. In that case, you don't need to care about passing
 a callback to know when shutdown completed.

 

@@ -5655,13 +5655,13 @@ may instead only iterate the latter.

 
 

-
+
-
@@ -5679,9 +5679,9 @@ method invocation.

 

 

 
nm_client_wait_shutdown_finish ()

-
gboolean
-nm_client_wait_shutdown_finish (GAsyncResult *result,
-                                GError **error);

+
gboolean
+nm_client_wait_shutdown_finish (GAsyncResult *result,
+                                GError **error);

 

 
Parameters

 
a GVariant tuple with parameters for the method
-or NULL if not passing parameters. 
a GVariant tuple with parameters for the method
+or NULL if not passing parameters. 

 [nullable]
 

 

 
reply_type

 
the expected type of the reply (which will be a
-tuple), or NULL. 
[nullable]
 

 

 
timeout_msec

 
the timeout in milliseconds, -1 to use the default
-timeout or G_MAXINT for no timeout
 
 

 

 
cancellable
a GCancellable or NULL. 
a GCancellable or NULL. 

 [nullable]
 

 

 
callback
a GAsyncReadyCallback to call when the request
-is satisfied or NULL if you don't care about the result of the
+
a GAsyncReadyCallback to call when the request
+is satisfied or NULL if you don't care about the result of the
 method invocation. 

 [nullable]
 
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

  
 

 

 
value
a GVariant with the value to set.
a GVariant with the value to set.

  
 

 

 
timeout_msec

 
the timeout in milliseconds, -1 to use the default
-timeout or G_MAXINT for no timeout
 
 

 

 
cancellable
a GCancellable or NULL. 
a GCancellable or NULL. 

 [nullable]
 

 

 
callback
a GAsyncReadyCallback to call when the request
-is satisfied or NULL if you don't care about the result of the
+
a GAsyncReadyCallback to call when the request
+is satisfied or NULL if you don't care about the result of the
 method invocation. 

 [nullable]
 

 
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

  
 

 
 

 
output_mode
if 1 it uses g_print(). If 2, it uses g_printerr().
+
if 1 it uses g_print(). If 2, it uses g_printerr().
 If 0, it uses the same output as internal libnm debug logging
 does. That is, depending on LIBNM_CLIENT_DEBUG's "stdout" flag
-it uses g_print() or g_printerr() and if LIBNM_CLIENT_DEBUG_FILE is
+it uses g_print() or g_printerr() and if LIBNM_CLIENT_DEBUG_FILE is
 set, it writes the output to file instead

  
 

 
cancellable
the GCancellable to abort the shutdown.
the GCancellable to abort the shutdown.

  
 

 

 
callback
a GAsyncReadyCallback to call when the request
-is satisfied or NULL if you don't care about the result of the
+
a GAsyncReadyCallback to call when the request
+is satisfied or NULL if you don't care about the result of the
 method invocation.

  
 

@@ -5693,12 +5693,12 @@ nm_client_wait_shutdown_finish (
result

-
+
-
+
@@ -5706,7 +5706,7 @@ nm_client_wait_shutdown_finish (
 
Returns

-
 TRUE if waiting is complete successfully. In that case, all resources of the
+
 TRUE if waiting is complete successfully. In that case, all resources of the
 nmclient are wrapped up and released. This can only fail by user cancellation.

 
 
Since: 1.42

@@ -6093,10 +6093,10 @@ operation succeeded, but the object that was allegedly created (eg,
 
NMClient

 
typedef struct _NMClient NMClient;

 
NMClient contains a cache of the objects of NetworkManager's D-Bus API.
-It uses GMainContext and GDBusConnection for that and registers to
-D-Bus signals. That means, when iterating the associated GMainContext,
+It uses GMainContext and GDBusConnection for that and registers to
+D-Bus signals. That means, when iterating the associated GMainContext,
 D-Bus signals gets processed and the NMClient instance updates and
-emits GObject signals.

+emits GObject signals.

 
 

 

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

-
  “active-connections”       GPtrArray *

+
  “active-connections”       GPtrArray *

 
The active connections.

 
[type GPtrArray(NMActiveConnection)]

 
Owner: NMClient

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

-
  “all-devices”              GPtrArray *

+
  “all-devices”              GPtrArray *

 
List of both real devices and device placeholders.

 
[type GPtrArray(NMDevice)]

 
Owner: NMClient

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

 
Owner: NMClient

 
Flags: Read

 
Default value: FALSE

@@ -6146,8 +6146,8 @@ likely to become the new 
 
The “capabilities” property

-
  “capabilities”             GArray *

-
The list of capabilities numbers as guint32 or NULL if
+
  “capabilities”             GArray *

+
The list of capabilities numbers as guint32 or NULL if
 there are no capabilities. The numeric value correspond
 to NMCapability enum.

 
[type GArray(guint32)]

@@ -6158,7 +6158,7 @@ to 
 
The “checkpoints” property

-
  “checkpoints”              GPtrArray *

+
  “checkpoints”              GPtrArray *

 
The list of active checkpoints.

 
[type GPtrArray(NMCheckpoint)]

 
Owner: NMClient

@@ -6168,7 +6168,7 @@ to 
 
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
@@ -6189,7 +6189,7 @@ permission to read the details of.)

 

 

 
The “connectivity-check-available” property

-
  “connectivity-check-available” gboolean

+
  “connectivity-check-available” gboolean

 
Owner: NMClient

 
Flags: Read

 
Default value: FALSE

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

 

 

 
The “connectivity-check-enabled” property

-
  “connectivity-check-enabled” gboolean

+
  “connectivity-check-enabled” gboolean

 
Owner: NMClient

 
Flags: Read / Write

 
Default value: FALSE

@@ -6215,10 +6215,10 @@ permission to read the details of.)

 

 

 
The “dbus-connection” property

-
  “dbus-connection”          GDBusConnection *

-
The GDBusConnection to use.

+
  “dbus-connection”          GDBusConnection *

+
The GDBusConnection to use.

 
If this is not set during object construction, the D-Bus connection will
-automatically be chosen during async/sync initalization via g_bus_get().

+automatically be chosen during async/sync initalization via g_bus_get().

 
Owner: NMClient

 
Flags: Read / Write / Construct Only

 
Since: 1.22

@@ -6236,7 +6236,7 @@ automatically be chosen during async/sync initalization via 
 
The “devices” property

-
  “devices”                  GPtrArray *

+
  “devices”                  GPtrArray *

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

 
[type GPtrArray(NMDevice)]

 
Owner: NMClient

@@ -6245,7 +6245,7 @@ automatically be chosen during async/sync initalization via 
 
The “dns-configuration” property

-
  “dns-configuration”        GPtrArray *

+
  “dns-configuration”        GPtrArray *

 
The current DNS configuration, represented as an array
 of NMDnsEntry objects.

 
[type GPtrArray(NMDnsEntry)]

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

 
The “instance-flags” property

-
  “instance-flags”           guint

+
  “instance-flags”           guint

 
NMClientInstanceFlags for the instance. These affect behavior of NMClient.
 This is a construct property and you may only set most flags only during
 construction.

@@ -6304,7 +6304,7 @@ cannot be set, however they will be returned by the getter after initialization
 

 

 
The “metered” property

-
  “metered”                  guint

+
  “metered”                  guint

 
Whether the connectivity is metered.

 
Owner: NMClient

 
Flags: Read

@@ -6314,7 +6314,7 @@ cannot be set, however they will be returned by the getter after initialization
 

 

 
The “networking-enabled” property

-
  “networking-enabled”       gboolean

+
  “networking-enabled”       gboolean

 
Whether networking is enabled.

 
The property setter is a synchronous D-Bus call. This is deprecated since 1.22.

 
Owner: NMClient

@@ -6324,7 +6324,7 @@ cannot be set, however they will be returned by the getter after initialization
 

 

 
The “nm-running” property

-
  “nm-running”               gboolean

+
  “nm-running”               gboolean

 
Whether the daemon is running.

 
Owner: NMClient

 
Flags: Read

@@ -6364,7 +6364,7 @@ see 
 

 
The “radio-flags” property

-
  “radio-flags”              guint

+
  “radio-flags”              guint

 
Flags for radio interfaces. See NMRadioFlags.

 
Owner: NMClient

 
Flags: Read

@@ -6374,7 +6374,7 @@ see 
 

 
The “startup” property

-
  “startup”                  gboolean

+
  “startup”                  gboolean

 
Whether the daemon is still starting up.

 
Owner: NMClient

 
Flags: Read

@@ -6401,7 +6401,7 @@ see 
 

 
The “version-info” property

-
  “version-info”             GArray *

+
  “version-info”             GArray *

 
Expose version info and capabilities of NetworkManager. If non-empty,
 the first element is NM_VERSION, which encodes the version of the
 daemon as "(major << 16 | minor << 8 | micro)". The following elements
@@ -6415,7 +6415,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wimax-enabled” property

-
  “wimax-enabled”            gboolean

+
  “wimax-enabled”            gboolean

 
Whether WiMAX functionality is enabled.

 

 
NMClient:wimax-enabled has been deprecated since version 1.22 and should not be used in newly-written code.

@@ -6428,7 +6428,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wimax-hardware-enabled” property

-
  “wimax-hardware-enabled”   gboolean

+
  “wimax-hardware-enabled”   gboolean

 
Whether the WiMAX hardware is enabled.

 

 
NMClient:wimax-hardware-enabled has been deprecated since version 1.22 and should not be used in newly-written code.

@@ -6441,7 +6441,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wireless-enabled” property

-
  “wireless-enabled”         gboolean

+
  “wireless-enabled”         gboolean

 
Whether wireless is enabled.

 
The property setter is a synchronous D-Bus call. This is deprecated since 1.22.

 
Owner: NMClient

@@ -6451,7 +6451,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wireless-hardware-enabled” property

-
  “wireless-hardware-enabled” gboolean

+
  “wireless-hardware-enabled” gboolean

 
Whether the wireless hardware is enabled.

 
Owner: NMClient

 
Flags: Read

@@ -6460,7 +6460,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wwan-enabled” property

-
  “wwan-enabled”             gboolean

+
  “wwan-enabled”             gboolean

 
Whether WWAN functionality is enabled.

 
The property setter is a synchronous D-Bus call. This is deprecated since 1.22.

 
Owner: NMClient

@@ -6470,7 +6470,7 @@ the running NetworkManager has the respective capability.

 

 

 
The “wwan-hardware-enabled” property

-
  “wwan-hardware-enabled”    gboolean

+
  “wwan-hardware-enabled”    gboolean

 
Whether the WWAN hardware is enabled.

 
Owner: NMClient

 
Flags: Read

@@ -6484,7 +6484,7 @@ the running NetworkManager has the respective capability.

 
void
 user_function (NMClient           *client,
                NMActiveConnection *active_connection,
-               gpointer            user_data)

+               gpointer            user_data)
 
Notifies that a NMActiveConnection has been added.

 

 
Parameters

@@ -6513,7 +6513,7 @@ user_function (
 
a GAsyncResult obtained from the GAsyncReadyCallback passed to nm_client_wait_shutdown()
a GAsyncResult obtained from the GAsyncReadyCallback passed to nm_client_wait_shutdown()

  
 

 

 
error
return location for error or NULL
return location for error or NULL

  
 

 

 

-
Flags: Run First

+
Flags: Run First

 

 

 

@@ -6521,7 +6521,7 @@ user_function (void
 user_function (NMClient           *client,
                NMActiveConnection *active_connection,
-               gpointer            user_data)

+               gpointer            user_data)

Notifies that a NMActiveConnection has been removed.

Parameters

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

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

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

-

Flags: Run First

+

Flags: Run First

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

@@ -6663,7 +6663,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

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

Notifies that a NMConnection has been removed.

Parameters

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

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

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

@@ -6819,7 +6819,7 @@ user_function (
-

Flags: Run First

+

Flags: Run First

-- cgit 1.3.0-6-gf8a5