'\" t
.TH "BOOTCTL" "1" "" "systemd 239" "bootctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bootctl \- Control the firmware and boot manager settings
.SH "SYNOPSIS"
.HP \w'\fBbootctl\fR\ 'u
\fBbootctl\fR [OPTIONS...] {COMMAND}
.SH "DESCRIPTION"
.PP
\fBbootctl\fR
can check the EFI boot loader status, list available entries, and install, update, or remove the
\fBsystemd-boot\fR(7)
boot loader on the current system\&.
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print a short version string and exit\&.
.RE
.PP
\fB\-\-path=\fR
.RS 4
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\&.
.RE
.PP
\fB\-p\fR, \fB\-\-print\-path\fR
.RS 4
This option modifies the behaviour of
\fBstatus\fR\&. Just print the path to the EFI System Partition (ESP) to standard output and exit\&.
.RE
.PP
\fB\-\-no\-variables\fR
.RS 4
Do not touch the EFI boot variables\&.
.RE
.SH "COMMANDS"
.PP
\fBstatus\fR
.RS 4
Shows the currently installed versions of the boot loader binaries and all current EFI boot variables\&. If no command is specified, this is the implied default\&.
.RE
.PP
\fBlist\fR
.RS 4
Shows all configured boot loader entries\&.
.RE
.PP
\fBupdate\fR
.RS 4
Updates all installed versions of
\fBsystemd-boot\fR(7), if the current version is newer than the version installed in the EFI system partition\&. This also includes the EFI default/fallback loader at
\fIESP\fR/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\&.
.RE
.PP
\fBinstall\fR
.RS 4
Installs systemd\-boot into the EFI system partition\&. A copy of systemd\-boot will be stored as the EFI default/fallback loader at
\fIESP\fR/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\&.
.RE
.PP
\fBremove\fR
.RS 4
Removes all installed versions of systemd\-boot from the EFI system partition, and removes systemd\-boot from the EFI boot variables\&.
.RE
.SH "EXIT STATUS"
.PP
On success, 0 is returned, a non\-zero failure code otherwise\&.
.SH "SEE ALSO"
.PP
\fBsystemd-boot\fR(7),
\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2,
\m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[2]\d\s+2
.SH "NOTES"
.IP " 1." 4
Boot Loader Specification
.RS 4
\%https://github.com/systemd/systemd/blob/master/doc/BOOT_LOADER_SPECIFICATION.md
.RE
.IP " 2." 4
Boot Loader Interface
.RS 4
\%https://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface
.RE
