diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2021-02-19 15:08:07 +0100 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2021-02-22 20:10:55 +0100 |
| commit | addddf565b982ba35cf2be290fb1a5e036f2567f (patch) | |
| tree | b956d55affe364f519a7efbcadab7689807bc084 /man/os-release.xml | |
| parent | aa96ef86a75bd424c47f6267a2bd20558615f6b4 (diff) | |
| download | systemd-addddf565b982ba35cf2be290fb1a5e036f2567f.tar.gz | |
os-release: add the DEFAULT_HOSTNAME= setting
The motivation is that variants of the same distro that share the same compiled
rpm want to customize various aspects of the system, in particular the
hostname. In some sense the default hostname is part of the identity of the
system, so setting it through os-release makes sense. In particular, instead of
setting a default value in /etc/hostname, the appropriate default can be baked
into the image, leaving /etc/hostname for local overrides only.
Why make this a separate field instead of e.g. using NAME from os-release?
NAME is already used for other purposes, and it seems likely that people want
to set those independently.
Diffstat (limited to 'man/os-release.xml')
| -rw-r--r-- | man/os-release.xml | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/man/os-release.xml b/man/os-release.xml index 5a0cfd2887..a6d333f278 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -318,6 +318,23 @@ </varlistentry> <varlistentry> + <term><varname>DEFAULT_HOSTNAME=</varname></term> + + <listitem><para>A string specifying the hostname if + <citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry> is not + present and no other configuration source specifies the hostname. Must 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 total length must be at most 64 characters.</para> + + <para>See + <citerefentry><refentrytitle>org.freedesktop.hostname1</refentrytitle><manvolnum>5</manvolnum></citerefentry> + for a description of how + <citerefentry><refentrytitle>systemd-hostnamed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + determines the fallback hostname.</para></listitem> + </varlistentry> + + <varlistentry> <term><varname>SYSEXT_LEVEL=</varname></term> <listitem><para>A lower-case string (mostly numeric, no spaces or other characters outside of 0–9, |