]>
Commit | Line | Data |
---|---|---|
1 | '\" t | |
2 | .TH "BOOTCTL" "1" "" "systemd 220" "bootctl" | |
3 | .\" ----------------------------------------------------------------- | |
4 | .\" * Define some portability stuff | |
5 | .\" ----------------------------------------------------------------- | |
6 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
7 | .\" http://bugs.debian.org/507673 | |
8 | .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | |
9 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
10 | .ie \n(.g .ds Aq \(aq | |
11 | .el .ds Aq ' | |
12 | .\" ----------------------------------------------------------------- | |
13 | .\" * set default formatting | |
14 | .\" ----------------------------------------------------------------- | |
15 | .\" disable hyphenation | |
16 | .nh | |
17 | .\" disable justification (adjust text to left margin only) | |
18 | .ad l | |
19 | .\" ----------------------------------------------------------------- | |
20 | .\" * MAIN CONTENT STARTS HERE * | |
21 | .\" ----------------------------------------------------------------- | |
22 | .SH "NAME" | |
23 | bootctl \- Control the firmware and boot manager settings | |
24 | .SH "SYNOPSIS" | |
25 | .HP \w'\fBbootctl\ \fR\fB[OPTIONS...]\fR\fBstatus\fR\ 'u | |
26 | \fBbootctl \fR\fB[OPTIONS...]\fR\fBstatus\fR | |
27 | .HP \w'\fBbootctl\ \fR\fB[OPTIONS...]\fR\fBupdate\fR\ 'u | |
28 | \fBbootctl \fR\fB[OPTIONS...]\fR\fBupdate\fR | |
29 | .HP \w'\fBbootctl\ \fR\fB[OPTIONS...]\fR\fBinstall\fR\ 'u | |
30 | \fBbootctl \fR\fB[OPTIONS...]\fR\fBinstall\fR | |
31 | .HP \w'\fBbootctl\ \fR\fB[OPTIONS...]\fR\fBremove\fR\ 'u | |
32 | \fBbootctl \fR\fB[OPTIONS...]\fR\fBremove\fR | |
33 | .SH "DESCRIPTION" | |
34 | .PP | |
35 | \fBbootctl\fR | |
36 | checks, updates, installs or removes the boot loader from the current system\&. | |
37 | .PP | |
38 | \fBbootctl status\fR | |
39 | checks and prints the currently installed versions of the boot loader binaries and the all current EFI boot variables\&. | |
40 | .PP | |
41 | \fBbootctl update\fR | |
42 | updates all installed versions of systemd\-boot, if the current version is newer than the version installed in the EFI system partition\&. This also includes the EFI default/fallback loader at /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\&. | |
43 | .PP | |
44 | \fBbootctl install\fR | |
45 | installs systemd\-boot into the EFI system partition\&. A copy of systemd\-boot will be stored as the EFI default/fallback loader at /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\&. | |
46 | .PP | |
47 | \fBbootctl remove\fR | |
48 | removes all installed versions of systemd\-boot from the EFI system partition, and removes systemd\-boot from the EFI boot variables\&. | |
49 | .PP | |
50 | If no command is passed | |
51 | \fBstatus\fR | |
52 | is implied\&. | |
53 | .SH "OPTIONS" | |
54 | .PP | |
55 | The following options are understood: | |
56 | .PP | |
57 | \fB\-h\fR, \fB\-\-help\fR | |
58 | .RS 4 | |
59 | Print a short help text and exit\&. | |
60 | .RE | |
61 | .PP | |
62 | \fB\-\-version\fR | |
63 | .RS 4 | |
64 | Print a short version string and exit\&. | |
65 | .RE | |
66 | .PP | |
67 | \fB\-\-path\fR | |
68 | .RS 4 | |
69 | Path to the EFI system partition\&. The default is /boot\&. | |
70 | .RE | |
71 | .PP | |
72 | \fB\-\-no\-variables\fR | |
73 | .RS 4 | |
74 | Do not touch the EFI boot variables\&. | |
75 | .RE | |
76 | .SH "EXIT STATUS" | |
77 | .PP | |
78 | On success 0 is returned, a non\-zero failure code otherwise\&. | |
79 | .SH "SEE ALSO" | |
80 | .PP | |
81 | \m[blue]\fBBoot loader specification\fR\m[]\&\s-2\u[1]\d\s+2\m[blue]\fBSystemd boot loader interface\fR\m[]\&\s-2\u[2]\d\s+2 | |
82 | .SH "NOTES" | |
83 | .IP " 1." 4 | |
84 | Boot loader specification | |
85 | .RS 4 | |
86 | \%http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec | |
87 | .RE | |
88 | .IP " 2." 4 | |
89 | Systemd boot loader interface | |
90 | .RS 4 | |
91 | \%http://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface | |
92 | .RE |