X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fhostnamectl.xml;h=6746a7042fe4622f149d4a7b27c443657b1ea8f6;hb=9ea28c55a2488e6cd4a44ac5786f12b71ad5bc9f;hp=07d363420c7eda8f23a21a609414e67949463e8a;hpb=56ba3c78ae35065064c4289a0c8e22a81256af20;p=elogind.git
diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml
index 07d363420..6746a7042 100644
--- a/man/hostnamectl.xml
+++ b/man/hostnamectl.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+hostnamectl
@@ -49,7 +50,9 @@
- hostnamectl OPTIONSCOMMAND
+ hostnamectl
+ OPTIONS
+ COMMAND
@@ -60,9 +63,9 @@
query and change the system hostname and related
settings.
- This tool distinguishes three different host
- names: the high-level "pretty" hostname which might
- include all kinds of special characters
+ This tool distinguishes three different
+ hostnames: the high-level "pretty" hostname which
+ might include all kinds of special characters
(e.g. "Lennart's Laptop"), the static hostname which
is used to initialize the kernel hostname at boot
(e.g. "lennarts-laptop"), and the transient hostname
@@ -75,13 +78,13 @@
Note that the pretty hostname has little
restrictions on the characters used, while the static
and transient hostnames are limited to the usually
- accepted characters of internet domain names.
+ accepted characters of Internet domain names.
- The static host name is stored in
+ The static hostname is stored in
/etc/hostname, see
hostname5
- for more information. The pretty host name, chassis
- type and icon name are stored in
+ for more information. The pretty hostname, chassis
+ type, and icon name are stored in
/etc/machine-info, see
machine-id5.
@@ -92,39 +95,20 @@
The following options are understood:
-
-
-
-
- Prints a short help
- text and exits.
-
-
-
-
-
- Prints a short version
- string and exits.
-
-
- Don't query the user
+ Do not query the user
for authentication for privileged
operations.
-
-
-
- Execute the operation
- remotely. Specify a hostname, or
- username and hostname separated by @,
- to connect to. This will use SSH to
- talk to a remote
- system.
+
+
+
+ Acquire privileges via PolicyKit
+ before executing the operation.
@@ -133,12 +117,26 @@
If
- set-hostname is
- invoked and one or more of these
- options are passed only the selected
- hostnames is
- updated.
+ status is used (or
+ no explicit command is given) and one
+ of those fields is given,
+ hostnamectl will
+ print out just this selected
+ hostname.
+
+ If used with
+ set-hostname, only
+ the selected hostname(s) will be
+ updated. When more than one of those
+ options is used, all the specified
+ hostnames will be updated.
+
+
+
+
+
+ The following commands are understood:
@@ -156,34 +154,35 @@
set-hostname [NAME]Set the system
- hostname. By default this will alter
+ hostname. By default, this will alter
the pretty, the static, and the
- transient hostname alike, however if
+ transient hostname alike; however, if
one or more of
,
,
- are used
+ are used,
only the selected hostnames are
changed. If the pretty hostname is
being set, and static or transient are
- being set as well the specified host
- name will be simplified in regards to
- the character set used before the
+ being set as well, the specified
+ hostname will be simplified in regards
+ to the character set used before the
latter are updated. This is done by
- replacing spaces by "-" and removing
+ replacing spaces with
+ - and removing
special characters. This ensures that
- the pretty and the static hostname
- are always closely related while still
+ the pretty and the static hostname are
+ always closely related while still
following the validity rules of the
specific name. This simplification of
the hostname string is not done if
only the transient and/or static host
names are set, and the pretty host
name is left untouched. Pass the empty
- string "" as hostname to reset the
- selected hostnames to their default
- (usually
- "localhost").
+ string as the
+ hostname to reset the selected
+ hostnames to their default (usually
+ localhost).
@@ -198,7 +197,7 @@
Naming Specification. Pass an
empty string to this operation to
reset the icon name to the default
- value which is determined from chassis
+ value, which is determined from chassis
type (see below) and possibly other
parameters.
@@ -235,7 +234,7 @@
Exit status
- On success 0 is returned, a non-zero failure
+ On success, 0 is returned, a non-zero failure
code otherwise.