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 boot
13 loaders and boot loader entries, and install, update, or remove the
14 systemd-boot(7) boot loader on the current system.
15
17 The following options are understood:
18
19 --path=
20 Path to the EFI System Partition (ESP). If not specified, /efi,
21 /boot, and /boot/efi are checked in turn. It is recommended to
22 mount the ESP to /boot, if possible.
23
24 -p, --print-path
25 This option modifies the behaviour of status. Just print the path
26 to the EFI System Partition (ESP) to standard output and exit.
27
28 --no-variables
29 Do not touch the firmware's boot loader list stored in EFI
30 variables.
31
32 --no-pager
33 Do not pipe output into a pager.
34
35 -h, --help
36 Print a short help text and exit.
37
38 --version
39 Print a short version string and exit.
40
42 status
43 Shows brief information about the system firmware, the boot loader
44 that was used to boot the system, the boot loaders currently
45 available in the ESP, the boot loaders listed in the firmware's
46 list of boot loaders and the current default boot loader entry. If
47 no command is specified, this is the implied default.
48
49 install
50 Installs systemd-boot into the EFI system partition. A copy of
51 systemd-boot will be stored as the EFI default/fallback loader at
52 ESP/EFI/BOOT/BOOT*.EFI. The boot loader is then added to the top of
53 the firmware's boot loader list.
54
55 update
56 Updates all installed versions of systemd-boot(7), if the available
57 version is newer than the version installed in the EFI system
58 partition. This also includes the EFI default/fallback loader at
59 ESP/EFI/BOOT/BOOT*.EFI. The boot loader is then added to end of the
60 firmware's boot loader list if missing.
61
62 remove
63 Removes all installed versions of systemd-boot from the EFI system
64 partition and the firmware's boot loader list.
65
66 list
67 Shows all available boot loader entries implementing the Boot
68 Loader Specification[1], as well as any other entries discovered or
69 automatically generated by the boot loader.
70
71 set-default ID, set-oneshot ID
72 Sets the default boot loader entry. Takes a single boot loader
73 entry ID string as argument. The set-oneshot command will set the
74 default entry only for the next boot, the set-default will set it
75 persistently for all future boots.
76
78 On success, 0 is returned, a non-zero failure code otherwise.
79
81 If $SYSTEMD_RELAX_ESP_CHECKS=1 is set the validation checks for the ESP
82 are relaxed, and the path specified with --path= may refer to any kind
83 of file system on any kind of partition.
84
86 systemd-boot(7), Boot Loader Specification[1], Boot Loader Interface[2]
87
89 1. Boot Loader Specification
90 https://systemd.io/BOOT_LOADER_SPECIFICATION
91
92 2. Boot Loader Interface
93 https://systemd.io/BOOT_LOADER_INTERFACE
94
95
96
97systemd 241 BOOTCTL(1)