From 572c55ee3cbeb2a7ed4600aec2530ffa7e7a3a87 Mon Sep 17 00:00:00 2001 From: Jakub Warczarek Date: Fri, 23 Apr 2021 18:41:45 +0000 Subject: hostnamectl: deprecate set-* methods and expose getters by only using nouns in commands --- man/hostnamectl.xml | 67 ++++++++++++++++++++++------------------------------- 1 file changed, 28 insertions(+), 39 deletions(-) (limited to 'man') diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index ed2dabef3b..51f83d1cd6 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -63,14 +63,16 @@ status - Show current system hostname and related information. If no command is specified, + Show system hostname and related information. If no command is specified, this is the implied default. - set-hostname NAME + hostname [NAME] - Set the system hostname to NAME. By default, this will alter the + If no argument is given, print the system hostname. If an + optional argument NAME is provided then the command changes the + system 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, only the selected hostnames are changed. If the pretty hostname is being set, and static or transient are being set as well, the specified hostname will be @@ -82,35 +84,29 @@ The static and transient hostnames must each be either a single DNS label (a string composed of 7-bit ASCII lower-case characters and no spaces or dots, limited to the format allowed for DNS domain name labels), or a sequence of such labels separated by single dots that forms a valid DNS FQDN. The - hostname must be at most 64 characters, which is a Linux limitation (DNS allows longer names). - - Pass the empty string as the hostname to reset the selected hostnames to - their default (usually &FALLBACK_HOSTNAME;). + hostname must be at most 64 characters, which is a Linux limitation (DNS allows longer names). - set-icon-name NAME + icon-name [NAME] - Set the system icon name to - NAME. The icon name is used by some + If no argument is given, print the icon name of the system. If an + optional argument NAME is provided then the command changes the + icon name to 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 reset the icon name to the - default value, which is determined from chassis type (see - below) and possibly other parameters. + Naming Specification. - set-chassis TYPE + chassis [TYPE] - 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: + If no argument is given, print the chassis type. If an + optional argument TYPE is provided then the command changes 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: desktop, laptop, convertible, @@ -123,43 +119,36 @@ vm and container for virtualized systems that lack an 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 + deployment [ENVIRONMENT] - Set the deployment environment description. - ENVIRONMENT must be a single word - without any control characters. One of the following is - suggested: + If no argument is given, print the deployment environment. If an + optional argument ENVIRONMENT is provided then the command changes the + deployment environment to ENVIRONMENT. + Argument 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 + location [LOCATION] - Set the location string for the system, if it - is known. LOCATION should be a + If no argument is given, print the location string for the system. If an + optional argument LOCATION is provided then the command changes the + location string for the system to LOCATION. + Argument 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. -- cgit v1.2.1