diff options
| author | Emil Velikov <emil.velikov@collabora.com> | 2023-10-04 13:55:52 +0200 |
|---|---|---|
| committer | Emil Velikov <emil.l.velikov@gmail.com> | 2023-10-17 16:09:53 +0200 |
| commit | 6efdd7fec5106205240332bd3b7fd2f93d4d9d4c (patch) | |
| tree | f2fc24522107b0a5481ee3d70c0756cb674842da /man/bootctl.xml | |
| parent | bootctl, sd-boot: cross document the menu-hidden/force ABI (diff) | |
| download | systemd-6efdd7fec5106205240332bd3b7fd2f93d4d9d4c.tar.xz systemd-6efdd7fec5106205240332bd3b7fd2f93d4d9d4c.zip | |
sd-boot: add way to disable the 100ms delay when timeout=0
Currently we have a 100ms delay which allows for people to enter/show
the boot menu even when timeout is set to zero.
In a handful of cases, that may not be needed - both in terms of access
policy, as well as latency.
For example: the option to provide the boot menu may be hidden behind an
"expert only" UX in the OS, to avoid end users from accidentally
entering it.
In addition, the current 100ms input polling may cause unexpected
additional delays in the boot. Some example numbers from my SteamDeck:
- boot counting/rename/flush doubles 300us -> 600us
- seed/hash setup doubles 900us -> 1800us
- kernel/image load gets ~40% slower 107ms -> 167ms
It's not entirely clear why the UEFI calls gets slower, nevertheless the
information in itself proves useful.
This commit introduces a new option "menu-disabled", which omits the
100ms delay. The option is documented throughout the manual pages as
well as the Boot Loader Specification.
v2:
- use STR_IN_SET
v3:
- drop erroneous whitespace
v4:
- add a new LoaderFeature bit,
- don't change ABI keep TIMEOUT_* tokens the same
- move new token in the 64bit range, update API and storage for it
- change inc/dec behaviour to TIMEOUT_MIN : TIMEOUT_MENU_FORCE
- user cannot opt-in from sd-boot itself, add assert_not_reached()
v5:
- s/Menu disablement control/Menu can be disabled/
- rewrap comments to 109
- use SYNTHETIC_ERRNO(EOPNOTSUPP)
Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
Diffstat (limited to 'man/bootctl.xml')
| -rw-r--r-- | man/bootctl.xml | 9 |
1 files changed, 5 insertions, 4 deletions
diff --git a/man/bootctl.xml b/man/bootctl.xml index 02ae5e1231..b2091eedf0 100644 --- a/man/bootctl.xml +++ b/man/bootctl.xml @@ -177,10 +177,10 @@ <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for details about the syntax of time spans.</para> - <para>If this is set to <option>menu-hidden</option> or <option>0</option> no menu is shown and - the default entry will be booted immediately, while setting this to <option>menu-force</option> - disables the timeout while always showing the menu. When an empty string ("") is specified the - bootloader will revert to its default menu timeout.</para> + <para>If this is set to <option>menu-disabled</option> or <option>menu-hidden</option> or + <option>0</option>, no menu is shown and the default entry will be booted immediately, while + setting this to <option>menu-force</option> disables the timeout while always showing the menu. + When an empty string ("") is specified the bootloader will revert to its default menu timeout.</para> <xi:include href="version-info.xml" xpointer="v250"/></listitem> </varlistentry> @@ -555,6 +555,7 @@ Current Boot Loader: ← details about sd-boot or anothe ✓ Support for passing random seed to OS ✓ Load drop-in drivers ✓ Boot loader sets ESP information + ✓ Menu can be disabled ESP: /dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000 File: └─/EFI/systemd/systemd-bootx64.efi |