about summary refs log tree commit diff
path: root/man/nmcli-examples.xml
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2019-03-26 23:26:14 +0100
committerMichael Biebl <biebl@debian.org>2019-03-26 23:26:14 +0100
commit9bc3ff81969c896f6bf8e1c93f98f43f6ffffaf8 (patch)
tree302fce2d1ab3a130ac0b684d168ab6312825fcd2 /man/nmcli-examples.xml
parentf97666c6bd29a3228443acd6401a407a19ec8d25 (diff)
parent9a6dcbf895f9da01768e64b73cec88c16157d91e (diff)
Update upstream source from tag 'upstream/1.16.0'
Update to upstream version '1.16.0'
with Debian dir a0f3ffb137940d423625faae8bedbaced4d34cda
Diffstat (limited to 'man/nmcli-examples.xml')
-rw-r--r--man/nmcli-examples.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/man/nmcli-examples.xml b/man/nmcli-examples.xml
index 8be3903a..e777c326 100644
--- a/man/nmcli-examples.xml
+++ b/man/nmcli-examples.xml
@@ -178,6 +178,19 @@ B,DISPATCH</screen>
       </para>
     </example>
 
+    <example><title>Activating a VPN connection profile requiring interactive password input</title>
+<screen><prompt>$ </prompt><userinput>nmcli --ask con up my-vpn-con</userinput></screen>
+      <para>
+        This command activates a VPN connection profile enabling nmcli to interact with the user
+        ('--ask'): this will allow nmcli to prompt for the VPN password on the command line when
+        the <emphasis>password-flags</emphasis> are set to '0x02' ('always ask', see
+        <link linkend='nm-settings'><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>
+        ).
+        This is particularly useful for OTP based VPNs, as the user needs to be prompted for the
+        password each time the connection is activated.
+      </para>
+    </example>
+
     <example><title>Adding a bonding master and two slave connection profiles</title>
 <screen><prompt>$ </prompt><userinput>nmcli con add type bond ifname mybond0 mode active-backup</userinput>
 <prompt>$ </prompt><userinput>nmcli con add type ethernet ifname eth1 master mybond0</userinput>