summaryrefslogtreecommitdiff
path: root/man
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:16:25 +0200
commit1b732e28f7aafbbfb98748f6a873c98be361ef67 (patch)
tree17fe67729bfd05ad2544a87c400554bb9e0d4cc3 /man
parenta217cbebf92aebf9a15c3dde6491813be2a7c6fa (diff)
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.
Diffstat (limited to 'man')
-rw-r--r--man/nmcli.xml5
1 files changed, 5 insertions, 0 deletions
diff --git a/man/nmcli.xml b/man/nmcli.xml
index 79deffbc8..2a0765d0a 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>