summaryrefslogtreecommitdiffstats
path: root/man/loader.conf.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2019-07-22 14:19:33 +0200
committerLennart Poettering <lennart@poettering.net>2019-07-25 18:31:20 +0200
commit39867bb9fbeb3c1a421404caa2aa2438bbfdd81b (patch)
tree013f7f27da0a67ad184c677840645b3e07f668ac /man/loader.conf.xml
parentdocs: document new random seed EFI vars as part of the boot loader interface (diff)
downloadsystemd-39867bb9fbeb3c1a421404caa2aa2438bbfdd81b.tar.xz
systemd-39867bb9fbeb3c1a421404caa2aa2438bbfdd81b.zip
man: document the systemd-random-seed rework
Diffstat (limited to 'man/loader.conf.xml')
-rw-r--r--man/loader.conf.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/man/loader.conf.xml b/man/loader.conf.xml
index 38a80861b8..cef20b59d8 100644
--- a/man/loader.conf.xml
+++ b/man/loader.conf.xml
@@ -153,6 +153,22 @@
<listitem><para>Takes a boolean argument. Enable (the default) or disable
the "Reboot into firmware" entry.</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>random-seed-mode</term>
+
+ <listitem><para>Takes one of <literal>off</literal>, <literal>with-system-token</literal> and
+ <literal>always</literal>. If <literal>off</literal> no random seed data is read off the ESP, nor
+ passed to the OS. If <literal>with-system-token</literal> (the default)
+ <command>systemd-boot</command> will read a random seed from the ESP (from the file
+ <filename>/loader/random-seed</filename>) only if the <varname>LoaderSystemToken</varname> EFI
+ variable is set, and then derive the random seed to pass to the OS from the combination. If
+ <literal>always</literal> the boot loader will do so even if <varname>LoaderSystemToken</varname> is
+ not set. This mode is useful in environments where protection against OS image reuse is not a
+ concern, and the random seed shall be used even with no further setup in place. User <command>bootctl
+ random-seed</command> to initialize both the random seed file in the ESP and the system token EFI
+ variable.</para></listitem>
+ </varlistentry>
</variablelist>
</refsect1>