1BOOTCTL(1)                          bootctl                         BOOTCTL(1)
2
3
4

NAME

6       bootctl - Control the firmware and boot manager settings
7

SYNOPSIS

9       bootctl [OPTIONS...] {COMMAND}
10

DESCRIPTION

12       bootctl can check the EFI boot loader status, list available entries,
13       and install, update, or remove the systemd-boot(7) boot loader on the
14       current system.
15

OPTIONS

17       The following options are understood:
18
19       -h, --help
20           Print a short help text and exit.
21
22       --version
23           Print a short version string and exit.
24
25       --path=
26           Path to the EFI System Partition (ESP). If not specified, /efi,
27           /boot, and /boot/efi are checked in turn. It is recommended to
28           mount the ESP to /boot, if possible.
29
30       -p, --print-path
31           This option modifies the behaviour of status. Just print the path
32           to the EFI System Partition (ESP) to standard output and exit.
33
34       --no-variables
35           Do not touch the EFI boot variables.
36

COMMANDS

38       status
39           Shows the currently installed versions of the boot loader binaries
40           and all current EFI boot variables. If no command is specified,
41           this is the implied default.
42
43       list
44           Shows all configured boot loader entries.
45
46       update
47           Updates all installed versions of systemd-boot(7), if the current
48           version is newer than the version installed in the EFI system
49           partition. This also includes the EFI default/fallback loader at
50           ESP/EFI/BOOT/BOOT*.EFI. A systemd-boot entry in the EFI boot
51           variables is created if there is no current entry. The created
52           entry will be added to the end of the boot order list.
53
54       install
55           Installs systemd-boot into the EFI system partition. A copy of
56           systemd-boot will be stored as the EFI default/fallback loader at
57           ESP/EFI/BOOT/BOOT*.EFI. A systemd-boot entry in the EFI boot
58           variables is created and added to the top of the boot order list.
59
60       remove
61           Removes all installed versions of systemd-boot from the EFI system
62           partition, and removes systemd-boot from the EFI boot variables.
63

EXIT STATUS

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

SEE ALSO

68       systemd-boot(7), Boot Loader Specification[1], Boot Loader Interface[2]
69

NOTES

71        1. Boot Loader Specification
72           https://github.com/systemd/systemd/blob/master/doc/BOOT_LOADER_SPECIFICATION.md
73
74        2. Boot Loader Interface
75           https://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface
76
77
78
79systemd 239                                                         BOOTCTL(1)
Impressum