From 9a6dcbf895f9da01768e64b73cec88c16157d91e Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Tue, 26 Mar 2019 23:25:23 +0100 Subject: New upstream version 1.16.0 --- docs/libnm/html/NMClient.html | 189 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 181 insertions(+), 8 deletions(-) (limited to 'docs/libnm/html/NMClient.html') diff --git a/docs/libnm/html/NMClient.html b/docs/libnm/html/NMClient.html index 7ccbd977..e6387588 100644 --- a/docs/libnm/html/NMClient.html +++ b/docs/libnm/html/NMClient.html @@ -430,6 +430,22 @@ +void + + +nm_client_add_and_activate_connection2 () + + + + +NMActiveConnection * + + +nm_client_add_and_activate_connection2_finish () + + + + gboolean @@ -2770,6 +2786,161 @@ will be set.

+

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

the output result +of type "a{sv}" returned by D-Bus' AddAndActivate2 call. Currently no +output is implemented yet.

[allow-none][transfer full]
+
+
+

Returns

+

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

+

[transfer full]

+
+
+
+

nm_client_deactivate_connection ()

gboolean
 nm_client_deactivate_connection (NMClient *client,
@@ -4339,6 +4510,13 @@ clients can obtain to perform certain tasks on behalf of the current user.

  
 
 
+
NM_CLIENT_PERMISSION_WIFI_SCAN

+
+
controls whether wifi scans can be performed

+
+ 
+
+
 
NM_CLIENT_PERMISSION_LAST

 
 
a reserved boundary value

@@ -4541,14 +4719,9 @@ permission to read the details of.)

 

 
The “dns-configuration” property

 
  “dns-configuration”        GPtrArray *

-
The current DNS configuration represented as an array of
-dictionaries.  Each dictionary has the "nameservers",
-"priority" keys and, optionally, "interface" and "vpn".
-"nameservers" is the list of DNS servers, "priority" their
-relative priority, "interface" the interface on which these
-servers are contacted, "vpn" a boolean telling whether the
-configuration was obtained from a VPN connection.

-
[type GPtrArray(GVariant)]

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

+
[type GPtrArray(NMDnsEntry)]

 
Flags: Read

 
Since: 1.6

 

-- 
cgit 1.3.0-6-gf8a5