diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2013-08-14 18:55:11 -0400 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2013-08-14 19:06:54 -0400 |
| commit | 960787ae27af395c28fb1ce9de5a575ebfb27a4d (patch) | |
| tree | 318903d52bf57b1b86337cfd7b9126cf41d7e5f3 /man/hostnamectl.xml | |
| parent | 85424725d1870e2c218e3e2d53971f7e5dc3f0ae (diff) | |
hostnamectl: show only specific hostname when requested
Existing --pretty, --transient, --static options, used previously
for 'set-hostname' verb, are reused for the 'status' verb. If one
of them is given, only the specified hostname is printed. This
way there's no need to employ awk to get the hostname in a script.
Diffstat (limited to 'man/hostnamectl.xml')
| -rw-r--r-- | man/hostnamectl.xml | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index f28e430a42..b39fb5502b 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -49,7 +49,9 @@ <refsynopsisdiv> <cmdsynopsis> - <command>hostnamectl <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command> + <command>hostnamectl</command> + <arg choice="opt" rep="repeat">OPTIONS</arg> + <arg choice="req">COMMAND</arg> </cmdsynopsis> </refsynopsisdiv> @@ -81,7 +83,7 @@ <filename>/etc/hostname</filename>, see <citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information. The pretty hostname, chassis - type and icon name are stored in + type, and icon name are stored in <filename>/etc/machine-info</filename>, see <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para> </refsect1> @@ -141,11 +143,20 @@ <term><option>--pretty</option></term> <listitem><para>If - <command>set-hostname</command> is - invoked and one or more of these - options are passed, only the selected - hostname(s) is/are - updated.</para></listitem> + <command>status</command> is used (or + no explicit command is given) and one + of those fields is given, + <command>hostnamectl</command> will + print out just this selected + hostname.</para> + + <para>If used with + <command>set-hostname</command>, only + the selected hostname(s) will be + updated. When more than one of those + options is used, all the specified + hostnames will be updated. + </para></listitem> </varlistentry> </variablelist> |