summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2018-10-17 17:15:47 +0200
committerThomas Haller <thaller@redhat.com>2018-10-17 18:19:08 +0200
commita1831d1832391069573f7116159671fa39984c01 (patch)
treeec44b1de8da3b157056e2ebf22aef9c35243c1de
parent7f173bcfdfb1274868cb3bd75844e253d3859192 (diff)
downloadNetworkManager-a1831d1832391069573f7116159671fa39984c01.tar.gz
man: document `nmcli device connect` behaviour
Already since 1.0.0 release and commit "3784678177 cli: create a connection if none exist in 'nmcli dev connect' (rh #1113941)", device-connect can also create a profile. That is useful, in particular as opposed to $ nmcli connection up ifname "$DEVICE" which wouldn't create a profile (ever). Document it. (cherry picked from commit 1b732e28f7aafbbfb98748f6a873c98be361ef67)
-rw-r--r--man/nmcli.xml5
1 files changed, 5 insertions, 0 deletions
diff --git a/man/nmcli.xml b/man/nmcli.xml
index 79deffbc8b..2a0765d0ab 100644
--- a/man/nmcli.xml
+++ b/man/nmcli.xml
@@ -1281,6 +1281,11 @@
that will be activated. It will also consider connections that are not set to
auto connect.</para>
+ <para>If no compatible connection exists, a new profile with default
+ settings will be created and activated. This differentiates
+ <command>nmcli connection up ifname "$DEVICE"</command> from
+ <command>nmcli device connect "$DEVICE"</command></para>
+
<para>If <option>--wait</option> option is not specified, the default timeout will be 90
seconds.</para>
</listitem>