.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "EFIBOOTMGR" "8" "11 August 2003" "" ""
+.TH "EFIBOOTMGR" "8" "11 August 2005" "" ""
+
.SH NAME
efibootmgr \- manipulate the EFI Boot Manager
.SH SYNOPSIS
-\fBefibootmgr\fR [ \fB-a\fR] [ \fB-A\fR] [ \fB-b \fIXXXX\fB\fR] [ \fB-B \fIXXXX\fB\fR] [ \fB-c\fR] [ \fB-d \fIDISK\fB\fR] [ \fB-e \fI1|3|-1\fB\fR] [ \fB-E \fINUM\fB\fR] [ \fB-g\fR] [ \fB-H \fIXXXX\fB\fR] [ \fB-i \fINAME\fB\fR] [ \fB-l \fINAME\fB\fR] [ \fB-L \fILABEL\fB\fR] [ \fB-n \fIXXXX\fB\fR] [ \fB-N\fR] [ \fB-o \fIXXXX\fB,\fIYYYY\fB,\fIZZZZ\fB\fR\fI ...\fR] [ \fB-O\fR] [ \fB-p \fIPART\fB\fR] [ \fB-q\fR] [ \fB-t\fR] [ \fB-u\fR] [ \fB-U \fIXXXX\fB\fR] [ \fB-v\fR] [ \fB-V\fR] [ \fB-w\fR]
+\fBefibootmgr\fR [ \fB-a\fR ] [ \fB-A\fR ] [ \fB-b \fIXXXX\fB\fR ] [ \fB-B \fIXXXX\fB\fR ] [ \fB-c\fR ] [ \fB-d \fIDISK\fB\fR ] [ \fB-e \fI1|3|-1\fB\fR ] [ \fB-E \fINUM\fB\fR ] [ \fB-g\fR ] [ \fB-H \fIXXXX\fB\fR ] [ \fB-i \fINAME\fB\fR ] [ \fB-l \fINAME\fB\fR ] [ \fB-L \fILABEL\fB\fR ] [ \fB-n \fIXXXX\fB\fR ] [ \fB-N\fR ] [ \fB-o \fIXXXX\fB,\fIYYYY\fB,\fIZZZZ\fB\fR\fI ...\fR ] [ \fB-O\fR ] [ \fB-p \fIPART\fB\fR ] [ \fB-q\fR ] [ \fB-t \fIseconds\fB\fR ] [ \fB-T\fR ] [ \fB-u\fR ] [ \fB-U \fIXXXX\fB\fR ] [ \fB-v\fR ] [ \fB-V\fR ] [ \fB-w\fR ] [ \fB-@ \fIfile\fB\fR ]
.SH "DESCRIPTION"
.PP
.RS
.B "Note:"
efibootmgr requires that the kernel support access to EFI
-non-volatile variables (through \fI/proc/efi/vars\fR).
+non-volatile variables (through
+\fI/proc/efi/vars\fR on 2.4 kernels,
+\fI/sys/firmware/efi/vars\fR on 2.6 kernels).
\fBmodprobe efivars\fR should do the trick.
.RE
.SH "OPTIONS"
\fB-q | --quiet\fR
Quiet mode - supresses output.
.TP
-\fB-t | --test \fIfilename\fB\fR
-Don't write to NVRAM, write to \fIfilename\fR.
+\fB--test \fIfilename\fB\fR
+Don't write to NVRAM, write to \fIfilename\fR\&.
+.TP
+\fB-t | --timeout \fIseconds\fB\fR
+Boot Manager timeout, in \fIseconds\fR\&.
+.TP
+\fB-T | --delete-timeout\fR
+Delete Timeout variable.
.TP
\fB-u | --unicode | --UCS-2 \fR
pass extra command line arguments as UCS-2 (default is
.TP
\fB-w | --write-signature\fR
write unique signature to the MBR if needed
+.TP
+\fB-@ | --append-binary-args \fR
+append extra variable args from file (use - to read
+from stdin). Data in file is appended as command line
+arguments to the boot loader command, with no modification to
+the data, so you can pass any binary or text data necessary.
.SH "EXAMPLES"
-.TP 1.
+.TP 3
+1.
.SS "DISPLAYING THE CURRENT SETTINGS (MUST BE ROOT)."
.PP
[root@localhost ~]# efibootmgr
BootCurrent: 0004
BootNext: 0003
BootOrder: 0004,0000,0001,0002,0003
+Timeout: 30 seconds
Boot0000* Diskette Drive(device:0)
Boot0001* CD-ROM Drive(device:FF)
Boot0002* Hard Drive(Device:80)/HD(Part1,Sig00112233)
to change the next boot behavior without changing BootOrder.
.TP 0.2i
\(bu
+Timeout - the time in seconds between when the boot
+manager appears on the screen until when it
+automatically chooses the startup value from BootNext
+or BootOrder.
+.TP 0.2i
+\(bu
Five boot entries (0000 - 0004), along with the active/inactive
flag (* means active) and the name displayed on the screen.
.RE
-.TP 2.
+.TP 3
+2.
.SS "CREATING A NEW BOOT OPTION"
.PP
-An OS installer would call \fBefibootmgr -c\fR.
+An OS installer would call \fBefibootmgr -c\fR\&.
This assumes that \fI/boot/efi\fR is your EFI System
-Partition, and is mounted at \fI/dev/sda1\fR. This
+Partition, and is mounted at \fI/dev/sda1\fR\&. This
creates a new boot option, called "Linux", and puts it at the top of
the boot order list. Options may be passed to modify the default
-behavior. The default OS Loader is \fIelilo.efi\fR.
-.TP 3.
+behavior. The default OS Loader is \fIelilo.efi\fR\&.
+.TP 3
+3.
.SS "CHANGING THE BOOT ORDER"
.PP
Assuming the configuration in Example #1,
\fBefibootmgr -o 3,4\fR could be called to specify
PXE boot first, then Linux boot.
-.TP 4.
+.TP 3
+4.
.SS "CHANGING THE BOOT ORDER FOR THE NEXT BOOT ONLY"
.PP
Assuming the configuration in Example #1,
\fBefibootmgr -n 4\fR could be called to specify
that the Linux entry be taken on next boot.
-.TP 5.
+.TP 3
+5.
.SS "DELETING A BOOT OPTION"
.PP
Assuming the configuration in Example #1,
\fBefibootmgr -b 4 -B\fR could be called to delete
entry 4 and remove it from the BootOrder.
-.TP 6.
+.TP 3
+6.
.SS "CREATING NETWORK BOOT ENTRIES"
.PP
A system administrator wants to create a boot option to network
.SH "BUGS"
.PP
Please direct any bugs, features, patches, etc. to Matt Domsch
-<Matt_Domsch@dell.com>.
+<Matt_Domsch@dell.com>\&.
.SH "AUTHOR"
.PP
This man page was generated by dann frazier <dannf@debian.org> for the