kgess-mirror/freebsd-src
1
0
Fork 0
mirror of https://git.freebsd.org/src.git synced 2026-01-11 19:57:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

loader.efi(8): clarify UEFI boot path and boot1.efi usage

Browse source 
Reorganise and clarify the legacy role of boot1.efi in DESCRIPTION to
improve clarity.

Add a minor missing word in the BUGS section ["...caution is required*..."].

See also - PR: 290794

Signed-off-by: Aaditya Singh <aadityavksingh@gmail.com>
Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/1939
This commit is contained in:
kitkat1424 2026-01-01 01:11:08 +05:30 • committed by Warner Losh
parent 54ce6b2c4c
commit 7b3fb3caef
1 changed files with 22 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
stand/man/loader.efi.8
View file

@ -41,20 +41,28 @@ On UEFI systems,
.Nm
loads the kernel.
.Pp
.Xr boot1.efi 8
is used to load
.Nm
when it is placed within a UFS or ZFS file system.
Alternatively,
.Nm
is used directly when configured with
.Xr efibootmgr 8 ,
or when placed directly as the default boot program as described in
.Xr uefi 8 .
When a system is built using
is invoked directly from the EFI System Partition (ESP)
on systems installed using
.Xr bsdinstall 8 ,
.Nm
will be used directly.
when installed as the default EFI boot program as described in
.Xr uefi 8
or when configured as an EFI boot entry with
.Xr efibootmgr 8 .
.Pp
On systems upgraded from FreeBSD 10 or earlier, the EFI System Partition (ESP)
can be too small to accommodate
.Nm .
In such cases,
.Xr boot1.efi 8
may be retained as the firmware boot program. It
will chain-load the current
.Pa /boot/loader.efi ,
which is updated during the
.Cm installworld
process.
.Xr boot1.efi 8
is deprecated for new installations.
.Ss Console Considerations
The EFI BIOS provides a generic console.
In
@ -485,15 +493,6 @@ Typically in these embedded situations, there is only one .efi file (loader.efi
or a copy of loader.efi).
The path to this file is typically the default removable path above.
.Pp
Managing booting multiple OSes on UEFI varies greatly, so extra caution when
updating the UEFI default loader.
Managing booting multiple OSes on UEFI varies greatly, so extra caution is required
when updating the UEFI default loader.
.Pp
The old, now obsolete, boot1.efi was installed as bootx64.efi in
.Fx 10
and earlier.
Since it was quite limited in functionality, we created very small
ESPs by default.
A modern loader.efi will not fit.
However, if the old boot1.efi still works, there's no need to update
it since it will chain boot /boot/loader.efi from a copy that
make installworld updates.