[Bug 290794] loader.efi is confusing about boot1.efi usage

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 01 Jan 2026 06:17:22 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=290794

Aaditya Singh <aadityavksingh@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |aadityavksingh@gmail.com

--- Comment #1 from Aaditya Singh <aadityavksingh@gmail.com> ---
I made a Github pull request referencing this PR.
[https://github.com/freebsd/freebsd-src/pull/1939]

==============
Current man-page text:-
       On UEFI systems, loader.efi loads the kernel.

       boot1.efi(8)  is used to load loader.efi when it is placed within a UFS
       or ZFS file system.  Alternatively, loader.efi is  used  directly  when
       configured  with  efibootmgr(8), or when placed directly as the default
       boot program as described in uefi(8).  When a  system  is  built  using
       bsdinstall(8), loader.efi will be used directly.


Pull Request:-
     On UEFI systems, loader.efi loads the kernel.

     loader.efi is invoked directly from the EFI System Partition (ESP) on
     systems installed using bsdinstall(8), when installed as the default EFI
     boot program as described in uefi(8) or when configured as an EFI boot
     entry with efibootmgr(8).

     On systems upgraded from FreeBSD 10 or earlier, the EFI System Partition
     (ESP) can be too small to accommodate loader.efi.  In such cases,
     boot1.efi(8) may be retained as the firmware boot program. It will chain-
     load the current /boot/loader.efi, which is updated during the
     installworld process.  boot1.efi(8) is deprecated for new installations.

-- 
You are receiving this mail because:
You are on the CC list for the bug.