From 252c8bf4edd5a0a85da74ffd4cdc87c41d082875 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ji=C5=99=C3=AD=20Klime=C5=A1?= Date: Fri, 7 Nov 2014 09:55:29 +0100 Subject: [PATCH] man: document/clarify --ask option in relation to password prompting --- man/nmcli.1.in | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/man/nmcli.1.in b/man/nmcli.1.in index e2ac9d5aa7..2d142f4eaa 100644 --- a/man/nmcli.1.in +++ b/man/nmcli.1.in @@ -131,6 +131,8 @@ incompatible versions may produce incorrect results. .B \-a, \-\-ask When using this option \fInmcli\fP will stop and ask for any missing required arguments, so do not use this option for non-interactive purposes like scripts. +This option controls, for example, whether you will be prompted for a password +if it is required for connecting to a network. .TP .B \-w, \-\-wait This option sets a timeout period for which \fInmcli\fP will wait for \fINetworkManager\fP @@ -371,7 +373,10 @@ For 802.1X password, the line would be \fI802-1x.password:my 1X password\fP .br nmcli also accepts "wifi-sec" and "wifi" strings instead of "802-11-wireless-security". -When a required password is not given, nmcli will ask for it when run with --ask. +When NetworkManager requires a password and it is not given, nmcli will ask for it +when run with --ask. If --ask was not passed, NetworkManager can ask another secret +agent that may be running (typically a GUI secret agent, such as nm-applet or +gnome-shell). .RE .RE .TP