git: 3cff088ebdac - stable/14 - src.conf.5: Regen after ddcd3b606c9d

From: John Baldwin <jhb_at_FreeBSD.org>
Date: Tue, 27 Aug 2024 18:07:10 UTC
The branch stable/14 has been updated by jhb:

URL: https://cgit.FreeBSD.org/src/commit/?id=3cff088ebdacc1e3b2646e035b3e6edc7aa05cac

commit 3cff088ebdacc1e3b2646e035b3e6edc7aa05cac
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2024-08-06 23:42:52 +0000
Commit:     John Baldwin <jhb@FreeBSD.org>
CommitDate: 2024-08-27 16:33:16 +0000

    src.conf.5: Regen after ddcd3b606c9d
    
    Sponsored by:           Netflix
    
    (cherry picked from commit 9ed58aa60fd9cfcc7b6d9f4efa3a0631da393fc9)
---
 share/man/man5/src.conf.5 | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index 2713ad0c418c..11801456716c 100644
--- a/share/man/man5/src.conf.5
+++ b/share/man/man5/src.conf.5
@@ -154,6 +154,25 @@ This library is currently only used to perform
 signature verification and related operations
 for Verified Exec and
 .Xr loader 8 .
+.Pp
+Due to size constraints in the BIOS environment on x86, one may need to set
+.Va LOADERSIZE
+larger than the
+default 500000, although often loader is under the 500k limit even with
+this option.
+Setting
+.Va LOADERSIZE
+larger than 500000 may cause
+.Xr pxeboot 8
+to be too large to work.
+Careful testing of the loader in the target environment when built with a larger
+limit to establish safe limits is critical because different BIOS environments
+reserve differing amounts of the low 640k space, making a precise limit for
+everybody impossible.
+.Pp
+See also
+.Va WITH_LOADER_PXEBOOT
+for other considerations.
 When set, these options are also in effect:
 .Pp
 .Bl -inset -compact
@@ -1047,6 +1066,17 @@ Build openfirmware bootloader components.
 .Pp
 This is a default setting on
 powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpc64le.
+.It Va WITHOUT_LOADER_PXEBOOT
+Do not build pxeboot on i386/amd64.
+When the pxeboot is too large, or unneeded, it may be disabled with this option.
+See
+.Va WITH_LOADER_PXEBOOT
+for how to adjust the defaults when you need both a larger
+.Pa /boot/loader
+and
+.Pa /boot/pxeboot
+.Pp
+This option only has an effect on x86.
 .It Va WITHOUT_LOADER_UBOOT
 Disable building of ubldr.
 .Pp
@@ -1068,6 +1098,8 @@ with support for verification similar to Verified Exec.
 .Pp
 Depends on
 .Va WITH_BEARSSL .
+May require a larger
+.Va LOADERSIZE .
 When set, these options are also in effect:
 .Pp
 .Bl -inset -compact