system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-07-22 18:55:10 +00:00
Code Issues Actions 8 Packages Projects Releases Wiki Activity

bootctl: fix docs/--help to say that "bootctl random-seed" not just initializes but also refreshes ESP random seeds

Browse source
This commit is contained in:
Lennart Poettering 2023-06-13 16:47:36 +02:00 committed by Luca Boccassi
parent d754cdc994
commit 2d0855154f
2 changed files with 10 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
man/bootctl.xml
View file

@ -228,13 +228,14 @@
<varlistentry>
<term><option>random-seed</option></term>
<listitem><para>Generates a random seed and stores it in the EFI System Partition, for use by the
<command>systemd-boot</command> boot loader. Also, generates a random 'system token' and stores it
persistently as an EFI variable, if one has not been set before. If the boot loader finds the random
seed in the ESP and the system token in the EFI variable it will derive a random seed to pass to the
OS and a new seed to store in the ESP from the combination of both. The random seed passed to the OS
is credited to the kernel's entropy pool by the system manager during early boot, and permits
userspace to boot up with an entropy pool fully initialized very early on. Also see
<listitem><para>Generates a random seed and stores it in the EFI System Partition (ESP), for use by
the <command>systemd-boot</command> boot loader. If a random seed already exists in the ESP it is
refreshed. Also generates a random 'system token' and stores it persistently as an EFI variable, if
one has not been set before. If the boot loader finds the random seed in the ESP and the system token
in the EFI variable it will derive a random seed to pass to the OS and a new seed to store in the ESP
from the combination of both. The random seed passed to the OS is credited to the kernel's entropy
pool by the system manager during early boot, and permits userspace to boot up with an entropy pool
fully initialized very early on. Also see
<citerefentry><refentrytitle>systemd-boot-random-seed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
<para>See <ulink url="https://systemd.io/RANDOM_SEEDS">Random Seeds</ulink> for further

3
src/boot/bootctl.c
View file

@ -159,7 +159,8 @@ static int help(int argc, char *argv[], void *userdata) {
" update Update systemd-boot in the ESP and EFI variables\n"
" remove Remove systemd-boot from the ESP and EFI variables\n"
" is-installed Test whether systemd-boot is installed in the ESP\n"
" random-seed Initialize random seed in ESP and EFI variables\n"
" random-seed Initialize or refresh random seed in ESP and EFI\n"
" variables\n"
"\n%3$sKernel Image Commands:%4$s\n"
" kernel-identify Identify kernel image type\n"
" kernel-inspect Prints details about the kernel image\n"