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 (GAsyncResul 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 (GAsyncResul 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 ",". (NULL or an empty string 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 g_dbus_connection_call() directly, with t - + +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 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 (G - + - + @@ -5706,7 +5706,7 @@ nm_client_wait_shutdown_finish (G 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 ( result 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

result	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`

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

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`

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.

Implemented Interfaces

Description

Functions

nm_client_error_quark ()

nm_dns_entry_get_vpn ()

Returns

nm_client_new ()

nm_client_new_async ()

nm_client_new_finish ()

Parameters

Returns

nm_client_get_dbus_connection ()

Returns

nm_client_get_main_context ()

Returns

nm_client_get_context_busy_watcher ()

Parameters

Returns

nm_client_get_version_info ()

Returns

nm_client_get_startup ()

nm_client_get_nm_running ()

Returns

Returns

nm_client_networking_get_enabled ()

Returns

nm_client_get_capabilities ()

Parameters

Returns

nm_client_networking_set_enabled ()

Returns

nm_client_wireless_get_enabled ()

Returns

nm_client_wireless_set_enabled ()

nm_client_wireless_hardware_get_enabled ()

Returns

nm_client_wwan_get_enabled ()

Returns

nm_client_wwan_set_enabled ()

nm_client_wwan_hardware_get_enabled ()

Returns

nm_client_wimax_get_enabled ()

Returns

nm_client_wimax_set_enabled ()

nm_client_wimax_hardware_get_enabled ()

Returns

nm_client_connectivity_check_get_available ()

Returns

nm_client_connectivity_check_get_enabled ()

Returns

nm_client_get_logging ()

Returns

nm_client_set_logging ()

Returns

nm_client_check_connectivity ()

nm_client_check_connectivity_async ()

nm_client_check_connectivity_finish ()

nm_client_save_hostname ()

Returns

nm_client_save_hostname_finish ()

Parameters

Returns

nm_client_get_devices ()

Returns

nm_client_get_all_devices ()

Returns

Returns

Returns

nm_client_get_active_connections ()

Returns

Parameters

nm_client_activate_connection_finish ()

Parameters

Returns

Returns

Returns

nm_client_deactivate_connection ()

Parameters

nm_client_deactivate_connection_finish ()

Parameters

The `“active-connections”` property

The `“all-devices”` property

The `“can-modify”` property

The `“capabilities”` property

The `“checkpoints”` property

The `“connections”` property