X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fhostnamectl.xml;h=f28e430a421bda3b0977982e2e1e883e82c1a627;hp=c36f522c8e5e91f4e069ba3d1bad0ef75b76faf1;hb=042f9f5e5e76cf0e3cbfd009abd2add0366cdeca;hpb=5a5c72ca6ed88b7068e08b0ebc191a5b21991b62 diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index c36f522c8..f28e430a4 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -21,7 +21,7 @@ along with systemd; If not, see . --> - + hostnamectl @@ -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 @@ -75,13 +75,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 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. @@ -93,8 +93,8 @@ - + Prints a short help text and exits. @@ -110,18 +110,26 @@ - Don't query the user + Do not query the user for authentication for privileged operations. + + + + + Acquire privileges via PolicyKit + before executing the operation. + + Execute the operation remotely. Specify a hostname, or - username and hostname separated by @, + username and hostname separated by @, to connect to. This will use SSH to talk to a remote system. @@ -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,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,8 +207,34 @@ 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 + parameters. + + + + set-chassis [TYPE] + + Set the chassis + 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: + desktop, + laptop, + server, + tablet, + handset, 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 - system form factor and possibly other + firmware and possibly other parameters.