nm_client_add_and_activate_connection2 ()

void
+nm_client_add_and_activate_connection2
+                               (NMClient *client,
+                                NMConnection *partial,
+                                NMDevice *device,
+                                const char *specific_object,
+                                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 +activated as with nm_client_activate_connection_async(). Cannot be used for +VPN connections at this time.

Note that the callback is invoked when NetworkManager has started activating +the new connection, not when it finishes. You can used the returned +NMActiveConnection object (in particular, “state”) to +track the activation to its completion.

This is identitcal to nm_client_add_and_activate_connection_async() but takes +a further options + parameter. Currently the following options are supported +by the daemon:

"persist": A string describing how the connection should be stored. + The default is "disk", but it can be modified to "memory" (until + the daemon quits) or "volatile" (will be deleted on disconnect).
"bind-activation": Bind the connection lifetime to something. The default is "none", + meaning an explicit disconnect is needed. The value "dbus-client" + means the connection will automatically be deactivated when the calling + DBus client disappears from the system bus.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

client	a NMClient
partial	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.	[allow-none]
device	the NMDevice
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 +(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 +get using `nm_object_get_path()`, and which will be used to complete the +details of the newly added connection.	[allow-none]
options	a GVariant containing a dictionary with options, or `NULL`
cancellable	a GCancellable, or `NULL`
callback	callback to be called when the activation has started
user_data	caller-specific data passed to `callback` +

Since: 1.16

nm_client_add_and_activate_connection2_finish ()

NMActiveConnection *
+nm_client_add_and_activate_connection2_finish
+                               (NMClient *client,
+                                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.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + +

client	an NMClient
result	the result passed to the GAsyncReadyCallback
error	location for a GError, or `NULL`
out_result	(transfer full): the output result +of type "a{sv}" returned by D-Bus' AddAndActivate2 call. Currently no +output is implemented yet.	[allow-none]

Returns

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

[transfer full]

nm_client_add_and_activate_connection2 ()

Parameters

nm_client_add_and_activate_connection2_finish ()

Parameters

Returns

nm_client_deactivate_connection ()