colin/NetworkManager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man: reword nmcli manual page introducation

Browse Source 
See https://bugzilla.redhat.com/show_bug.cgi?id=960071

Signed-off-by: Thomas Haller <thaller@redhat.com>
This commit is contained in:
Thomas Haller
2013-08-15 14:23:26 +02:00
parent d9cba44e6c
commit 253b783129
1 changed files with 14 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
man/nmcli.1.in
View File

@@ -63,27 +63,23 @@ nmcli \- command\(hyline tool for controlling NetworkManager
.SH DESCRIPTION .SH DESCRIPTION
.B nmcli .B nmcli
is a command\(hyline tool for controlling NetworkManager and reporting on its status. is a command\(hyline tool for controlling NetworkManager and reporting network
It is not meant as a full replacement for \fInm\(hyapplet\fP or other similar clients status. It can be utilized as a replacement for \fInm\(hyapplet\fP or other
but as a complementary utility to those programs. graphical clients. \fInmcli\fP is used to create, display, edit, delete, activate,
The main usage for \fInmcli\fP is on servers, headless machines or for power users and deactivate network connections, as well as control and display network device
who prefer the command line. status.
.P .P
Typical applications include: Typical uses include:
.IP \(em 4 .IP \(em 4
Initscripts: ifup/ifdown can utilize NetworkManager via \fInmcli\fP instead of Scripts: utilize NetworkManager via \fInmcli\fP instead of managing network
having to manage connections itself and possibly interfere with NetworkManager. connections manually. \fInmcli\fP supports a terse output format which is better
suited for script processing. Note that Networkmanager can also execute scripts,
called "dispatcher scripts", in response to network events. See
\fBNetworkManager\fP for details about these dispatcher scripts.
.IP \(em 4 .IP \(em 4
Servers, headless machines: No GUI is available; then \fInmcli\fP can be used Servers, headless machines, and terminals: \fInmcli\fP can be used to control
to activate/deactivate connections. However, if a connection requires a secret NetworkManager without a GUI, including creating, editing, starting and stopping
in order to activate and if that secret is not stored at the system level, network connections and viewing network status.
\fInmcli\fP will not be able to activate it; it is currently unable to supply
the secrets to NetworkManager.
.IP \(em 4
User sessions: \fInmcli\fP can be used to activate/deactivate connections from
the command line, but a client with a secret agent (like \fInm\(hyapplet\fP) is needed
for supplying secrets not stored at the system level. Keyring dialogs and
password prompts may appear if this happens.
.SS \fIOPTIONS\fP .SS \fIOPTIONS\fP
.TP .TP
.B \-t, \-\-terse .B \-t, \-\-terse