system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-10-15 20:45:09 +00:00
Code Issues 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> <varlistentry>
<term><option>random-seed</option></term> <term><option>random-seed</option></term>
<listitem><para>Generates a random seed and stores it in the EFI System Partition, for use by the <listitem><para>Generates a random seed and stores it in the EFI System Partition (ESP), for use by
<command>systemd-boot</command> boot loader. Also, generates a random 'system token' and stores it the <command>systemd-boot</command> boot loader. If a random seed already exists in the ESP it is
persistently as an EFI variable, if one has not been set before. If the boot loader finds the random refreshed. Also generates a random 'system token' and stores it persistently as an EFI variable, if
seed in the ESP and the system token in the EFI variable it will derive a random seed to pass to the one has not been set before. If the boot loader finds the random seed in the ESP and the system token
OS and a new seed to store in the ESP from the combination of both. The random seed passed to the OS in the EFI variable it will derive a random seed to pass to the OS and a new seed to store in the ESP
is credited to the kernel's entropy pool by the system manager during early boot, and permits from the combination of both. The random seed passed to the OS is credited to the kernel's entropy
userspace to boot up with an entropy pool fully initialized very early on. Also see 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> <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 <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" " update Update systemd-boot in the ESP and EFI variables\n"
" remove Remove systemd-boot from 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" " 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" "\n%3$sKernel Image Commands:%4$s\n"
" kernel-identify Identify kernel image type\n" " kernel-identify Identify kernel image type\n"
" kernel-inspect Prints details about the kernel image\n" " kernel-inspect Prints details about the kernel image\n"