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: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
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: 2021-10-03 00:37 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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