BOOTCTL(1)                         bootctl                        BOOTCTL(1)

NAME         top

       bootctl - Control the firmware and boot manager settings

SYNOPSIS         top

       bootctl [OPTIONS...] status

       bootctl [OPTIONS...] update

       bootctl [OPTIONS...] install

       bootctl [OPTIONS...] remove

DESCRIPTION         top

       bootctl checks, updates, installs or removes the boot loader from the
       current system.

       bootctl status checks and prints the currently installed versions of
       the boot loader binaries and all current EFI boot variables.

       bootctl update updates all installed versions of systemd-boot, if the
       current version is newer than the version installed in the EFI system
       partition. This also includes the EFI default/fallback loader at
       /EFI/BOOT/BOOT*.EFI. A systemd-boot entry in the EFI boot variables
       is created if there is no current entry. The created entry will be
       added to the end of the boot order list.

       bootctl install installs systemd-boot into the EFI system partition.
       A copy of systemd-boot will be stored as the EFI default/fallback
       loader at /EFI/BOOT/BOOT*.EFI. A systemd-boot entry in the EFI boot
       variables is created and added to the top of the boot order list.

       bootctl remove removes all installed versions of systemd-boot from
       the EFI system partition, and removes systemd-boot from the EFI boot

       If no command is passed, status is implied.

OPTIONS         top

       The following options are understood:

       -h, --help
           Print a short help text and exit.

           Print a short version string and exit.

           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.

           Do not touch the EFI boot variables.

EXIT STATUS         top

       On success, 0 is returned, a non-zero failure code otherwise.

SEE ALSO         top

       Boot loader specification[1]Systemd boot loader interface[2]

NOTES         top

        1. Boot loader specification

        2. Systemd boot loader interface

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-10-29.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-10-29.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

systemd 234                                                       BOOTCTL(1)

Pages that refer to this page: systemd.directives(7)systemd.index(7)