summaryrefslogtreecommitdiff
path: root/man/kernel-install.xml
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2021-12-14 17:09:08 +0100
committerDaan De Meyer <daan.j.demeyer@gmail.com>2021-12-16 12:24:42 +0100
commit357376d0bb525b064f468e0e2af8193b4b90d257 (patch)
tree21cb0e4374d0d3016944a6602d692a2990bebe78 /man/kernel-install.xml
parent447a822f8ee47b63a4cae00423c4d407bfa5e516 (diff)
downloadsystemd-357376d0bb525b064f468e0e2af8193b4b90d257.tar.gz
kernel-install: Introduce KERNEL_INSTALL_MACHINE_ID in /etc/machine-info
If KERNEL_INSTALL_MACHINE_ID is defined in /etc/machine-info, prefer it over the machine ID from /etc/machine-id. If a machine ID is defined in neither /etc/machine-info nor in /etc/machine-id, generate a new UUID and try to write it to /etc/machine-info as KERNEL_INSTALL_MACHINE_ID and use it as the machine ID if writing it to /etc/machine-info succeeds. In practice, this means we have a more robust fallback if there's no machine ID in /etc/machine-id than just using "Default" and allows image builders to force kernel-install to use KERNEL_INSTALL_MACHINE_ID by simply writing it to /etc/machine-info themselves.
Diffstat (limited to 'man/kernel-install.xml')
-rw-r--r--man/kernel-install.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index 670beb35b8..c6414b13dd 100644
--- a/man/kernel-install.xml
+++ b/man/kernel-install.xml
@@ -230,6 +230,18 @@
</varlistentry>
<varlistentry>
<term>
+ <filename>/etc/machine-info</filename>
+ </term>
+ <listitem>
+ <para>If this file contains the <varname>KERNEL_INSTALL_MACHINE_ID</varname> variable,
+ <command>kernel-install</command> will use it as <replaceable>MACHINE-ID</replaceable> instead of
+ the contents of <filename>/etc/machine-id</filename>. If the variable is not found in
+ <filename>/etc/machine-info</filename>, <command>kernel-install</command> will try to save the
+ machine ID it uses to install to <varname>$BOOT</varname> to this file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
<filename>/etc/os-release</filename>
<filename>/usr/lib/os-release</filename>
</term>