diff --git a/man/bootctl.xml b/man/bootctl.xml index 9cfa9cccdf4..41165cd09a5 100644 --- a/man/bootctl.xml +++ b/man/bootctl.xml @@ -46,18 +46,34 @@ - - Path to the EFI System Partition (ESP). If not specified, /efi, - /boot, and /boot/efi are checked in turn. It is recommended to mount - the ESP to /boot, if possible. + + Path to the EFI System Partition (ESP). If not specified, /efi/, + /boot/, and /boot/efi are checked in turn. It is recommended to mount + the ESP to /efi/, if possible. + + + + + Path to the Extended Boot Loader partition, as defined in the Boot Loader Specification. If not + specified, /boot/ are checked. It is recommended to mount the Extended Boot + Loader partition to /boot/, if possible. - - This option modifies the behaviour of status. - Just print the path to the EFI System Partition (ESP) to standard output and - exit. + + This option modifies the behaviour of status. Prints only the + path to the EFI System Partition (ESP) to standard output and exits. + + + + + This option modifies the behaviour of status. Prints only the + path to the Extended Boot Loader partition if it exists, and the path to the ESP otherwise to + standard output and exit. This command is useful to determine where to place boot loader entries, as + they are preferably placed in the Extended Boot Loader partition if it exists and in the ESP + otherwise. @@ -87,10 +103,10 @@ - Installs systemd-boot into the EFI system partition. A copy of systemd-boot - will be stored as the EFI default/fallback loader at - ESP/EFI/BOOT/BOOT*.EFI. The boot loader is then added to the - top of the firmware's boot loader list. + Installs systemd-boot into the EFI system partition. A copy of + systemd-boot will be stored as the EFI default/fallback loader at + ESP/EFI/BOOT/BOOT*.EFI. The boot loader is then added + to the top of the firmware's boot loader list. @@ -138,9 +154,12 @@ Environment - If $SYSTEMD_RELAX_ESP_CHECKS=1 is set the validation checks for the ESP are relaxed, and - the path specified with may refer to any kind of file system on any kind of - partition. + If $SYSTEMD_RELAX_ESP_CHECKS=1 is set the validation checks for the ESP are + relaxed, and the path specified with may refer to any kind of file system on + any kind of partition. + + Similarly, $SYSTEMD_RELAX_XBOOTLDR_CHECKS=1 turns off some validation checks for + the Extended Boot Loader partition.