nm_client_add_and_activate_connection ()

void
 nm_client_add_and_activate_connection (NMClient *client,
-                                       NMConnection *partial,
+                                       NMConnection *partial,
                                        NMDevice *device,
                                        const char *specific_object,
                                        NMClientAddActivateFn callback,
-                                       gpointer user_data);

+ 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 activated. @@ -977,8 +977,8 @@ track the activation to its completion.

partial

an NMConnection to add; the connection may be -partially filled (or even NULL) and will be completed by NetworkManager +

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

@@ -993,7 +993,7 @@ 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 @@ -1048,7 +1048,7 @@ nm_client_deactivate_connection (

nm_client_networking_get_enabled () -gboolean +gboolean nm_client_networking_get_enabled (NMClient *client); Whether networking is enabled or disabled. @@ -1068,7 +1068,7 @@ 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 @@ -1076,7 +1076,7 @@ nm_client_networking_get_enabled (nm_client_networking_set_enabled () void nm_client_networking_set_enabled (NMClient *client, - gboolean enabled); + gboolean enabled); Enables or disables networking. When networking is disabled, all controlled interfaces are disconnected and deactivated. When networking is enabled, all controlled interfaces are available for activation. @@ -1096,7 +1096,7 @@ all controlled interfaces are available for activation. enabled -TRUE to set networking enabled, FALSE to set networking disabled +TRUE to set networking enabled, FALSE to set networking disabled @@ -1106,7 +1106,7 @@ all controlled interfaces are available for activation. nm_client_wireless_get_enabled () -gboolean +gboolean nm_client_wireless_get_enabled (NMClient *client); Determines whether the wireless is enabled. @@ -1126,7 +1126,7 @@ nm_client_wireless_get_enabled ( Returns - TRUE if wireless is enabled + TRUE if wireless is enabled @@ -1134,7 +1134,7 @@ nm_client_wireless_get_enabled (nm_client_wireless_set_enabled () void nm_client_wireless_set_enabled (NMClient *client, - gboolean enabled); + gboolean enabled); Enables or disables wireless devices. Parameters @@ -1152,7 +1152,7 @@ nm_client_wireless_set_enabled ( enabled -TRUE to enable wireless +TRUE to enable wireless @@ -1162,7 +1162,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. @@ -1183,13 +1183,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. @@ -1209,7 +1209,7 @@ nm_client_wwan_get_enabled ( Returns - TRUE if WWAN is enabled + TRUE if WWAN is enabled @@ -1217,7 +1217,7 @@ nm_client_wwan_get_enabled (nm_client_wwan_set_enabled () void nm_client_wwan_set_enabled (NMClient *client, - gboolean enabled); + gboolean enabled); Enables or disables WWAN devices. Parameters @@ -1235,7 +1235,7 @@ nm_client_wwan_set_enabled (enabled -TRUE to enable WWAN +TRUE to enable WWAN @@ -1245,7 +1245,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. @@ -1265,13 +1265,13 @@ nm_client_wwan_hardware_get_enabled ( Returns - TRUE if the WWAN hardware is enabled + TRUE if the WWAN hardware is enabled nm_client_wimax_get_enabled () -gboolean +gboolean nm_client_wimax_get_enabled (NMClient *client); Determines whether WiMAX is enabled. @@ -1291,7 +1291,7 @@ nm_client_wimax_get_enabled ( Returns - TRUE if WiMAX is enabled + TRUE if WiMAX is enabled @@ -1299,7 +1299,7 @@ nm_client_wimax_get_enabled (nm_client_wimax_set_enabled () void nm_client_wimax_set_enabled (NMClient *client, - gboolean enabled); + gboolean enabled); Enables or disables WiMAX devices. Parameters @@ -1317,7 +1317,7 @@ nm_client_wimax_set_enabled (enabled -TRUE to enable WiMAX +TRUE to enable WiMAX @@ -1327,7 +1327,7 @@ nm_client_wimax_set_enabled ( nm_client_wimax_hardware_get_enabled () -gboolean +gboolean nm_client_wimax_hardware_get_enabled (NMClient *client); Determines whether the WiMAX hardware is enabled. @@ -1347,7 +1347,7 @@ nm_client_wimax_hardware_get_enabled ( Returns - TRUE if the WiMAX hardware is enabled + TRUE if the WiMAX hardware is enabled @@ -1379,7 +1379,7 @@ nm_client_get_version ( nm_client_get_state () -NMState +NMState nm_client_get_state (NMClient *client); Gets the current daemon state. @@ -1399,13 +1399,13 @@ nm_client_get_state ( Returns - the current NMState + the current NMState 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. @@ -1433,7 +1433,7 @@ connections at startup. nm_client_get_manager_running () -gboolean +gboolean nm_client_get_manager_running (NMClient *client); Determines whether the daemon is running. @@ -1453,13 +1453,13 @@ nm_client_get_manager_running ( Returns - TRUE if the daemon is running + TRUE if the daemon is running nm_client_get_active_connections () -const GPtrArray * +const GPtrArray * nm_client_get_active_connections (NMClient *client); Gets the active connections. @@ -1479,8 +1479,8 @@ nm_client_get_active_connections ( Returns -a GPtrArray -containing all the active NMActiveConnections. + 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] @@ -1490,7 +1490,7 @@ The returned array is owned by the client and should not be modified. nm_client_sleep () void nm_client_sleep (NMClient *client, - gboolean sleep_); + gboolean sleep_); Deprecated; use nm_client_networking_set_enabled() instead. Parameters @@ -1508,7 +1508,7 @@ nm_client_sleep (sleep_ -TRUE to put the daemon to sleep +TRUE to put the daemon to sleep @@ -1553,11 +1553,11 @@ client can or cannot perform the action the permission represents nm_client_get_logging () -gboolean +gboolean nm_client_get_logging (NMClient *client, char **level, char **domains, - GError **error); + GError **error); Gets NetworkManager current logging level and domains. Parameters @@ -1586,7 +1586,7 @@ a list of domains separated by ",". error -return location for a GError, or NULL. +return location for a GError, or NULL. [allow-none] @@ -1594,18 +1594,18 @@ a list of domains separated by ",". Returns - TRUE on success, FALSE otherwise + TRUE on success, FALSE otherwise Since: 0.9.8 nm_client_set_logging () -gboolean +gboolean nm_client_set_logging (NMClient *client, const char *level, const char *domains, - GError **error); + GError **error); Sets NetworkManager logging level and/or domains. Parameters @@ -1623,18 +1623,18 @@ nm_client_set_logging (level -logging level to set (NULL or an empty string for no change). +logging level to set (NULL or an empty string for no change). [allow-none] domains logging domains to set. The string should be a list of log -domains separated by ",". (NULL or an empty string for no change). +domains separated by ",". (NULL or an empty string for no change). [allow-none] error -return location for a GError, or NULL. +return location for a GError, or NULL. [allow-none] @@ -1642,14 +1642,14 @@ domains separated by ",". ( Returns - TRUE on success, FALSE otherwise + TRUE on success, FALSE otherwise Since: 0.9.8 nm_client_get_connectivity () -NMConnectivityState +NMConnectivityState nm_client_get_connectivity (NMClient *client); Gets the current network connectivity state. Contrast nm_client_check_connectivity() and @@ -1679,10 +1679,10 @@ connectivity state first before returning any information. nm_client_check_connectivity () -NMConnectivityState +NMConnectivityState nm_client_check_connectivity (NMClient *client, - GCancellable *cancellable, - GError **error); + GCancellable *cancellable, + GError **error); Updates the network connectivity state and returns the (new) current state. Contrast nm_client_get_connectivity(), which returns the most recent known state without re-checking. @@ -1704,12 +1704,12 @@ if you do not want to block. cancellable -a GCancellable +a GCancellable error -return location for a GError +return location for a GError @@ -1726,9 +1726,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(), @@ -1750,7 +1750,7 @@ re-checking, and cancellable -a GCancellable +a GCancellable @@ -1772,10 +1772,10 @@ re-checking, and nm_client_check_connectivity_finish () -NMConnectivityState +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. @@ -1794,12 +1794,12 @@ call. result -the GAsyncResult +the GAsyncResult error -return location for a GError +return location for a GError @@ -1824,7 +1824,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 @@ -2235,8 +2235,6 @@ likely to become the new The “active-connections” property “active-connections” NMObjectArray * -The active connections. -Type: GLib.PtrArray Flags: Read @@ -2250,7 +2248,7 @@ Type: GLib.PtrArray The “connectivity” property - “connectivity” guint + “connectivity” guint The network connectivity state. Flags: Read Allowed values: <= 4 @@ -2268,7 +2266,7 @@ Type: GLib.PtrArray The “manager-running” property - “manager-running” gboolean + “manager-running” gboolean Whether the daemon is running. Flags: Read Default value: FALSE @@ -2276,7 +2274,7 @@ Type: GLib.PtrArray The “networking-enabled” property - “networking-enabled” gboolean + “networking-enabled” gboolean Whether networking is enabled. Flags: Read / Write Default value: TRUE @@ -2293,7 +2291,7 @@ see The “startup” property - “startup” gboolean + “startup” gboolean Whether the daemon is still starting up. Flags: Read Default value: FALSE @@ -2302,7 +2300,7 @@ see The “state” property - “state” guint + “state” guint The current daemon state. Flags: Read Allowed values: <= 70 @@ -2311,7 +2309,7 @@ see The “version” property - “version” gchar * + “version” gchar * The NetworkManager version. Flags: Read Default value: NULL @@ -2319,7 +2317,7 @@ see The “wimax-enabled” property - “wimax-enabled” gboolean + “wimax-enabled” gboolean Whether WiMAX functionality is enabled. Flags: Read / Write Default value: FALSE @@ -2327,7 +2325,7 @@ see The “wimax-hardware-enabled” property - “wimax-hardware-enabled” gboolean + “wimax-hardware-enabled” gboolean Whether the WiMAX hardware is enabled. Flags: Read Default value: FALSE @@ -2335,7 +2333,7 @@ see The “wireless-enabled” property - “wireless-enabled” gboolean + “wireless-enabled” gboolean Whether wireless is enabled. Flags: Read / Write Default value: FALSE @@ -2343,7 +2341,7 @@ see The “wireless-hardware-enabled” property - “wireless-hardware-enabled” gboolean + “wireless-hardware-enabled” gboolean Whether the wireless hardware is enabled. Flags: Read Default value: TRUE @@ -2351,7 +2349,7 @@ see The “wwan-enabled” property - “wwan-enabled” gboolean + “wwan-enabled” gboolean Whether WWAN functionality is enabled. Flags: Read / Write Default value: FALSE @@ -2359,7 +2357,7 @@ see The “wwan-hardware-enabled” property - “wwan-hardware-enabled” gboolean + “wwan-hardware-enabled” gboolean Whether the WWAN hardware is enabled. Flags: Read Default value: FALSE @@ -2371,8 +2369,8 @@ see The “any-device-added” signal void user_function (NMClient *client, - GObject *device, - gpointer user_data) + GObject *device, + gpointer user_data) Notifies that a NMDevice is added. This signal is emitted for both regular devices and placeholder devices. @@ -2402,15 +2400,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. @@ -2440,15 +2438,15 @@ regular devices and placeholder devices. -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. @@ -2478,15 +2476,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. @@ -2516,16 +2514,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 @@ -2559,11 +2557,11 @@ user_function ( -Flags: Run First +Flags: Run First

Object Hierarchy

Functions

nm_client_error_quark ()

nm_client_new_async ()

nm_client_new_finish ()

Parameters

Returns

nm_client_get_devices ()

Returns

nm_client_get_all_devices ()

Returns

Returns

Returns

nm_client_activate_connection ()

nm_client_add_and_activate_connection ()

nm_client_networking_get_enabled ()

Returns

nm_client_networking_set_enabled ()

nm_client_wireless_get_enabled ()

Returns

nm_client_wireless_set_enabled ()

Parameters

nm_client_wireless_hardware_get_enabled ()

Returns

nm_client_wwan_get_enabled ()

Returns

nm_client_wwan_set_enabled ()

Parameters

nm_client_wwan_hardware_get_enabled ()

Returns

nm_client_wimax_get_enabled ()

Returns

nm_client_wimax_set_enabled ()

Parameters

nm_client_wimax_hardware_get_enabled ()

Returns

nm_client_get_state ()

Returns

nm_client_get_startup ()

nm_client_get_manager_running ()

Returns

nm_client_get_active_connections ()

Returns

nm_client_sleep ()

Parameters

nm_client_get_logging ()

Parameters

Returns

nm_client_set_logging ()

Parameters

Returns

nm_client_get_connectivity ()

nm_client_check_connectivity ()

nm_client_check_connectivity_async ()

nm_client_check_connectivity_finish ()

Parameters

The “active-connections” property

The “connectivity” property

The “manager-running” property

The “networking-enabled” property

The “startup” property

The “state” property

The “version” property

The “wimax-enabled” property

The “wimax-hardware-enabled” property

The “wireless-enabled” property

The “wireless-hardware-enabled” property

The “wwan-enabled” property

The “wwan-hardware-enabled” property

The “any-device-added” signal

The “any-device-removed” signal

The “device-added” signal

The “device-removed” signal

The “permission-changed” signal

Parameters

The `“active-connections”` property

The `“connectivity”` property

The `“manager-running”` property

The `“networking-enabled”` property

The `“startup”` property

The `“state”` property

The `“version”` property

The `“wimax-enabled”` property

The `“wimax-hardware-enabled”` property

The `“wireless-enabled”` property

The `“wireless-hardware-enabled”` property

The `“wwan-enabled”` property

The `“wwan-hardware-enabled”` property

The `“any-device-added”` signal

The `“any-device-removed”` signal

The `“device-added”` signal

The `“device-removed”` signal

The `“permission-changed”` signal