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 boot
13       loaders and boot loader entries, and install, update, or remove the
14       systemd-boot(7) boot loader on the current system.
15

OPTIONS

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

COMMANDS

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

EXIT STATUS

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

ENVIRONMENT

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

SEE ALSO

86       systemd-boot(7), Boot Loader Specification[1], Boot Loader Interface[2]
87

NOTES

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)
Impressum