From c5fcaed88161eb38418e5a90c018f0cf31175b53 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 12 Feb 2019 16:13:57 +0100 Subject: man: document XBOOTLDR search logic for sd-boot --- man/systemd-boot.xml | 62 ++++++++++++++++++++++++++++------------------------ 1 file changed, 34 insertions(+), 28 deletions(-) (limited to 'man') diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml index 4c914e6156..0ec7a47b51 100644 --- a/man/systemd-boot.xml +++ b/man/systemd-boot.xml @@ -25,27 +25,28 @@ Description - systemd-boot (short: sd-boot) is a simple UEFI boot manager. It - provides a graphical menu to select the entry to boot and an editor for the kernel command line. systemd-boot - supports systems with UEFI firmware only. + systemd-boot (short: sd-boot) is a simple UEFI boot + manager. It provides a graphical menu to select the entry to boot and an editor for the kernel command + line. systemd-boot supports systems with UEFI firmware only. systemd-boot loads boot entry information from the EFI system partition (ESP), usually mounted at - /boot, /efi, or /boot/efi during OS - runtime. Configuration file fragments, kernels, initrds and other EFI images to boot generally need to reside on - the ESP. Linux kernels must be built with to be able to be directly executed as an - EFI image. During boot systemd-boot automatically assembles a list of boot entries from the following - sources: + /efi/, /boot/, or /boot/efi/ during OS + runtime, as well as from the Extended Boot Loader partition if it exists (usually mounted to + /boot/). Configuration file fragments, kernels, initrds and other EFI images to boot + generally need to reside on the ESP or the Extended Boot Loader partition. Linux kernels must be built + with to be able to be directly executed as an EFI image. During boot + systemd-boot automatically assembles a list of boot entries from the following sources: Boot entries defined with Boot Loader - Specification description files located in /loader/entries/ on the ESP. These - usually describe Linux kernel images with associated initrd images, but alternatively may also describe - arbitrary other EFI executables. + url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification description files + located in /loader/entries/ on the ESP and the Extended Boot Loader + Partition. These usually describe Linux kernel images with associated initrd images, but alternatively + may also describe arbitrary other EFI executables. Unified kernel images following the Boot Loader - Specification, as executable EFI binaries in /EFI/Linux/ on the ESP. + url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification, as executable EFI + binaries in /EFI/Linux/ on the ESP and the Extended Boot Loader Partition. The Microsoft Windows EFI boot manager, if installed @@ -57,10 +58,12 @@ A reboot into the UEFI firmware setup option, if supported by the firmware - kernel-install8 may be - used to copy kernel images onto the ESP and to generate description files compliant with the Boot Loader - Specification. bootctl1 may be - used from a running system to locate the ESP, list available entries, and install systemd-boot itself. + kernel-install8 + may be used to copy kernel images onto the ESP or the Extended Boot Loader Partition and to generate + description files compliant with the Boot Loader + Specification. bootctl1 + may be used from a running system to locate the ESP and the Extended Boot Loader Partition, list + available entries, and install systemd-boot itself. systemd-boot will provide information about the time spent in UEFI firmware using the Boot Loader Interface. This information can be displayed @@ -224,16 +227,19 @@ Files - The files systemd-boot reads generally reside on the UEFI ESP which is usually mounted to - /boot/, /efi/ or /boot/efi during OS - runtime. systemd-boot reads runtime configuration such as the boot timeout and default entry from - /loader/loader.conf on the ESP (in combination with data read from EFI variables). See - loader.conf5. Boot entry - description files following the Boot Loader - Specification are read from /loader/entries/ on the ESP. Unified kernel boot entries - following the Boot - Loader Specification are read from /EFI/Linux/ on the ESP. + The files systemd-boot processes generally reside on the UEFI ESP which is + usually mounted to /efi/, /boot/ or + /boot/efi/ during OS runtime. It also processes files on the Extended Boot Loader + partition which is typically mounted to /boot/, if it + exists. systemd-boot reads runtime configuration such as the boot timeout and default + entry from /loader/loader.conf on the ESP (in combination with data read from EFI + variables). See + loader.conf5. Boot + entry description files following the Boot + Loader Specification are read from /loader/entries/ on the ESP and the + Extended Boot Loader partition. Unified kernel boot entries following the Boot Loader Specification are read from + /EFI/Linux/ on the ESP and the Extended Boot Loader partition. -- cgit v1.2.1