1BOOTCTL(1) bootctl BOOTCTL(1)
2
3
4
6 bootctl - Control the firmware and boot manager settings
7
9 bootctl [OPTIONS...] {COMMAND}
10
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
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
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
65 On success, 0 is returned, a non-zero failure code otherwise.
66
68 systemd-boot(7), Boot Loader Specification[1], Boot Loader Interface[2]
69
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)