Bug 256087

Summary: man 8 boot1.efi refers to non-existent gptboot.efi(8)
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Open ---    
Severity: Affects Some People CC: doc, felix.the.red
Priority: --- Keywords: easy, needs-patch
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/cgi/man.cgi?query=boot1.efi&sektion=8&manpath=FreeBSD+13.0-current

Description Graham Perrin 2021-05-22 15:15:17 UTC
Amongst the caveats in the manual page for boot1.efi(8): 

> •   There's no support for marking partitions as the preferred one.  See
>     gptboot.efi(8).

% man gptboot.efi
No manual entry for gptboot.efi
% freebsd-version ; uname -KU
14.0-CURRENT
1400013 1400013
%
Comment 1 Graham Perrin 2021-05-22 15:23:59 UTC
% man 8 boot1.efi | tail -n 17
   Caveats
     •   The order in which file systems are tried is undefined.

     •   No encryption support is available.

     •   There's no way to interrupt the boot process to select booting from
         some other location.

     •   When configuring a serial console for FreeBSD, but not for UEFI, no
         output will show up on the serial console from boot1.efi.

     •   There's no support for marking partitions as the preferred one.  See
         gptboot.efi(8).

     •   There's no support for boot-once functionality.  See gptboot.efi(8).

FreeBSD 14.0-CURRENT             April 6, 2021            FreeBSD 14.0-CURRENT
%
Comment 2 Felix Johnson freebsd_triage 2021-10-01 20:41:59 UTC
gptboot.efi(8) lives under stand/efi/gptboot/gptboot.efi.8
I do not know why it is not installed by default.

This needs a makefile patch, not a documentation patch.
Comment 3 Graham Perrin 2021-10-03 00:37:30 UTC
<https://cgit.freebsd.org/src/commit/?id=42cd37dfbd1b2feff8f7aba32d2577e08b058231> was 

> gptboot.efi: Add man page