X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fhostnamectl.xml;h=128d92f57623f8055576e85de3b9737cab68c5f3;hb=e1bbf3d12f28b8e3d4394f2b257e1b7aea3d10fc;hp=f28e430a421bda3b0977982e2e1e883e82c1a627;hpb=409dee2e44e7dc73d6bf00d782938e4cb4105f5b;p=elogind.git
diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml
index f28e430a4..128d92f57 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
@@ -66,11 +69,9 @@
(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
- which might be assigned temporarily due to network
- configuration and might revert back to the static
- hostname if network connectivity is lost and is only
- temporarily written to the kernel hostname
- (e.g. "dhcp-47-11").
+ which is a default received from network configuration.
+ If a static hostname is set, and is valid (something other
+ than localhost), then the transient hostname is not used.
Note that the pretty hostname has little
restrictions on the characters used, while the static
@@ -81,9 +82,14 @@
/etc/hostname, see
hostname5
for more information. The pretty hostname, chassis
- type and icon name are stored in
+ type, and icon name are stored in
/etc/machine-info, see
- machine-id5.
+ machine-info5.
+
+ Use
+ systemd-firstboot1
+ to initialize the system host name for mounted (but
+ not booted) system images.
@@ -92,21 +98,6 @@
The following options are understood:
-
-
-
-
- Prints a short help
- text and exits.
-
-
-
-
-
- Prints a short version
- string and exits.
-
-
@@ -115,38 +106,32 @@
operations.
-
-
-
-
- Acquire privileges via PolicyKit
- before executing the operation.
-
-
-
-
-
-
- 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.
-
-
If
- set-hostname is
- invoked and one or more of these
- options are passed, only the selected
- hostname(s) is/are
- 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:
@@ -161,13 +146,14 @@
- set-hostname [NAME]
+ set-hostname NAMESet the system
- hostname. By default, this will alter
- the pretty, the static, and the
- transient hostname alike; however, if
- one or more of
+ hostname to
+ NAME. By
+ default, this will alter the pretty,
+ the static, and the transient hostname
+ alike; however, if one or more of
,
,
are used,
@@ -188,63 +174,108 @@
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 the
- hostname to reset the selected
- hostnames to their default (usually
+ name is left untouched.
+
+ Pass the empty string
+ as the hostname to
+ reset the selected hostnames to their
+ default (usually
localhost).
- set-icon-name [NAME]
+ set-icon-name NAMESet the system icon
- name. The icon name is used by some
- graphical applications to visualize
- this host. The icon name should follow
- the NAME. The
+ icon name is used by some graphical
+ applications to visualize this host.
+ The icon name should follow the Icon
- Naming Specification. Pass an
- empty string to this operation to
- reset the icon name to the default
- value, which is determined from chassis
- type (see below) and possibly other
+ Naming Specification.
+
+ Pass an empty string to reset
+ the icon name to the default value,
+ which is determined from chassis type
+ (see below) and possibly other
parameters.
- set-chassis [TYPE]
+ set-chassis TYPE
- Set the chassis
- type. The chassis type is used by some
+ Set the chassis type
+ to TYPE.
+ The chassis type is used by some
graphical applications to visualize
- the host or alter user
- interaction. Currently, the following
- chassis types are defined:
+ the host or alter user interaction.
+ Currently, the following chassis types
+ are defined:
desktop,
laptop,
server,
tablet,
- handset, as well as
+ handset,
+ watch, as well as
the special chassis types
vm and
container for
virtualized systems that lack an
- immediate physical chassis. Pass an
- empty string to this operation to
- reset the chassis type to the default
- value which is determined from the
- firmware and possibly other
- parameters.
+ immediate physical chassis.
+
+ Pass an empty string to reset
+ the chassis type to the default value
+ which is determined from the firmware
+ and possibly other parameters.
+
+
+ set-deployment ENVIRONMENT
+
+ Set the deployment
+ environment
+ description. ENVIRONMENT
+ must be a single word without any
+ control characters. One of the
+ following is suggested:
+ development,
+ integration,
+ staging,
+ production.
+
+
+ Pass an empty string to reset to
+ the default empty value.
+
+
+
+
+ set-location LOCATION
+
+ Set the location
+ string for the system, if it is
+ known. LOCATION
+ should be a human-friendly, free-form
+ string describing the physical
+ location of the system, if it is known
+ and applicable. This may be as generic
+ as Berlin, Germany
+ or as specific as Left Rack,
+ 2nd Shelf.
+
+ Pass an empty string to reset to
+ the default empty value.
+
+ Exit status
- On success 0 is returned, a non-zero failure
+ On success, 0 is returned, a non-zero failure
code otherwise.
@@ -256,7 +287,8 @@
hostname5,
machine-info5,
systemctl1,
- systemd-hostnamed.service8
+ systemd-hostnamed.service8,
+ systemd-firstboot1