Bug 256087 - man 8 boot1.efi refers to non-existent gptboot.efi(8)
Summary: man 8 boot1.efi refers to non-existent gptboot.efi(8)
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Warner Losh
URL: https://www.freebsd.org/cgi/man.cgi?q...
Keywords: easy, needs-patch
Depends on:
Blocks:
 
Reported: 2021-05-22 15:15 UTC by Graham Perrin
Modified: 2024-04-30 15:17 UTC (History)
4 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 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 freebsd_committer freebsd_triage 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 freebsd_committer freebsd_triage 2021-10-03 00:37:30 UTC 
<https://cgit.freebsd.org/src/commit/?id=42cd37dfbd1b2feff8f7aba32d2577e08b058231> was 

> gptboot.efi: Add man page
Comment 4 Chris Davidson 2024-04-30 03:08:03 UTC 
I think this bug should be closed, i am able to confirm that man 8 gptboot.efi does exist as per the patch in it.
Comment 5 Mitchell Horne freebsd_committer freebsd_triage 2024-04-30 15:17:05 UTC 
Yep, fixed recently: https://cgit.freebsd.org/src/commit/stand/efi/gptboot?id=cfcf475a669738382ac75ea50eb03a20280f7662

Closing.