*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> efibootmgr (8)              



NAME    [Toc]    [Back]

       efibootmgr -- manipulate the EFI Boot Manager

SYNOPSIS    [Toc]    [Back]

       efibootmgr  [-a]   [-A]	 [-b  XXXX]   [-B  XXXX]  [-c]	[-d DISK]  [-e
       1|3|-1]	[-E  NUM]   [-l  NAME]	 [-L  LABEL]   [-n  XXXX]   [-N]   [-o
       XXXX,YYYY,ZZZZ ...]  [-O]  [-p PART]  [-q]  [-v]  [-V]

DESCRIPTION    [Toc]    [Back]

       efibootmgr is a userspace application used to modify the Intel Extensible
 Firmware Interface (EFI) Boot Manager.  This application can create
       and  destroy  boot entries, change the boot order, change the next running
 boot option, and more.

       Details on the EFI Boot Manager are available from the  EFI  Specification,
 v1.02 or later, available from:
	(link to URL http://developer.intel.com)


	      efibootmgr  requires  that  the  kernel module efivars be loaded
	      prior to use.  'modprobe efivars' should do the trick.

OPTIONS    [Toc]    [Back]

       The following is a list of options accepted by efibootmgr:

       -a | --active
		 Sets bootnum active

       -A | --inactive
		 Sets bootnum inactive

       -b | --bootnum XXXX
		 Modify BootXXXX (hex)

       -B | --delete-bootnum
		 Delete bootnum (hex)

       -c | --create
		 Create new variable bootnum and add to bootorder

       -d | --disk DISK
		 The disk containing the loader (defaults to /dev/sda)

       -e | --edd 1|3|-1
		 Force EDD 1.0 or 3.0 creation variables, or guess.

       -E | --device NUM
		 EDD 1.0 device number (defaults to 0x80)

       -l | --loader NAME
		 Specify a loader (defaults to \elilo.efi)

       -L | --label LABEL
		 Boot manager display label (defaults to "Linux")

       -n | --bootnext XXXX
		 Set BootNext to XXXX (hex)

       -N | --delete-bootnext
		 Delete BootNext

       -o | --bootorder XXXX,YYYY,ZZZZ
		 Explicitly set BootOrder (hex)

       -O | --delete-bootorder
		 Delete BootOrder

       -p | --part PART
		 Partition number containing the bootloader (defaults to 1)

       -q | --quiet
		 Quiet mode - supresses output.

       -v | --verbose
		 Verbose mode - prints additional information

       -V | --version
		 Just print version string and exit.

EXAMPLES    [Toc]    [Back]


       Displaying the current settings (must be root).    [Toc]    [Back]

		   [root@localhost ~]# efibootmgr BootCurrent: 0004  BootNext:
		 0003  BootOrder:  0004,0000,0001,0002,0003 Boot0000* Diskette
		 Drive(device:0) Boot0001* CD-ROM  Drive(device:FF)  Boot0002*
		 Hard	Drive(Device:80)/HD(Part1,Sig00112233)	Boot0003*  PXE
		 Boot: MAC(00D0B7C15D91) Boot0004* Linux

		 This shows:

		    o  BootCurrent - the boot entry used  to  start  the  currently
 running system

		    o  BootOrder  - the boot order as would appear in the boot
		       manager.  The boot manager  tries  to  boot  the  first
		       active  entry  in this list.  If unsuccessful, it tries
		       the next entry, and so on.

		    o  BootNext - the boot entry which is scheduled to be  run
		       on  next  boot.	This supercedes BootOrder for one boot
		       only, and is deleted by the boot  manager  after  first
		       use.   This allows you to change the next boot behavior
		       without changing BootOrder.

		    o  Five  boot  entries  (0000  -  0004),  along  with  the
		       active/inactive flag (* means active) and the name displayed
 on the screen.


       Creating a new boot option    [Toc]    [Back]

		 An OS installer would call efibootmgr -c.  This assumes  that
		 /boot/efi  is	your  EFI  System Partition, and is mounted at
		 /dev/sda1.  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 elilo.efi.


       Changing the Boot Order    [Toc]    [Back]

		 Assuming  the	configuration in Example #1, efibootmgr -o 3,4
		 could be called to specify PXE boot first, then Linux boot.


       Changing the Boot Order for the Next Boot Only    [Toc]    [Back]

		 Assuming the configuration in Example	#1,  efibootmgr  -n  4
		 could	be  called to specify that the Linux entry be taken on
		 next boot.


       Deleting a boot option    [Toc]    [Back]

		 Assuming the configuration in Example #1, efibootmgr -b 4  -B
		 could	be  called  to	delete	entry 4 and remove it from the

BUGS    [Toc]    [Back]

       Please  direct  any  bugs,  features,  patches,	etc.  to  Matt	Domsch

AUTHOR    [Toc]    [Back]

       This  man  page	was generated by dann frazier dannf@debian.org for the
       Debian GNU/Linux operating system, but may be used by others.

SEE ALSO    [Toc]    [Back]


[ Back ]
 Similar pages
Name OS Title
boot0cfg FreeBSD boot manager installation/configuration utility
vxbootsetup HP-UX set up system boot information on a VERITAS Volume Manager disk
vxvmboot HP-UX prepare VERITAS Volume Manager volume as a root, boot, primary swap or dump volume
reboot HP-UX boot the system
rbootd FreeBSD HP remote boot server
nanouptime FreeBSD get the time elapsed since boot
getmicrouptime FreeBSD get the time elapsed since boot
microuptime FreeBSD get the time elapsed since boot
bootparams FreeBSD boot parameter database
rcS Linux defaults used at boot time
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service