cli/device: add modify commandlr/device-modify

It modifies the applied connection using the Reapply API.

1 files changed, 48 insertions, 4 deletions

diff --git a/man/nmcli.xml b/man/nmcli.xml
index a1f0062cd7..ff8e63e699 100644
--- a/man/nmcli.xml
+++ b/man/nmcli.xml
@@ -1163,6 +1163,7 @@
         <arg choice='plain'><command>set</command></arg>
         <arg choice='plain'><command>connect</command></arg>
         <arg choice='plain'><command>reapply</command></arg>
+        <arg choice='plain'><command>modify</command></arg>
         <arg choice='plain'><command>disconnect</command></arg>
         <arg choice='plain'><command>delete</command></arg>
         <arg choice='plain'><command>monitor</command></arg>
@@ -1256,6 +1257,33 @@
 
       <varlistentry>
         <term>
+          <command>modify</command>
+          <arg rep='repeat' choice='plain'>
+            <group>
+              <arg choice='plain'><replaceable>option</replaceable> <replaceable>value</replaceable></arg>
+              <arg choice='plain'>[+|-]<replaceable>setting</replaceable>.<replaceable>property</replaceable> <replaceable>value</replaceable></arg>
+            </group>
+          </arg>
+        </term>
+
+        <listitem>
+          <para>Modify the settings currently active on the device.</para>
+
+          <para>This command lets you do temporary changes to a configuration active on
+          a particular device. The changes are not preserved in the connection profile.</para>
+
+          <para>See <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum>
+          </citerefentry> for the list of available properties. Please note that some
+          properties can't be changed on an already connected device.</para>
+
+          <para>You can also use the aliases described in
+          <link linkend='property_aliases' endterm='property_aliases.title' /> section. The syntax is
+          the same as of the <command>nmcli connection modify</command> command.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
           <command>disconnect</command>
           <arg rep='repeat'><replaceable>ifname</replaceable></arg>
         </term>
@@ -1599,10 +1627,10 @@
 
   <refsect1 id='property_aliases'><title id='property_aliases.title'>Property Aliases</title>
 
-    <para>Apart from the property-value pairs, <command>connection
-    add</command> and <command>connection modify</command> also accept short forms
-    of some properties. They exist for convenience and compatiblity with older
-    versions of <command>nmcli</command> that could not accept the raw
+    <para>Apart from the property-value pairs, <command>connection add</command>,
+    <command>connection modify</command> and <command>device modify</command> also
+    accept short forms of some properties. They exist for convenience and compatiblity
+    with older versions of <command>nmcli</command> that could not accept the raw
     properties.</para>
 
    <para>The overview of the aliases is below. An actual connection type is used to
@@ -2229,6 +2257,22 @@ It's equivalent of using <literal>+ipv6.addresses</literal> syntax.</entry>
       </varlistentry>
 
       <varlistentry>
+        <term><userinput>nmcli dev modify em1 ipv4.method shared</userinput></term>
+        <listitem>
+          <para>starts IPv4 connection sharing using em1 device. The sharing will be active
+          until the device is disconnected.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><userinput>nmcli dev modify em1 ipv6.address 2001:db8::a:bad:c0de</userinput></term>
+        <listitem>
+          <para>temporarily adds an IP address to a device. The address will be removed
+          when the same connection is activated again.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><userinput>nmcli connection add type ethernet autoconnect no ifname eth0</userinput></term>
         <listitem>
           <para>non-interactively adds an Ethernet connection tied to eth0 interface with