git: 9ed58aa60fd9 - main - src.conf.5: Regen after ddcd3b606c9d

The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=9ed58aa60fd9cfcc7b6d9f4efa3a0631da393fc9

commit 9ed58aa60fd9cfcc7b6d9f4efa3a0631da393fc9
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2024-08-06 23:42:52 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-08-06 23:42:52 +0000

    src.conf.5: Regen after ddcd3b606c9d
    
    Sponsored by:           Netflix
---
 share/man/man5/src.conf.5 | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index a12a2a8cb9f4..200ce8211e17 100644
--- a/share/man/man5/src.conf.5
+++ b/share/man/man5/src.conf.5
@@ -1,5 +1,5 @@
 .\" DO NOT EDIT-- this file is @generated by tools/build/options/makeman.
-.Dd July 29, 2024
+.Dd August 6, 2024
 .Dt SRC.CONF 5
 .Os
 .Sh NAME
@@ -158,6 +158,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
@@ -1041,6 +1060,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
@@ -1062,6 +1092,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