X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=src%2Fman%2Fman8%2Fefibootmgr.8;h=214ab89d1e92d879f9c7fd36049cca74dd315689;hb=b8985d333f4d34d259d53436c7adbb2bbc8cee60;hp=a2f6d49d54e5ed1f8b0bb7205893ebc2f962c6ea;hpb=98db23750431fa650821f391aca2ce1898cb8020;p=debian%2Fefibootmgr diff --git a/src/man/man8/efibootmgr.8 b/src/man/man8/efibootmgr.8 index a2f6d49..214ab89 100644 --- a/src/man/man8/efibootmgr.8 +++ b/src/man/man8/efibootmgr.8 @@ -3,12 +3,13 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.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 @@ -24,7 +25,9 @@ Specification, v1.02 or later, available from: .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" @@ -89,8 +92,14 @@ Partition number containing the bootloader (defaults to 1) \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 @@ -107,14 +116,22 @@ Just print version string and exit. .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) @@ -140,37 +157,48 @@ deleted by the boot manager after first use. This allows you 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 @@ -190,7 +218,7 @@ You create the boot entry with: .SH "BUGS" .PP Please direct any bugs, features, patches, etc. to Matt Domsch -. +\&. .SH "AUTHOR" .PP This man page was generated by dann frazier for the