DragonFly On-Line Manual Pages

Search: Section:  


EFIBOOTMGR(8)          DragonFly System Manager's Manual         EFIBOOTMGR(8)

NAME

efibootmgr - manipulate the EFI Boot Manager

SYNOPSIS

efibootmgr [-v] efibootmgr -a -b bootnum efibootmgr -A -b bootnum efibootmgr -B -b bootnum efibootmgr -c -l loader [-aD] [-b bootnum] [-k kernel] [-L label] [-e env] efibootmgr -E [-d] [-p] efibootmgr -n -b bootnum efibootmgr -N efibootmgr -o bootorder efibootmgr -t timeout efibootmgr -T

DESCRIPTION

efibootmgr manipulates how UEFI Boot Managers boot the system. Methods of booting can be created and destroyed. Boot methods can be activated or deactivated. The order of boot methods tried can be changed. Temporary boot methods can override the usual booting methods. The UEFI standard defines how hosts may control what is used to bootstrap the system. Each method is encapsulated within a persistent UEFI variable, stored by the UEFI BIOS of the form BootXXXX. These variables are numbered, describe where to load the bootstrap program from, and whether or not the method is active. The boot order of these methods is controlled by another variable BootOrder. The currently booting method is communicated using BootCurrent. A global timeout can also be set. efibootmgr requires that the kernel efirt module be loaded to get and set these non-volatile variables. The following options are available: -a, --activate Activate the given bootnum boot entry, or the new entry when used with -c. -A, --deactivate Deactivate the given bootnum boot entry. -b bootnum, --bootnum bootnum When creating or modifying an entry, use bootnum as the index. When creating a new entry, fail if it already exists. -B, --delete Delete the given bootnum boot entry. -c, --create Create a new Boot variable. -D, --dry-run Process but do not change any variables. -E, --esp Print the DragonFly path to the ESP device, derived from the EFI variables BootCurrent and BootXXXX. This is the ESP partition used by UEFI to boot the current instance of the system. If -d --device-path is specified, the UEFI device path to the ESP is reported instead. If -p --unix-path is specified, the mount point of the ESP is reported instead. -k kernel, --kernel kernel The path to and name of the kernel. -l loader, --loader loader The path to and name of the loader. -L label, --label label An optional description for the entry. -n, --bootnext Set bootnum boot entry as the BootNext variable. -N, --delete-bootnext Delete the BootNext optional variable. -o bootorder, --bootorder bootorder Set BootOrder variable to the given comma delimited set of bootnums. The numbers are in hex to match BootXXXX, but may omit leading zeros. -t timeout, --set-timeout timeout Set the bootmenu timeout value. -T, --del-timeout Delete the BootTimeout variable. -v, --verbose Display the device path of boot entries in the output.

EXAMPLES

To display the current Boot related variables in the system: efibootmgr [-v] This will display the optional BootNext bootnum, BootCurrent, or currently booted bootnum, followed by the optional Timeout value, any BootOrder that may be set, followed finally by all currently defined Boot variables, active or not. The verbose flag will augment this output with the disk partition uuids, size/offset and device-path of the variable. The efibootmgr program can be used to create new EFI boot variables. To create a new boot var pointing to an installation with its EFI partition mounted under /mnt, the given loader and a label "FreeBSD-11": efibootmgr -c -l /mnt/EFI/freebsd/loader.efi -L FreeBSD-11 This will result in the next available bootnum being assigned to a new UEFI boot variable, and given the label "FreeBSD-11" such as: Boot0009 FreeBSD-11 Note newly created boot entries are created inactive. The active state is denoted by an '*' following the BootXXXX name in the output. They are also inserted into the first position of current BootOrder variable if it exists. They must first be set to active before being considered available to attempt booting from, else they are ignored. efibootmgr -B -b 0009 Will delete the given boot entry Boot0009. To set a given newly created boot entry active use: efibootmgr -a -b 0009 To set a given boot entry to be used as the BootNext variable, irrespective of its active state, use: efibootmgr -n -b 0009 To set the BootOrder for the next reboot use: efibootmgr -o 0009,0003,...

SEE ALSO

efivar(8), uefi(8) DragonFly 5.9-DEVELOPMENT June 13, 2020 DragonFly 5.9-DEVELOPMENT

Search: Section: