X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fhostnamectl.xml;h=de154020d6a29572cf1ff9c2211e0b8b0d302a04;hp=b39fb5502bdd90bcbbe73c6c73502acce1a4f251;hb=e45fc5e738b0b7700e8b4f3c4b25c58a49b44b27;hpb=960787ae27af395c28fb1ce9de5a575ebfb27a4d diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index b39fb5502..de154020d 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + hostnamectl @@ -68,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 @@ -85,7 +84,12 @@ for more information. The pretty hostname, chassis 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. @@ -94,21 +98,6 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - - @@ -117,26 +106,6 @@ 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. - - @@ -158,6 +127,12 @@ hostnames will be updated. + + + + + + The following commands are understood: @@ -172,13 +147,14 @@ - set-hostname [NAME] + set-hostname NAME Set 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, @@ -199,63 +175,109 @@ 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 NAME Set 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, + embedded 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. @@ -267,7 +289,8 @@ hostname5, machine-info5, systemctl1, - systemd-hostnamed.service8 + systemd-hostnamed.service8, + systemd-firstboot1