diff --git a/man/loader.conf.xml b/man/loader.conf.xml index 3bd8597164..1d441654f8 100644 --- a/man/loader.conf.xml +++ b/man/loader.conf.xml @@ -53,6 +53,12 @@ Those files are described by the Boot Loader Specification. + + Note: the behaviour of systemd-boot is also influenced by EFI variables. Some of + the settings specified in this file can be overridden by those, for example the default boot menu entry + or the menu timeouts. See + systemd-boot7 for + details. diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml index 3482968812..14e5cd6f96 100644 --- a/man/systemd-boot.xml +++ b/man/systemd-boot.xml @@ -149,6 +149,8 @@ d Make selected entry the default + An EFI variable is set to allow this setting to persist. + @@ -164,6 +166,8 @@ t Increase the timeout before default entry is booted + An EFI variable is set to allow this setting to persist. + @@ -172,6 +176,8 @@ T Decrease the timeout + An EFI variable is set to allow this setting to persist. + @@ -179,6 +185,8 @@ r Change screen resolution, skipping any unsupported modes. + An EFI variable is set to allow this setting to persist. + @@ -186,6 +194,8 @@ R Reset screen resolution to firmware or configuration file default. + An EFI variable is set to allow this setting to persist. + @@ -389,9 +399,9 @@ EFI Variables - The following EFI variables are defined, set and read by systemd-boot, under the - vendor UUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4f, for communication between the boot - loader and the OS: + The following EFI variables are defined, and may be set or read by systemd-boot + for communication between the boot loader and the OS. The vendor UUID + 4a67b082-0a4c-41cf-b6c7-440b29bb8c4f is used in all cases. @@ -465,13 +475,13 @@ LoaderEntrySysFail LoaderEntryOneShot - The identifier of the default boot loader entry. Set primarily by the OS and read by the boot + The identifier of the default boot loader entry. Can be set in the OS and the boot loader. LoaderEntryOneShot sets the default entry for the next boot only, while - LoaderEntryDefault sets it persistently for all future - boots. bootctl1's - and commands make use of these variables. The boot - loader modifies LoaderEntryDefault on request, when the d key is used, see - above. + LoaderEntryDefault sets it persistently for all future boots. + bootctl1's + and commands make use of these variables. + The boot loader modifies LoaderEntryDefault on request, when the + d key is used, see above.