summaryrefslogtreecommitdiff
path: root/man/kernel-install.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2022-01-19 12:20:22 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2022-01-28 16:17:47 +0100
commit367165a4069ac0c04882a05a8a80f6afb1e42760 (patch)
tree3228c2bfea3b4388bc3204c5c1ebe2c31a07f2cf /man/kernel-install.xml
parent680cec6b4ddb356d7dd087b197718712cb5c1662 (diff)
downloadsystemd-367165a4069ac0c04882a05a8a80f6afb1e42760.tar.gz
kernel-install: add "$KERNEL_INSTALL_STAGING_AREA" directory
The general approach of kernel-install was that each plugin would drop in some files into the entry directory. But this doesn't scale well, because if we have multiple initrd generators, or multiple initrds, each generator would need to recreate the logic to put the generated files in the right place. Also, effective cleanup is impossible if anything goes wrong on the way, so we could end up with unused files in $BOOT. So let's invert the process: plugins drop files into $KERNEL_INSTALL_STAGING_AREA, and at the end 90-loaderentry.install DTRT with those files. This allow new plugins like 50-mkosi-initrd.install to be significantly simpler.
Diffstat (limited to 'man/kernel-install.xml')
-rw-r--r--man/kernel-install.xml4
1 files changed, 4 insertions, 0 deletions
diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index bb76074d2e..685617863e 100644
--- a/man/kernel-install.xml
+++ b/man/kernel-install.xml
@@ -180,6 +180,10 @@
This should be configured as <varname>initrd_generator=</varname> in <filename>install.conf</filename>.
</para>
+ <para><varname>KERNEL_INSTALL_STAGING_AREA=...</varname> is set for plugins to a path to a directory.
+ Plugins may drop files in that directory, and they will be installed as part of the loader entry, based
+ on the file name and extension.</para>
+
<variablelist>
<varlistentry>
<term>bls</term>