X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fhostnamectl.xml;h=d7a9e92879b45b042d7a68385dedc1bbf86cbbfa;hb=e9dd9f9547350c7dc0473583b5c2228dc8f0ab76;hp=9efe22011983674b4d187728c843186e55811e1f;hpb=a7f5bb1eafadbb08c8528baae588bbe773a37e79;p=elogind.git
diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml
index 9efe22011..d7a9e9287 100644
--- a/man/hostnamectl.xml
+++ b/man/hostnamectl.xml
@@ -60,9 +60,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
@@ -77,10 +77,10 @@
and transient hostnames are limited to the usually
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
+ for more information. The pretty hostname, chassis
type and icon name are stored in
/etc/machine-info, see
machine-id5.
@@ -115,6 +115,14 @@
operations.
+
+
+
+
+ Acquire privileges via PolicyKit
+ before executing the operation.
+
+
@@ -135,8 +143,8 @@
If
set-hostname is
invoked and one or more of these
- options are passed only the selected
- hostnames is
+ options are passed, only the selected
+ hostname(s) is/are
updated.
@@ -156,34 +164,34 @@
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").
+ only the transient and/or static
+ hostnames are set, and the pretty
+ hostname is left untouched. Pass the
+ empty string "" as the hostname to
+ reset the selected hostnames to their
+ default (usually "localhost").
+
@@ -198,7 +206,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.