diff --git a/man/bootctl.xml b/man/bootctl.xml index ada8c03332c..52c9179cd0f 100644 --- a/man/bootctl.xml +++ b/man/bootctl.xml @@ -85,9 +85,10 @@ Boot Loader Specification Commands - These commands are available for all boot loaders that implement the Boot Loader Specification and/or the Boot Loader Interface, such as + These commands are available for all boot loaders that + implement the Boot + Loader Specification, such as systemd-boot. @@ -104,6 +105,32 @@ + + ID + + Removes a boot loader entry including the files it refers to. Takes a single boot + loader entry ID string or a glob pattern as argument. Referenced files such as kernel or initrd are + only removed if no other entry refers to them. + + + + + + Removes files from the ESP and XBOOTLDR partitions that belong to the entry token but + are not referenced in any boot loader entries. + + + + + + Boot Loader Interface Commands + + These commands are available for all boot loaders that implement the Boot Loader Specification and the Boot Loader Interface, such as + systemd-boot. + + ID ID @@ -153,21 +180,6 @@ disables the timeout while always showing the menu. When an empty string ("") is specified the bootloader will revert to its default menu timeout. - - - ID - - Removes a boot loader entry including the files it refers to. Takes a single boot - loader entry ID string or a glob pattern as argument. Referenced files such as kernel or initrd are - only removed if no other entry refers to them. - - - - - - Removes files from the ESP and XBOOTLDR partitions that belong to the entry token but - are not referenced in any boot loader entries. - @@ -233,7 +245,7 @@ - <command>kernel</command> Commands + Kernel Image Commands diff --git a/src/boot/bootctl.c b/src/boot/bootctl.c index 14a692ad1bd..914825564eb 100644 --- a/src/boot/bootctl.c +++ b/src/boot/bootctl.c @@ -131,32 +131,33 @@ static int help(int argc, char *argv[], void *userdata) { if (r < 0) return log_oom(); - printf("%1$s [OPTIONS...] COMMAND ...\n" + printf("%1$s [OPTIONS...] COMMAND ...\n" "\n%5$sControl EFI firmware boot settings and manage boot loader.%6$s\n" "\n%3$sGeneric EFI Firmware/Boot Loader Commands:%4$s\n" - " status Show status of installed boot loader and EFI variables\n" + " status Show status of installed boot loader and EFI variables\n" " reboot-to-firmware [BOOL]\n" - " Query or set reboot-to-firmware EFI flag\n" + " Query or set reboot-to-firmware EFI flag\n" " systemd-efi-options [STRING]\n" - " Query or set system options string in EFI variable\n" + " Query or set system options string in EFI variable\n" "\n%3$sBoot Loader Specification Commands:%4$s\n" - " list List boot loader entries\n" - " set-default ID Set default boot loader entry\n" - " set-oneshot ID Set default boot loader entry, for next boot only\n" - " set-timeout SECONDS Set the menu timeout\n" + " list List boot loader entries\n" + " unlink ID Remove boot loader entry\n" + " cleanup Remove files in ESP not referenced in any boot entry\n" + "\n%3$sBoot Loader Interface Commands:%4$s\n" + " set-default ID Set default boot loader entry\n" + " set-oneshot ID Set default boot loader entry, for next boot only\n" + " set-timeout SECONDS Set the menu timeout\n" " set-timeout-oneshot SECONDS\n" - " Set the menu timeout for the next boot only\n" - " unlink ID Remove boot loader entry\n" - " cleanup Remove files in ESP not referenced in any boot entry\n" + " Set the menu timeout for the next boot only\n" "\n%3$ssystemd-boot Commands:%4$s\n" - " install Install systemd-boot to 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" - " is-installed Test whether systemd-boot is installed in the ESP\n" - " random-seed Initialize random seed in ESP and EFI variables\n" - "\n%3$skernel Commands:%4$s\n" - " kernel-identify Identify kernel image type.\n" - " kernel-inspect Prints details about the kernel.\n" + " install Install systemd-boot to 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" + " is-installed Test whether systemd-boot is installed in the ESP\n" + " random-seed Initialize random seed in ESP and EFI variables\n" + "\n%3$sKernel Image Commands:%4$s\n" + " kernel-identify Identify kernel image type\n" + " kernel-inspect Prints details about the kernel image\n" "\n%3$sOptions:%4$s\n" " -h --help Show this help\n" " --version Print version\n"