git: c581962414ed - main - src.conf.5: Add some WITH_/WITHOUT_ option descriptions

The branch main has been updated by emaste:

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

commit c581962414edfc26796319ccc988647b08b03ce1
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2023-03-07 18:49:23 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2023-03-08 23:30:45 +0000

    src.conf.5: Add some WITH_/WITHOUT_ option descriptions
    
    Reviewed by:    markj, brooks
    Sponsored by:   The FreeBSD Foundation
    Differential Revision: https://reviews.freebsd.org/D38961
---
 share/man/man5/src.conf.5                | 26 ++++++++++++++++++++++++++
 tools/build/options/WITHOUT_SCTP_SUPPORT |  4 ++++
 tools/build/options/WITH_LIB32           |  3 +++
 tools/build/options/WITH_OFED            |  3 +++
 tools/build/options/WITH_ZFS             |  3 +++
 5 files changed, 39 insertions(+)

diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index d298f38ff0b5..52b80513467e 100644
--- a/share/man/man5/src.conf.5
+++ b/share/man/man5/src.conf.5
@@ -866,6 +866,13 @@ runtime linker.
 .Pp
 This is a default setting on
 arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64le, riscv/riscv64 and riscv/riscv64sf.
+.It Va WITH_LIB32
+On 64-bit platforms, build the 32-bit library set and a
+.Nm ld-elf32.so.1
+runtime linker.
+.Pp
+This is a default setting on
+amd64/amd64 and powerpc/powerpc64.
 .It Va WITHOUT_LLD
 Do not build LLVM's lld linker.
 .It Va WITHOUT_LLDB
@@ -1266,6 +1273,13 @@ When set, it enforces these options:
 .It
 .Va WITHOUT_OFED_EXTRA
 .El
+.It Va WITH_OFED
+Build the
+.Dq "OpenFabrics Enterprise Distribution"
+InfiniBand software stack, including kernel modules and userspace libraries.
+.Pp
+This is a default setting on
+amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpc64le, riscv/riscv64 and riscv/riscv64sf.
 .It Va WITH_OFED_EXTRA
 Build the non-essential components of the
 .Dq "OpenFabrics Enterprise Distribution"
@@ -1435,6 +1449,11 @@ utility.
 Build
 .Xr rpcbind 8
 with warmstart support.
+.It Va WITHOUT_SCTP_SUPPORT
+Disable support in the kernel for the
+.Xr sctp 4
+Stream Control Transmission Protocol
+loadable kernel module.
 .It Va WITHOUT_SENDMAIL
 Do not build
 .Xr sendmail 8
@@ -1743,6 +1762,13 @@ ZFS-specific functionality.
 .Pp
 This is a default setting on
 powerpc/powerpc.
+.It Va WITH_ZFS
+Build the ZFS file system kernel module, libraries, and user commands.
+Also enable ZFS support in utilities and libraries which implement
+ZFS-specific functionality.
+.Pp
+This is a default setting on
+amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc64, powerpc/powerpc64le, riscv/riscv64 and riscv/riscv64sf.
 .It Va WITHOUT_ZONEINFO
 Do not build the timezone database.
 When set, it enforces these options:
diff --git a/tools/build/options/WITHOUT_SCTP_SUPPORT b/tools/build/options/WITHOUT_SCTP_SUPPORT
new file mode 100644
index 000000000000..0829dbeca49d
--- /dev/null
+++ b/tools/build/options/WITHOUT_SCTP_SUPPORT
@@ -0,0 +1,4 @@
+Disable support in the kernel for the
+.Xr sctp 4
+Stream Control Transmission Protocol
+loadable kernel module.
diff --git a/tools/build/options/WITH_LIB32 b/tools/build/options/WITH_LIB32
new file mode 100644
index 000000000000..3c621483a60d
--- /dev/null
+++ b/tools/build/options/WITH_LIB32
@@ -0,0 +1,3 @@
+On 64-bit platforms, build the 32-bit library set and a
+.Nm ld-elf32.so.1
+runtime linker.
diff --git a/tools/build/options/WITH_OFED b/tools/build/options/WITH_OFED
new file mode 100644
index 000000000000..5c978418f001
--- /dev/null
+++ b/tools/build/options/WITH_OFED
@@ -0,0 +1,3 @@
+Build the
+.Dq "OpenFabrics Enterprise Distribution"
+InfiniBand software stack, including kernel modules and userspace libraries.
diff --git a/tools/build/options/WITH_ZFS b/tools/build/options/WITH_ZFS
new file mode 100644
index 000000000000..4b1aea6df534
--- /dev/null
+++ b/tools/build/options/WITH_ZFS
@@ -0,0 +1,3 @@
+Build the ZFS file system kernel module, libraries, and user commands.
+Also enable ZFS support in utilities and libraries which implement
+ZFS-specific functionality.