From: Jörg Behrmann Date: Wed, 20 Aug 2025 11:56:00 +0000 (+0200) Subject: man: add note about extending machine-info to man page X-Git-Tag: v258-rc4~47^2~2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=09a89190bb40c7c7fa740c4d0997f3bd5c88de8e;p=thirdparty%2Fsystemd.git man: add note about extending machine-info to man page --- diff --git a/man/machine-info.xml b/man/machine-info.xml index c766db2708d..cd254a9c355 100644 --- a/man/machine-info.xml +++ b/man/machine-info.xml @@ -53,126 +53,139 @@ The following machine metadata parameters may be set using /etc/machine-info: - - - - PRETTY_HOSTNAME= - - A pretty human-readable UTF-8 machine - identifier string. This should contain a name like - Lennart's Laptop which is useful to present - to the user and does not suffer by the syntax limitations of - internet domain names. If possible, the internet hostname as - configured in /etc/hostname should be - kept similar to this one. Example: if this value is - Lennart's Computer an Internet hostname of - lennarts-computer might be a good choice. - If this parameter is not set, an application should fall back - to the Internet hostname for presentation - purposes. - - - - ICON_NAME= - - An icon identifying this machine according to - the XDG - Icon Naming Specification. If this parameter is not - set, an application should fall back to - computer or a similar icon - name. - - - - CHASSIS= - - The chassis type. Currently, the following - chassis types are defined: - desktop, - laptop, - convertible, - server, - tablet, - handset, - watch, and - embedded, - as well as the special chassis types - vm and - container for - virtualized systems that lack an immediate physical chassis. - - Note that most systems allow detection of the chassis type automatically (based on firmware - information or suchlike). This setting should only be used to override a misdetection or to manually - configure the chassis type where automatic detection is not available. - - - - - - DEPLOYMENT= - - Describes the system deployment environment. - One of the following is suggested: - development, - integration, - staging, - production. - - - - - - - LOCATION= - - Describes the system location if applicable - and known. Takes a human-friendly, free-form string. This may - be as generic as Berlin, Germany or as - specific as Left Rack, 2nd Shelf. - - - - - - - HARDWARE_VENDOR= - - Specifies the hardware vendor. If unspecified, the hardware vendor set in DMI or - hwdb7 will be - used. - - - - - - HARDWARE_MODEL= - - Specifies the hardware model. If unspecified, the hardware model set in DMI or - hwdb7 will be - used. - - - - - - HARDWARE_SKU= - - Specifies the hardware SKU (Stock-Keeping Unit). If unspecified, the hardware - SKU set in DMI will be used. - - - - - - HARDWARE_VERSION= - - Specifies the hardware version. If unspecified, the hardware version set in DMI - will be used. - - - - + + Machine Information + + + + + PRETTY_HOSTNAME= + + A pretty human-readable UTF-8 machine + identifier string. This should contain a name like + Lennart's Laptop which is useful to present + to the user and does not suffer by the syntax limitations of + internet domain names. If possible, the internet hostname as + configured in /etc/hostname should be + kept similar to this one. Example: if this value is + Lennart's Computer an Internet hostname of + lennarts-computer might be a good choice. + If this parameter is not set, an application should fall back + to the Internet hostname for presentation + purposes. + + + + ICON_NAME= + + An icon identifying this machine according to + the XDG + Icon Naming Specification. If this parameter is not + set, an application should fall back to + computer or a similar icon + name. + + + + CHASSIS= + + The chassis type. Currently, the following + chassis types are defined: + desktop, + laptop, + convertible, + server, + tablet, + handset, + watch, and + embedded, + as well as the special chassis types + vm and + container for + virtualized systems that lack an immediate physical chassis. + + Note that most systems allow detection of the chassis type automatically (based on firmware + information or suchlike). This setting should only be used to override a misdetection or to manually + configure the chassis type where automatic detection is not available. + + + + + + DEPLOYMENT= + + Describes the system deployment environment. + One of the following is suggested: + development, + integration, + staging, + production. + + + + + + + LOCATION= + + Describes the system location if applicable + and known. Takes a human-friendly, free-form string. This may + be as generic as Berlin, Germany or as + specific as Left Rack, 2nd Shelf. + + + + + + + HARDWARE_VENDOR= + + Specifies the hardware vendor. If unspecified, the hardware vendor set in DMI or + hwdb7 will be + used. + + + + + + HARDWARE_MODEL= + + Specifies the hardware model. If unspecified, the hardware model set in DMI or + hwdb7 will be + used. + + + + + + HARDWARE_SKU= + + Specifies the hardware SKU (Stock-Keeping Unit). If unspecified, the hardware + SKU set in DMI will be used. + + + + + + HARDWARE_VERSION= + + Specifies the hardware version. If unspecified, the hardware version set in DMI + will be used. + + + + + + + Custom Fields + + Operating system vendors and systemd administrators may extend the file format and introduce new + fields. It is highly recommended to prefix new fields with an OS-specific name in order to avoid name + clashes. Applications reading this file must ignore unknown fields. + + Example: _LOCAL_EMERGENCY_CONTACT="user@example.org". + diff --git a/tools/command_ignorelist b/tools/command_ignorelist index aed479938f6..2cdaf4de7f7 100644 --- a/tools/command_ignorelist +++ b/tools/command_ignorelist @@ -49,8 +49,8 @@ logind.conf.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="NAut logind.conf.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="KillUserProcesses="] logind.conf.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="KillOnlyUsers="] logind.conf.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="InhibitDelayMaxSec="] -machine-info.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="PRETTY_HOSTNAME="] -machine-info.xml ./refsect1[title="Options"]/variablelist/varlistentry[term="ICON_NAME="] +machine-info.xml ./refsect1[title="Options"]/refsect2[title="Machine Information"]/variablelist/varlistentry[term="PRETTY_HOSTNAME="] +machine-info.xml ./refsect1[title="Options"]/refsect2[title="Machine Information"]/variablelist/varlistentry[term="ICON_NAME="] os-release.xml ./refsect1[title="Options"]/refsect2[title="General information identifying the operating system"]/variablelist/varlistentry[term="NAME="] os-release.xml ./refsect1[title="Options"]/refsect2[title="Information about the version of the operating system"]/variablelist/varlistentry[term="VERSION="] os-release.xml ./refsect1[title="Options"]/refsect2[title="General information identifying the operating system"]/variablelist/varlistentry[term="ID="]