update example to make it active when creating a new boot method...
Clean up some of the sentences and grammar... make igor happy..
This commit is contained in:
parent
70d1a4351a
commit
98b765e5c2
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=363462
@ -24,7 +24,7 @@
|
|||||||
.\"
|
.\"
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd September 24, 2019
|
.Dd July 23, 2020
|
||||||
.Dt EFIBOOTMGR 8
|
.Dt EFIBOOTMGR 8
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -66,28 +66,34 @@
|
|||||||
.Nm
|
.Nm
|
||||||
.Fl T
|
.Fl T
|
||||||
.Sh "DESCRIPTION"
|
.Sh "DESCRIPTION"
|
||||||
|
The
|
||||||
.Nm
|
.Nm
|
||||||
manipulates how UEFI Boot Managers boot the system.
|
program manipulates how UEFI Boot Managers boot the system.
|
||||||
Methods of booting can be created and destroyed.
|
It can create and destroy methods for booting along with activating or
|
||||||
Boot methods can be activated or deactivated.
|
deactivating them.
|
||||||
The order of boot methods tried can be changed.
|
It can also change the defined order of boot methods.
|
||||||
Temporary boot methods can override the usual booting methods.
|
It can create a temporary boot (BootNext) variable that references a
|
||||||
|
boot method to be tried once upon the next boot.
|
||||||
.Pp
|
.Pp
|
||||||
The UEFI standard defines how hosts may control what is used to
|
The UEFI standard defines how hosts may control what is used to
|
||||||
bootstrap the system.
|
bootstrap the system.
|
||||||
Each method is encapsulated within a persistent UEFI variable, stored
|
Each method is encapsulated within a persistent UEFI variable, stored
|
||||||
by the UEFI BIOS of the form
|
by the UEFI BIOS of the form
|
||||||
.Cm Boot Ns Em XXXX .
|
.Cm Boot Ns Em XXXX
|
||||||
These variables are numbered, describe where to load the bootstrap
|
(where XXXX are uppercase hexadecimal digits).
|
||||||
program from, and whether or not the method is active.
|
These variables are numbered, each describing where to load the bootstrap
|
||||||
The boot order of these methods is controlled by another variable
|
program from, and whether or not the method is active (used for booting,
|
||||||
|
otherwise the method will be skipped).
|
||||||
|
The order of these methods is controlled by another variable,
|
||||||
.Cm BootOrder .
|
.Cm BootOrder .
|
||||||
The currently booting method is communicated using
|
The currently booted method is communicated using
|
||||||
.Cm BootCurrent .
|
.Cm BootCurrent .
|
||||||
A global timeout can also be set.
|
A global timeout can also be set.
|
||||||
.Pp
|
.Pp
|
||||||
.Nm
|
.Nm
|
||||||
requires that the kernel efirt module be loaded to get and set these
|
requires that the kernel module
|
||||||
|
.Xr efirt 9
|
||||||
|
module be present or loaded to get and set these
|
||||||
non-volatile variables.
|
non-volatile variables.
|
||||||
.Pp
|
.Pp
|
||||||
The following options are available:
|
The following options are available:
|
||||||
@ -113,7 +119,7 @@ boot entry.
|
|||||||
.It Fl c -create
|
.It Fl c -create
|
||||||
Create a new
|
Create a new
|
||||||
.Cm Boot
|
.Cm Boot
|
||||||
variable.
|
variable (aka method or entry).
|
||||||
.It Fl D -dry-run
|
.It Fl D -dry-run
|
||||||
Process but do not change any variables.
|
Process but do not change any variables.
|
||||||
.It Fl E -esp
|
.It Fl E -esp
|
||||||
@ -136,7 +142,7 @@ The path to and name of the kernel.
|
|||||||
.It Fl l -loader Ar loader
|
.It Fl l -loader Ar loader
|
||||||
The path to and name of the loader.
|
The path to and name of the loader.
|
||||||
.It Fl L -label Ar label
|
.It Fl L -label Ar label
|
||||||
An optional description for the entry.
|
An optional description for the method.
|
||||||
.It Fl n -bootnext
|
.It Fl n -bootnext
|
||||||
Set
|
Set
|
||||||
.Ar bootnum
|
.Ar bootnum
|
||||||
@ -169,32 +175,36 @@ To display the current
|
|||||||
.Cm Boot
|
.Cm Boot
|
||||||
related variables in the system:
|
related variables in the system:
|
||||||
.Pp
|
.Pp
|
||||||
.Dl efibootmgr [-v]
|
.Dl efibootmgr -v
|
||||||
.Pp
|
.Pp
|
||||||
This will display the optional
|
This will display the optional
|
||||||
.Cm BootNext
|
.Cm BootNext
|
||||||
bootnum,
|
(if present),
|
||||||
.Cm BootCurrent ,
|
.Cm BootCurrent
|
||||||
or currently booted bootnum, followed by the optional
|
(currently booted method), followed by the optional
|
||||||
.Cm Timeout
|
.Cm Timeout
|
||||||
value, any
|
value, any
|
||||||
.Cm BootOrder
|
.Cm BootOrder
|
||||||
that may be set, followed finally by all currently defined
|
that may be set, followed finally by all currently defined
|
||||||
.Cm Boot
|
.Cm Boot
|
||||||
variables, active or not.
|
variables, active or not.
|
||||||
The verbose flag will augment this output with the disk partition uuids,
|
The verbose flag,
|
||||||
|
.Pq Fl v ,
|
||||||
|
augments this output with the disk partition uuids,
|
||||||
size/offset and device-path of the variable.
|
size/offset and device-path of the variable.
|
||||||
|
The flag will also include any unreferenced (by BootOrder) variables.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
program can be used to create new EFI boot variables.
|
program can be used to create new EFI boot variables.
|
||||||
To create a new boot var pointing to an installation with its EFI partition
|
The following command may be used to create a new boot method, using
|
||||||
mounted under
|
the EFI partition mounted under
|
||||||
.Pa /mnt ,
|
.Pa /mnt ,
|
||||||
the given loader and a label
|
mark the method active, using
|
||||||
|
the given loader and label the method
|
||||||
.Qq FreeBSD-11 :
|
.Qq FreeBSD-11 :
|
||||||
.Pp
|
.Pp
|
||||||
.Dl efibootmgr -c -l /mnt/EFI/freebsd/loader.efi -L FreeBSD-11
|
.Dl efibootmgr -a -c -l /mnt/EFI/freebsd/loader.efi -L FreeBSD-11
|
||||||
.Pp
|
.Pp
|
||||||
This will result in the next available bootnum being assigned to a
|
This will result in the next available bootnum being assigned to a
|
||||||
new UEFI boot variable, and given the label
|
new UEFI boot variable, and given the label
|
||||||
@ -203,8 +213,11 @@ such as:
|
|||||||
.Pp
|
.Pp
|
||||||
.Dl Boot0009 FreeBSD-11
|
.Dl Boot0009 FreeBSD-11
|
||||||
.Pp
|
.Pp
|
||||||
Note newly created boot entries are created inactive.
|
Note newly created boot entries are, by default, created inactive, hence
|
||||||
The active state is denoted by an '*' following the
|
the reason
|
||||||
|
.Fl a
|
||||||
|
flag is specified above so that it will be considered for booting.
|
||||||
|
The active state is denoted by a '*' following the
|
||||||
.Cm Boot Ns Em XXXX
|
.Cm Boot Ns Em XXXX
|
||||||
name in the output.
|
name in the output.
|
||||||
They are also inserted into the first position of current
|
They are also inserted into the first position of current
|
||||||
@ -217,7 +230,7 @@ booting from, else they are ignored.
|
|||||||
.Pp
|
.Pp
|
||||||
Will delete the given boot entry Boot0009.
|
Will delete the given boot entry Boot0009.
|
||||||
.Pp
|
.Pp
|
||||||
To set a given newly created boot entry active use:
|
To set the given boot entry active:
|
||||||
.Pp
|
.Pp
|
||||||
.Dl efibootmgr -a -b 0009
|
.Dl efibootmgr -a -b 0009
|
||||||
.Pp
|
.Pp
|
||||||
@ -233,6 +246,11 @@ for the next reboot use:
|
|||||||
.Pp
|
.Pp
|
||||||
.Dl efibootmgr -o 0009,0003,...
|
.Dl efibootmgr -o 0009,0003,...
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
.Xr efirt 9 ,
|
||||||
.Xr efivar 8 ,
|
.Xr efivar 8 ,
|
||||||
.Xr gpart 8 ,
|
.Xr gpart 8 ,
|
||||||
.Xr uefi 8
|
.Xr uefi 8
|
||||||
|
.Sh STANDARDS
|
||||||
|
The Unified Extensible Firmware Interface Specification is available
|
||||||
|
from
|
||||||
|
.Pa www.uefi.org .
|
||||||
|
Loading…
Reference in New Issue
Block a user