src.conf.5: Regen after ddcd3b606c

Sponsored by:		Netflix

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