X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fhostnamectl.xml;h=128d92f57623f8055576e85de3b9737cab68c5f3;hp=eac304012e1ca2c1c9c39326e92f8d6ed5754dcc;hb=ce0f1493c399178a3c7796415bfe5abd105ad610;hpb=efab8d0b0ebf6d715949b7af66fecaf5e5e5d77b diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index eac304012..128d92f57 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -146,13 +146,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, @@ -173,57 +174,101 @@ 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, - watch, 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. + +