New upstream version 1.10.2 upstream/1.10.2

1 files changed, 57 insertions, 0 deletions

diff --git a/docs/api/dbus-org.freedesktop.NetworkManager.Settings.Connection.xml b/docs/api/dbus-org.freedesktop.NetworkManager.Settings.Connection.xml
index c5938c0a..2ca567e8 100644
--- a/docs/api/dbus-org.freedesktop.NetworkManager.Settings.Connection.xml
+++ b/docs/api/dbus-org.freedesktop.NetworkManager.Settings.Connection.xml
@@ -16,6 +16,10 @@
                OUT a{sa{sv}} secrets);
 <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.ClearSecrets">ClearSecrets</link>  ();
 <link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Save">Save</link>          ();
+<link linkend="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Update2">Update2</link>       (IN  a{sa{sv}} settings,
+               IN  u         flags,
+               IN  a{sv}     args,
+               OUT a{sv}     result);
 </synopsis>
   </refsynopsisdiv>
   <refsect1 role="signal_proto">
@@ -149,6 +153,59 @@ Save ();
         UpdateUnsaved) to persistent storage.
 </para>
 </refsect2>
+<refsect2 role="method" id="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Update2">
+  <title>The Update2() method</title>
+  <indexterm zone="gdbus-method-org-freedesktop-NetworkManager-Settings-Connection.Update2"><primary sortas=".Settings.Connection.Update2">org.freedesktop.NetworkManager.Settings.Connection.Update2()</primary></indexterm>
+<programlisting>
+Update2 (IN  a{sa{sv}} settings,
+         IN  u         flags,
+         IN  a{sv}     args,
+         OUT a{sv}     result);
+</programlisting>
+<para>          Provide an empty array, to use the current settings.
+        <parameter>flags</parameter>: optional flags argument. Currently supported flags are:
+          "0x1" (to-disk),
+          "0x2" (in-memory),
+          "0x4" (in-memory-detached),
+          "0x8" (in-memory-only),
+          "0x10" (volatile),
+          "0x20" (block-autoconnect).
+          Unknown flags cause the call to fail.
+        <parameter>args</parameter>: optional arguments dictionary, for extensibility. Currently no
+          arguments are accepted. Specifying unknown keys causes the call
+          to fail.
+        <parameter>result</parameter>: output argument, currently no results are returned.
+</para><para>        Update the connection with new settings and properties (replacing all
+        previous settings and properties). If the flag 0x1 is present,
+        the connection is persisted to disk. If the flag 0x2 is present,
+        the change is only made in memory (without touching an eventual
+        profile on disk). If neither 0x1 nor 0x2 is set, the change is made
+        in memory only, if the connection is already in memory only.
+        Secrets may be part of the update request, and will be either stored in persistent
+        storage or sent to a Secret Agent for storage, depending on the flags
+        associated with each secret.
+</para><para>        Update2 is a extensible alternative to Update, UpdateUnsaved and Save.
+</para><para>        Since: 1.10.2
+</para>
+<variablelist role="params">
+<varlistentry>
+  <term><literal>IN a{sa{sv}} <parameter>settings</parameter></literal>:</term>
+  <listitem><para>New connection settings, properties, and (optionally) secrets.</para></listitem>
+</varlistentry>
+<varlistentry>
+  <term><literal>IN u <parameter>flags</parameter></literal>:</term>
+  <listitem><para></para></listitem>
+</varlistentry>
+<varlistentry>
+  <term><literal>IN a{sv} <parameter>args</parameter></literal>:</term>
+  <listitem><para></para></listitem>
+</varlistentry>
+<varlistentry>
+  <term><literal>OUT a{sv} <parameter>result</parameter></literal>:</term>
+  <listitem><para></para></listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
 </refsect1>
 <refsect1 role="details" id="gdbus-signals-org.freedesktop.NetworkManager.Settings.Connection">
   <title role="details.title">Signal Details</title>