NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | SEE ALSO | NOTES | COLOPHON

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
       variables.

       If no command is passed, status is implied.

OPTIONS         top

       The following options are understood:

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

       --version
           Print a short version string and exit.

       --path=
           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.

       --no-variables
           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
           http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec

        2. Systemd boot loader interface
           http://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a bug
       report for this manual page, see 
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.  This
       page was obtained from the project's upstream Git repository 
       ⟨https://github.com/systemd/systemd.git⟩ on 2016-09-01.  If you dis‐
       cover 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 man-pages@man7.org

systemd 231                                                       BOOTCTL(1)