xref: /freebsd/share/man/man5/src.conf.5 (revision 9e5787d2284e187abb5b654d924394a65772e004)
1.\" DO NOT EDIT-- this file is @generated by tools/build/options/makeman.
2.\" $FreeBSD$
3.Dd July 6, 2020
4.Dt SRC.CONF 5
5.Os
6.Sh NAME
7.Nm src.conf
8.Nd "source build options"
9.Sh DESCRIPTION
10The
11.Nm
12file contains settings that will apply to every build involving the
13.Fx
14source tree; see
15.Xr build 7 .
16.Pp
17The
18.Nm
19file uses the standard makefile syntax.
20However,
21.Nm
22should not specify any dependencies to
23.Xr make 1 .
24Instead,
25.Nm
26is to set
27.Xr make 1
28variables that control the aspects of how the system builds.
29.Pp
30The default location of
31.Nm
32is
33.Pa /etc/src.conf ,
34though an alternative location can be specified in the
35.Xr make 1
36variable
37.Va SRCCONF .
38Overriding the location of
39.Nm
40may be necessary if the system-wide settings are not suitable
41for a particular build.
42For instance, setting
43.Va SRCCONF
44to
45.Pa /dev/null
46effectively resets all build controls to their defaults.
47.Pp
48The only purpose of
49.Nm
50is to control the compilation of the
51.Fx
52source code, which is usually located in
53.Pa /usr/src .
54As a rule, the system administrator creates
55.Nm
56when the values of certain control variables need to be changed
57from their defaults.
58.Pp
59In addition, control variables can be specified
60for a particular build via the
61.Fl D
62option of
63.Xr make 1
64or in its environment; see
65.Xr environ 7 .
66.Pp
67The environment of
68.Xr make 1
69for the build can be controlled via the
70.Va SRC_ENV_CONF
71variable, which defaults to
72.Pa /etc/src-env.conf .
73Some examples that may only be set in this file are
74.Va WITH_DIRDEPS_BUILD ,
75and
76.Va WITH_META_MODE ,
77and
78.Va MAKEOBJDIRPREFIX
79as they are environment-only variables.
80.Pp
81The values of variables are ignored regardless of their setting;
82even if they would be set to
83.Dq Li FALSE
84or
85.Dq Li NO .
86The presence of an option causes
87it to be honored by
88.Xr make 1 .
89.Pp
90This list provides a name and short description for variables
91that can be used for source builds.
92.Bl -tag -width indent
93.It Va WITHOUT_ACCT
94Set to not build process accounting tools such as
95.Xr accton 8
96and
97.Xr sa 8 .
98.It Va WITHOUT_ACPI
99Set to not build
100.Xr acpiconf 8 ,
101.Xr acpidump 8
102and related programs.
103.It Va WITHOUT_APM
104Set to not build
105.Xr apm 8 ,
106.Xr apmd 8
107and related programs.
108.It Va WITHOUT_ASSERT_DEBUG
109Set to compile programs and libraries without the
110.Xr assert 3
111checks.
112.It Va WITHOUT_AT
113Set to not build
114.Xr at 1
115and related utilities.
116.It Va WITHOUT_ATM
117Set to not build
118programs and libraries related to ATM networking.
119.It Va WITHOUT_AUDIT
120Set to not build audit support into system programs.
121.It Va WITHOUT_AUTHPF
122Set to not build
123.Xr authpf 8 .
124.It Va WITHOUT_AUTOFS
125Set to not build
126.Xr autofs 5
127related programs, libraries, and kernel modules.
128.It Va WITHOUT_AUTO_OBJ
129Disable automatic creation of objdirs.
130This is enabled by default if the wanted OBJDIR is writable by the current user.
131.Pp
132This must be set in the environment, make command line, or
133.Pa /etc/src-env.conf ,
134not
135.Pa /etc/src.conf .
136.It Va WITH_BEARSSL
137Build the BearSSL library.
138.Pp
139BearSSL is a tiny SSL library suitable for embedded environments.
140For details see
141.Lk http://www.BearSSL.org/
142.Pp
143This library is currently only used to perform
144signature verification and related operations
145for Verified Exec and
146.Xr loader 8 .
147When set, these options are also in effect:
148.Pp
149.Bl -inset -compact
150.It Va WITH_LOADER_EFI_SECUREBOOT
151(unless
152.Va WITHOUT_LOADER_EFI_SECUREBOOT
153is set explicitly)
154.It Va WITH_LOADER_VERIEXEC
155(unless
156.Va WITHOUT_LOADER_VERIEXEC
157is set explicitly)
158.It Va WITH_LOADER_VERIEXEC_VECTX
159(unless
160.Va WITHOUT_LOADER_VERIEXEC_VECTX
161is set explicitly)
162.It Va WITH_VERIEXEC
163(unless
164.Va WITHOUT_VERIEXEC
165is set explicitly)
166.El
167.It Va WITHOUT_BHYVE
168Set to not build or install
169.Xr bhyve 8 ,
170associated utilities, and examples.
171.Pp
172This option only affects amd64/amd64.
173.It Va WITH_BHYVE_SNAPSHOT
174Set to include support for save and restore (snapshots) in
175.Xr bhyve 8
176and
177.Xr bhyvectl 8 .
178.Pp
179This option only affects amd64/amd64.
180.It Va WITH_BIND_NOW
181Build all binaries with the
182.Dv DF_BIND_NOW
183flag set to indicate that the run-time loader should perform all relocation
184processing at process startup rather than on demand.
185.It Va WITHOUT_BLACKLIST
186Set this if you do not want to build
187.Xr blacklistd 8
188and
189.Xr blacklistctl 8 .
190When set, these options are also in effect:
191.Pp
192.Bl -inset -compact
193.It Va WITHOUT_BLACKLIST_SUPPORT
194(unless
195.Va WITH_BLACKLIST_SUPPORT
196is set explicitly)
197.El
198.It Va WITHOUT_BLACKLIST_SUPPORT
199Set to build some programs without
200.Xr libblacklist 3
201support, like
202.Xr fingerd 8 ,
203.Xr ftpd 8 ,
204and
205.Xr sshd 8 .
206.It Va WITHOUT_BLUETOOTH
207Set to not build Bluetooth related kernel modules, programs and libraries.
208.It Va WITHOUT_BOOT
209Set to not build the boot blocks and loader.
210.It Va WITHOUT_BOOTPARAMD
211Set to not build or install
212.Xr bootparamd 8 .
213.It Va WITHOUT_BOOTPD
214Set to not build or install
215.Xr bootpd 8 .
216.It Va WITHOUT_BSDINSTALL
217Set to not build
218.Xr bsdinstall 8 ,
219.Xr sade 8 ,
220and related programs.
221.It Va WITHOUT_BSD_CPIO
222Set to not build the BSD licensed version of cpio based on
223.Xr libarchive 3 .
224.It Va WITH_BSD_GREP
225Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
226.It Va WITHOUT_BSNMP
227Set to not build or install
228.Xr bsnmpd 1
229and related libraries and data files.
230.It Va WITHOUT_BZIP2
231Set to not build contributed bzip2 software as a part of the base system.
232.Bf -symbolic
233The option has no effect yet.
234.Ef
235When set, these options are also in effect:
236.Pp
237.Bl -inset -compact
238.It Va WITHOUT_BZIP2_SUPPORT
239(unless
240.Va WITH_BZIP2_SUPPORT
241is set explicitly)
242.El
243.It Va WITHOUT_BZIP2_SUPPORT
244Set to build some programs without optional bzip2 support.
245.It Va WITHOUT_CALENDAR
246Set to not build
247.Xr calendar 1 .
248.It Va WITHOUT_CAPSICUM
249Set to not build Capsicum support into system programs.
250When set, it enforces these options:
251.Pp
252.Bl -item -compact
253.It
254.Va WITHOUT_CASPER
255.El
256.It Va WITHOUT_CAROOT
257Set to not add the trusted certificates from the Mozilla NSS bundle to
258base.
259.It Va WITHOUT_CASPER
260Set to not build Casper program and related libraries.
261.It Va WITH_CCACHE_BUILD
262Set to use
263.Xr ccache 1
264for the build.
265No configuration is required except to install the
266.Sy devel/ccache
267package.
268When using with
269.Xr distcc 1 ,
270set
271.Sy CCACHE_PREFIX=/usr/local/bin/distcc .
272The default cache directory of
273.Pa $HOME/.ccache
274will be used, which can be overridden by setting
275.Sy CCACHE_DIR .
276The
277.Sy CCACHE_COMPILERCHECK
278option defaults to
279.Sy content
280when using the in-tree bootstrap compiler,
281and
282.Sy mtime
283when using an external compiler.
284The
285.Sy CCACHE_CPP2
286option is used for Clang but not GCC.
287.Pp
288Sharing a cache between multiple work directories requires using a layout
289similar to
290.Pa /some/prefix/src
291.Pa /some/prefix/obj
292and an environment such as:
293.Bd -literal -offset indent
294CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
295.Ed
296.Pp
297See
298.Xr ccache 1
299for more configuration options.
300.It Va WITHOUT_CCD
301Set to not build
302.Xr geom_ccd 4
303and related utilities.
304.It Va WITHOUT_CDDL
305Set to not build code licensed under Sun's CDDL.
306When set, it enforces these options:
307.Pp
308.Bl -item -compact
309.It
310.Va WITHOUT_CTF
311.It
312.Va WITHOUT_LOADER_ZFS
313.It
314.Va WITHOUT_ZFS
315.El
316.It Va WITHOUT_CLANG
317Set to not build the Clang C/C++ compiler during the regular phase of the build.
318When set, it enforces these options:
319.Pp
320.Bl -item -compact
321.It
322.Va WITHOUT_CLANG_EXTRAS
323.It
324.Va WITHOUT_CLANG_FORMAT
325.It
326.Va WITHOUT_CLANG_FULL
327.It
328.Va WITHOUT_LLVM_COV
329.El
330.It Va WITHOUT_CLANG_BOOTSTRAP
331Set to not build the Clang C/C++ compiler during the bootstrap phase of
332the build.
333To be able to build the system, either gcc or clang bootstrap must be
334enabled unless an alternate compiler is provided via XCC.
335.It Va WITH_CLANG_EXTRAS
336Set to build additional clang and llvm tools, such as bugpoint and
337clang-format.
338.It Va WITH_CLANG_FORMAT
339Set to build clang-format.
340.It Va WITHOUT_CLANG_FULL
341Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer components of
342the Clang C/C++ compiler.
343.It Va WITHOUT_CLANG_IS_CC
344Do not install links to the Clang C/C++ compiler as
345.Pa /usr/bin/cc ,
346.Pa /usr/bin/c++
347and
348.Pa /usr/bin/cpp .
349.It Va WITHOUT_CPP
350Set to not build
351.Xr cpp 1 .
352.It Va WITHOUT_CROSS_COMPILER
353Set to not build any cross compiler in the cross-tools stage of buildworld.
354When compiling a different version of
355.Fx
356than what is installed on the system, provide an alternate
357compiler with XCC to ensure success.
358When compiling with an identical version of
359.Fx
360to the host, this option may be safely used.
361This option may also be safe when the host version of
362.Fx
363is close to the sources being built, but all bets are off if there have
364been any changes to the toolchain between the versions.
365When set, it enforces these options:
366.Pp
367.Bl -item -compact
368.It
369.Va WITHOUT_CLANG_BOOTSTRAP
370.It
371.Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
372.It
373.Va WITHOUT_LLD_BOOTSTRAP
374.El
375.It Va WITHOUT_CRYPT
376Set to not build any crypto code.
377When set, it enforces these options:
378.Pp
379.Bl -item -compact
380.It
381.Va WITHOUT_DMAGENT
382.It
383.Va WITHOUT_KERBEROS
384.It
385.Va WITHOUT_KERBEROS_SUPPORT
386.It
387.Va WITHOUT_LDNS
388.It
389.Va WITHOUT_LDNS_UTILS
390.It
391.Va WITHOUT_OPENSSH
392.It
393.Va WITHOUT_OPENSSL
394.It
395.Va WITHOUT_PKGBOOTSTRAP
396.It
397.Va WITHOUT_SVN
398.It
399.Va WITHOUT_SVNLITE
400.It
401.Va WITHOUT_UNBOUND
402.It
403.Va WITHOUT_WIRELESS
404.El
405.Pp
406When set, these options are also in effect:
407.Pp
408.Bl -inset -compact
409.It Va WITHOUT_GSSAPI
410(unless
411.Va WITH_GSSAPI
412is set explicitly)
413.El
414.It Va WITH_CTF
415Set to compile with CTF (Compact C Type Format) data.
416CTF data encapsulates a reduced form of debugging information
417similar to DWARF and the venerable stabs and is required for DTrace.
418.It Va WITHOUT_CUSE
419Set to not build CUSE-related programs and libraries.
420.It Va WITHOUT_CXGBETOOL
421Set to not build
422.Xr cxgbetool 8
423.Pp
424This is a default setting on
425arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
426.It Va WITH_CXGBETOOL
427Set to build
428.Xr cxgbetool 8
429.Pp
430This is a default setting on
431amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
432.It Va WITHOUT_CXX
433Set to not build
434.Xr c++ 1
435and related libraries.
436It will also prevent building of
437.Xr gperf 1
438and
439.Xr devd 8 .
440When set, it enforces these options:
441.Pp
442.Bl -item -compact
443.It
444.Va WITHOUT_CLANG
445.It
446.Va WITHOUT_CLANG_EXTRAS
447.It
448.Va WITHOUT_CLANG_FORMAT
449.It
450.Va WITHOUT_CLANG_FULL
451.It
452.Va WITHOUT_DTRACE_TESTS
453.It
454.Va WITHOUT_GOOGLETEST
455.It
456.Va WITHOUT_LLVM_COV
457.It
458.Va WITHOUT_TESTS
459.El
460.It Va WITHOUT_DEBUG_FILES
461Set to avoid building or installing standalone debug files for each
462executable binary and shared library.
463.It Va WITHOUT_DIALOG
464Set to not build
465.Xr dialog 1 ,
466.Xr dialog 3 ,
467.Xr dpv 1 ,
468and
469.Xr dpv 3 .
470When set, it enforces these options:
471.Pp
472.Bl -item -compact
473.It
474.Va WITHOUT_BSDINSTALL
475.El
476.It Va WITHOUT_DICT
477Set to not build the Webster dictionary files.
478.It Va WITH_DIRDEPS_BUILD
479This is an experimental build system.
480For details see
481http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
482Build commands can be seen from the top-level with:
483.Dl make show-valid-targets
484The build is driven by dirdeps.mk using
485.Va DIRDEPS
486stored in
487Makefile.depend files found in each directory.
488.Pp
489The build can be started from anywhere, and behaves the same.
490The initial instance of
491.Xr make 1
492recursively reads
493.Va DIRDEPS
494from
495.Pa Makefile.depend ,
496computing a graph of tree dependencies from the current origin.
497Setting
498.Va NO_DIRDEPS
499skips checking dirdep dependencies and will only build in the current
500and child directories.
501.Va NO_DIRDEPS_BELOW
502skips building any dirdeps and only build the current directory.
503.Pp
504This also utilizes the
505.Va WITH_META_MODE
506logic for incremental builds.
507.Pp
508The build hides commands executed unless
509.Va NO_SILENT
510is defined.
511.Pp
512Note that there is currently no mass install feature for this.
513.Pp
514When set, it enforces these options:
515.Pp
516.Bl -item -compact
517.It
518.Va WITH_INSTALL_AS_USER
519.El
520.Pp
521When set, these options are also in effect:
522.Pp
523.Bl -inset -compact
524.It Va WITH_META_MODE
525(unless
526.Va WITHOUT_META_MODE
527is set explicitly)
528.It Va WITH_STAGING
529(unless
530.Va WITHOUT_STAGING
531is set explicitly)
532.It Va WITH_STAGING_MAN
533(unless
534.Va WITHOUT_STAGING_MAN
535is set explicitly)
536.It Va WITH_STAGING_PROG
537(unless
538.Va WITHOUT_STAGING_PROG
539is set explicitly)
540.It Va WITH_SYSROOT
541(unless
542.Va WITHOUT_SYSROOT
543is set explicitly)
544.El
545.Pp
546This must be set in the environment, make command line, or
547.Pa /etc/src-env.conf ,
548not
549.Pa /etc/src.conf .
550.It Va WITH_DIRDEPS_CACHE
551Cache result of dirdeps.mk which can save significant time
552for subsequent builds.
553Depends on
554.Va WITH_DIRDEPS_BUILD .
555.Pp
556This must be set in the environment, make command line, or
557.Pa /etc/src-env.conf ,
558not
559.Pa /etc/src.conf .
560.It Va WITHOUT_DMAGENT
561Set to not build dma Mail Transport Agent.
562.It Va WITHOUT_DOCCOMPRESS
563Set to not install compressed system documentation.
564Only the uncompressed version will be installed.
565.It Va WITH_DTRACE_TESTS
566Set to build and install the DTrace test suite in
567.Pa /usr/tests/cddl/usr.sbin/dtrace .
568This test suite is considered experimental on architectures other than
569amd64/amd64 and running it may cause system instability.
570.It Va WITHOUT_DYNAMICROOT
571Set this if you do not want to link
572.Pa /bin
573and
574.Pa /sbin
575dynamically.
576.It Va WITHOUT_EE
577Set to not build and install
578.Xr edit 1 ,
579.Xr ee 1 ,
580and related programs.
581.It Va WITHOUT_EFI
582Set not to build
583.Xr efivar 3
584and
585.Xr efivar 8 .
586.Pp
587This is a default setting on
588mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
589.It Va WITH_EFI
590Set to build
591.Xr efivar 3
592and
593.Xr efivar 8 .
594.Pp
595This is a default setting on
596amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
597.It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
598Set to not build ELF Tool Chain tools
599(addr2line, nm, size, strings and strip)
600as part of the bootstrap process.
601.Bf -symbolic
602An alternate bootstrap tool chain must be provided.
603.Ef
604.It Va WITHOUT_EXAMPLES
605Set to avoid installing examples to
606.Pa /usr/share/examples/ .
607.It Va WITH_EXPERIMENTAL
608Set to include experimental features in the build.
609.It Va WITH_EXTRA_TCP_STACKS
610Set to build extra TCP stack modules.
611.It Va WITHOUT_FDT
612Set to not build Flattened Device Tree support as part of the base system.
613This includes the device tree compiler (dtc) and libfdt support library.
614.It Va WITHOUT_FILE
615Set to not build
616.Xr file 1
617and related programs.
618When set, it enforces these options:
619.Pp
620.Bl -item -compact
621.It
622.Va WITHOUT_SVNLITE
623.El
624.It Va WITHOUT_FINGER
625Set to not build or install
626.Xr finger 1
627and
628.Xr fingerd 8 .
629.It Va WITHOUT_FLOPPY
630Set to not build or install programs
631for operating floppy disk driver.
632.It Va WITHOUT_FMTREE
633Set to not build and install
634.Pa /usr/sbin/fmtree .
635.It Va WITHOUT_FORMAT_EXTENSIONS
636Set to not enable
637.Fl fformat-extensions
638when compiling the kernel.
639Also disables all format checking.
640.It Va WITHOUT_FORTH
641Set to build bootloaders without Forth support.
642.It Va WITHOUT_FP_LIBC
643Set to build
644.Nm libc
645without floating-point support.
646.It Va WITHOUT_FREEBSD_UPDATE
647Set to not build
648.Xr freebsd-update 8 .
649.It Va WITHOUT_FTP
650Set to not build or install
651.Xr ftp 1
652and
653.Xr ftpd 8 .
654.It Va WITHOUT_GAMES
655Set to not build games.
656.It Va WITHOUT_GDB
657Set to not build
658.Xr gdb 1 .
659.Pp
660This is a default setting on
661arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
662.It Va WITH_GDB
663Set to build
664.Xr gdb 1 .
665.Pp
666This is a default setting on
667amd64/amd64, arm/armv6, arm/armv7, i386/i386, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
668.It Va WITHOUT_GNU_DIFF
669Set to not build GNU
670.Xr diff3 1 .
671.It Va WITHOUT_GNU_GREP
672Set to not build GNU
673.Xr grep 1 .
674.It Va WITH_GNU_GREP_COMPAT
675Set this option to include GNU extensions in
676.Xr bsdgrep 1
677by linking against libgnuregex.
678.It Va WITHOUT_GOOGLETEST
679Set to neither build nor install
680.Lb libgmock ,
681.Lb libgtest ,
682and dependent tests.
683.Pp
684This is a default setting on
685mips/mips and mips/mips64.
686.It Va WITH_GOOGLETEST
687Set to build and install
688.Lb libgmock ,
689.Lb libgtest ,
690and dependent tests.
691.Pp
692This is a default setting on
693amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
694.It Va WITHOUT_GPIO
695Set to not build
696.Xr gpioctl 8
697as part of the base system.
698.It Va WITHOUT_GSSAPI
699Set to not build libgssapi.
700.It Va WITHOUT_HAST
701Set to not build
702.Xr hastd 8
703and related utilities.
704.It Va WITH_HESIOD
705Set to build Hesiod support.
706.It Va WITHOUT_HTML
707Set to not build HTML docs.
708.It Va WITHOUT_HYPERV
709Set to not build or install HyperV utilities.
710.Pp
711This is a default setting on
712arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
713.It Va WITH_HYPERV
714Set to build or install HyperV utilities.
715.Pp
716This is a default setting on
717amd64/amd64 and i386/i386.
718.It Va WITHOUT_ICONV
719Set to not build iconv as part of libc.
720.It Va WITHOUT_INCLUDES
721Set to not install header files.
722This option used to be spelled
723.Va NO_INCS .
724.Bf -symbolic
725The option does not work for build targets.
726.Ef
727.It Va WITHOUT_INET
728Set to not build programs and libraries related to IPv4 networking.
729When set, it enforces these options:
730.Pp
731.Bl -item -compact
732.It
733.Va WITHOUT_INET_SUPPORT
734.El
735.It Va WITHOUT_INET6
736Set to not build
737programs and libraries related to IPv6 networking.
738When set, it enforces these options:
739.Pp
740.Bl -item -compact
741.It
742.Va WITHOUT_INET6_SUPPORT
743.El
744.It Va WITHOUT_INET6_SUPPORT
745Set to build libraries, programs, and kernel modules without IPv6 support.
746.It Va WITHOUT_INETD
747Set to not build
748.Xr inetd 8 .
749.It Va WITHOUT_INET_SUPPORT
750Set to build libraries, programs, and kernel modules without IPv4 support.
751.It Va WITHOUT_INSTALLLIB
752Set this to not install optional libraries.
753For example, when creating a
754.Xr nanobsd 8
755image.
756.Bf -symbolic
757The option does not work for build targets.
758.Ef
759.It Va WITH_INSTALL_AS_USER
760Set to make install targets succeed for non-root users by installing
761files with owner and group attributes set to that of the user running
762the
763.Xr make 1
764command.
765The user still must set the
766.Va DESTDIR
767variable to point to a directory where the user has write permissions.
768.It Va WITHOUT_IPFILTER
769Set to not build IP Filter package.
770.It Va WITHOUT_IPFW
771Set to not build IPFW tools.
772.It Va WITHOUT_IPSEC_SUPPORT
773Set to not build the kernel with
774.Xr ipsec 4
775support.
776This option is needed for
777.Xr ipsec 4
778and
779.Xr tcpmd5 4 .
780.It Va WITHOUT_ISCSI
781Set to not build
782.Xr iscsid 8
783and related utilities.
784.It Va WITHOUT_JAIL
785Set to not build tools for the support of jails; e.g.,
786.Xr jail 8 .
787.It Va WITHOUT_KDUMP
788Set to not build
789.Xr kdump 1
790and
791.Xr truss 1 .
792.It Va WITHOUT_KERBEROS
793Set this to not build Kerberos 5 (KTH Heimdal).
794When set, these options are also in effect:
795.Pp
796.Bl -inset -compact
797.It Va WITHOUT_GSSAPI
798(unless
799.Va WITH_GSSAPI
800is set explicitly)
801.It Va WITHOUT_KERBEROS_SUPPORT
802(unless
803.Va WITH_KERBEROS_SUPPORT
804is set explicitly)
805.El
806.It Va WITHOUT_KERBEROS_SUPPORT
807Set to build some programs without Kerberos support, like
808.Xr ssh 1 ,
809.Xr telnet 1 ,
810.Xr sshd 8 ,
811and
812.Xr telnetd 8 .
813.It Va WITH_KERNEL_RETPOLINE
814Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
815build.
816.It Va WITHOUT_KERNEL_SYMBOLS
817Set to not install kernel symbol files.
818.Bf -symbolic
819This option is recommended for those people who have small root partitions.
820.Ef
821.It Va WITHOUT_KVM
822Set to not build the
823.Nm libkvm
824library as a part of the base system.
825.Bf -symbolic
826The option has no effect yet.
827.Ef
828When set, these options are also in effect:
829.Pp
830.Bl -inset -compact
831.It Va WITHOUT_KVM_SUPPORT
832(unless
833.Va WITH_KVM_SUPPORT
834is set explicitly)
835.El
836.It Va WITHOUT_KVM_SUPPORT
837Set to build some programs without optional
838.Nm libkvm
839support.
840.It Va WITHOUT_LDNS
841Setting this variable will prevent the LDNS library from being built.
842When set, it enforces these options:
843.Pp
844.Bl -item -compact
845.It
846.Va WITHOUT_LDNS_UTILS
847.It
848.Va WITHOUT_UNBOUND
849.El
850.It Va WITHOUT_LDNS_UTILS
851Setting this variable will prevent building the LDNS utilities
852.Xr drill 1
853and
854.Xr host 1 .
855.It Va WITHOUT_LEGACY_CONSOLE
856Set to not build programs that support a legacy PC console; e.g.,
857.Xr kbdcontrol 1
858and
859.Xr vidcontrol 1 .
860.It Va WITHOUT_LIB32
861On 64-bit platforms, set to not build 32-bit library set and a
862.Nm ld-elf32.so.1
863runtime linker.
864.Pp
865This is a default setting on
866arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
867.It Va WITHOUT_LIBCPLUSPLUS
868Set to avoid building libcxxrt and libc++.
869.It Va WITHOUT_LIBPTHREAD
870Set to not build the
871.Nm libpthread
872providing library,
873.Nm libthr .
874When set, it enforces these options:
875.Pp
876.Bl -item -compact
877.It
878.Va WITHOUT_LIBTHR
879.El
880.It Va WITH_LIBSOFT
881On armv6 only, set to enable soft float ABI compatibility libraries.
882This option is for transitioning to the new hard float ABI.
883.It Va WITHOUT_LIBTHR
884Set to not build the
885.Nm libthr
886(1:1 threading)
887library.
888.It Va WITHOUT_LLD
889Set to not build LLVM's lld linker.
890.It Va WITHOUT_LLDB
891Set to not build the LLDB debugger.
892.Pp
893This is a default setting on
894arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
895.It Va WITH_LLDB
896Set to build the LLDB debugger.
897.Pp
898This is a default setting on
899amd64/amd64, arm64/aarch64 and i386/i386.
900.It Va WITHOUT_LLD_BOOTSTRAP
901Set to not build the LLD linker during the bootstrap phase of
902the build.
903To be able to build the system, either Binutils or LLD bootstrap must be
904enabled unless an alternate linker is provided via XLD.
905.It Va WITHOUT_LLD_IS_LD
906Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
907.It Va WITHOUT_LLVM_ASSERTIONS
908Set to disable debugging assertions in LLVM.
909.It Va WITHOUT_LLVM_COV
910Set to not build the
911.Xr llvm-cov 1
912tool.
913.It Va WITHOUT_LLVM_TARGET_AARCH64
914Set to not build LLVM target support for AArch64.
915The
916.Va LLVM_TARGET_ALL
917option should be used rather than this in most cases.
918.It Va WITHOUT_LLVM_TARGET_ALL
919Set to only build the required LLVM target support.
920This option is preferred to specific target support options.
921When set, these options are also in effect:
922.Pp
923.Bl -inset -compact
924.It Va WITHOUT_LLVM_TARGET_AARCH64
925(unless
926.Va WITH_LLVM_TARGET_AARCH64
927is set explicitly)
928.It Va WITHOUT_LLVM_TARGET_ARM
929(unless
930.Va WITH_LLVM_TARGET_ARM
931is set explicitly)
932.It Va WITHOUT_LLVM_TARGET_MIPS
933(unless
934.Va WITH_LLVM_TARGET_MIPS
935is set explicitly)
936.It Va WITHOUT_LLVM_TARGET_POWERPC
937(unless
938.Va WITH_LLVM_TARGET_POWERPC
939is set explicitly)
940.It Va WITHOUT_LLVM_TARGET_RISCV
941(unless
942.Va WITH_LLVM_TARGET_RISCV
943is set explicitly)
944.El
945.It Va WITHOUT_LLVM_TARGET_ARM
946Set to not build LLVM target support for ARM.
947The
948.Va LLVM_TARGET_ALL
949option should be used rather than this in most cases.
950.It Va WITH_LLVM_TARGET_BPF
951Set to build LLVM target support for BPF.
952The
953.Va LLVM_TARGET_ALL
954option should be used rather than this in most cases.
955.It Va WITHOUT_LLVM_TARGET_MIPS
956Set to not build LLVM target support for MIPS.
957The
958.Va LLVM_TARGET_ALL
959option should be used rather than this in most cases.
960.It Va WITHOUT_LLVM_TARGET_POWERPC
961Set to not build LLVM target support for PowerPC.
962The
963.Va LLVM_TARGET_ALL
964option should be used rather than this in most cases.
965.It Va WITHOUT_LLVM_TARGET_RISCV
966Set to not build LLVM target support for RISC-V.
967The
968.Va LLVM_TARGET_ALL
969option should be used rather than this in most cases.
970.It Va WITHOUT_LLVM_TARGET_X86
971Set to not build LLVM target support for X86.
972The
973.Va LLVM_TARGET_ALL
974option should be used rather than this in most cases.
975.It Va WITH_LOADER_EFI_SECUREBOOT
976Enable building
977.Xr loader 8
978with support for verification based on certificates obtained from UEFI.
979.Pp
980.It Va WITH_LOADER_FIREWIRE
981Enable firewire support in /boot/loader on x86. This option is a nop
982on all other platforms.
983.It Va WITH_LOADER_FORCE_LE
984Set to force the powerpc boot loader to launch the kernel in little
985endian mode.
986.It Va WITHOUT_LOADER_GELI
987Disable inclusion of GELI crypto support in the boot chain binaries.
988.Pp
989This is a default setting on
990powerpc/powerpc and powerpc/powerpc64.
991.It Va WITH_LOADER_GELI
992Set to build GELI bootloader support.
993.Pp
994This is a default setting on
995amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
996.It Va WITHOUT_LOADER_LUA
997Set to not build LUA bindings for the boot loader.
998.Pp
999This is a default setting on
1000powerpc/powerpc and powerpc/powerpc64.
1001.It Va WITH_LOADER_LUA
1002Set to build LUA bindings for the boot loader.
1003.Pp
1004This is a default setting on
1005amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1006.It Va WITHOUT_LOADER_OFW
1007Disable building of openfirmware bootloader components.
1008.Pp
1009This is a default setting on
1010amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1011.It Va WITH_LOADER_OFW
1012Set to build openfirmware bootloader components.
1013.Pp
1014This is a default setting on
1015powerpc/powerpc and powerpc/powerpc64.
1016.It Va WITHOUT_LOADER_UBOOT
1017Disable building of ubldr.
1018.Pp
1019This is a default setting on
1020amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
1021.It Va WITH_LOADER_UBOOT
1022Set to build ubldr.
1023.Pp
1024This is a default setting on
1025arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
1026.It Va WITH_LOADER_VERBOSE
1027Set to build with extra verbose debugging in the loader.
1028May explode already nearly too large loader over the limit.
1029Use with care.
1030
1031.It Va WITH_LOADER_VERIEXEC
1032Enable building
1033.Xr loader 8
1034with support for verification similar to Verified Exec.
1035.Pp
1036Depends on
1037.Va WITH_BEARSSL .
1038When set, these options are also in effect:
1039.Pp
1040.Bl -inset -compact
1041.It Va WITH_LOADER_EFI_SECUREBOOT
1042(unless
1043.Va WITHOUT_LOADER_EFI_SECUREBOOT
1044is set explicitly)
1045.It Va WITH_LOADER_VERIEXEC_VECTX
1046(unless
1047.Va WITHOUT_LOADER_VERIEXEC_VECTX
1048is set explicitly)
1049.El
1050.It Va WITH_LOADER_VERIEXEC_PASS_MANIFEST
1051Enable building
1052.Xr loader 8
1053with support to pass a verified manifest to the kernel.
1054The kernel has to be built with a module to parse the manifest.
1055.Pp
1056Depends on
1057.Va WITH_LOADER_VERIEXEC .
1058.It Va WITHOUT_LOADER_ZFS
1059Set to not build ZFS file system boot loader support.
1060.It Va WITHOUT_LOCALES
1061Set to not build localization files; see
1062.Xr locale 1 .
1063.It Va WITHOUT_LOCATE
1064Set to not build
1065.Xr locate 1
1066and related programs.
1067.It Va WITHOUT_LPR
1068Set to not build
1069.Xr lpr 1
1070and related programs.
1071.It Va WITHOUT_LS_COLORS
1072Set to build
1073.Xr ls 1
1074without support for colors to distinguish file types.
1075.It Va WITHOUT_LZMA_SUPPORT
1076Set to build some programs without optional lzma compression support.
1077.It Va WITHOUT_MAIL
1078Set to not build any mail support (MUA or MTA).
1079When set, it enforces these options:
1080.Pp
1081.Bl -item -compact
1082.It
1083.Va WITHOUT_DMAGENT
1084.It
1085.Va WITHOUT_MAILWRAPPER
1086.It
1087.Va WITHOUT_SENDMAIL
1088.El
1089.It Va WITHOUT_MAILWRAPPER
1090Set to not build the
1091.Xr mailwrapper 8
1092MTA selector.
1093.It Va WITHOUT_MAKE
1094Set to not install
1095.Xr make 1
1096and related support files.
1097.It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1098Set to not execute
1099.Dq Li "make check"
1100in limited sandbox mode.
1101This option should be paired with
1102.Va WITH_INSTALL_AS_USER
1103if executed as an unprivileged user.
1104See
1105.Xr tests 7
1106for more details.
1107.It Va WITHOUT_MAN
1108Set to not build manual pages.
1109When set, these options are also in effect:
1110.Pp
1111.Bl -inset -compact
1112.It Va WITHOUT_MAN_UTILS
1113(unless
1114.Va WITH_MAN_UTILS
1115is set explicitly)
1116.El
1117.It Va WITHOUT_MANCOMPRESS
1118Set to not to install compressed man pages.
1119Only the uncompressed versions will be installed.
1120.It Va WITHOUT_MAN_UTILS
1121Set to not build utilities for manual pages,
1122.Xr apropos 1 ,
1123.Xr makewhatis 1 ,
1124.Xr man 1 ,
1125.Xr whatis 1 ,
1126.Xr manctl 8 ,
1127and related support files.
1128.It Va WITH_META_MODE
1129Create
1130.Xr make 1
1131meta files when building, which can provide a reliable incremental build when
1132using
1133.Xr filemon 4 .
1134The meta file is created in OBJDIR as
1135.Pa target.meta .
1136These meta files track the command that was executed, its output, and the
1137current directory.
1138The
1139.Xr filemon 4
1140module is required unless
1141.Va NO_FILEMON
1142is defined.
1143When the module is loaded, any files used by the commands executed are
1144tracked as dependencies for the target in its meta file.
1145The target is considered out-of-date and rebuilt if any of these
1146conditions are true compared to the last build:
1147.Bl -bullet -compact
1148.It
1149The command to execute changes.
1150.It
1151The current working directory changes.
1152.It
1153The target's meta file is missing.
1154.It
1155The target's meta file is missing filemon data when filemon is loaded
1156and a previous run did not have it loaded.
1157.It
1158[requires
1159.Xr filemon 4 ]
1160Files read, executed or linked to are newer than the target.
1161.It
1162[requires
1163.Xr filemon 4 ]
1164Files read, written, executed or linked are missing.
1165.El
1166The meta files can also be useful for debugging.
1167.Pp
1168The build hides commands that are executed unless
1169.Va NO_SILENT
1170is defined.
1171Errors cause
1172.Xr make 1
1173to show some of its environment for further debugging.
1174.Pp
1175The build operates as it normally would otherwise.
1176This option originally invoked a different build system but that was renamed
1177to
1178.Va WITH_DIRDEPS_BUILD .
1179.Pp
1180This must be set in the environment, make command line, or
1181.Pa /etc/src-env.conf ,
1182not
1183.Pa /etc/src.conf .
1184.It Va WITHOUT_MLX5TOOL
1185Set to not build
1186.Xr mlx5tool 8
1187.Pp
1188This is a default setting on
1189arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1190.It Va WITH_MLX5TOOL
1191Set to build
1192.Xr mlx5tool 8
1193.Pp
1194This is a default setting on
1195amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1196.It Va WITHOUT_NDIS
1197Set to not build programs and libraries
1198related to NDIS emulation support.
1199.It Va WITHOUT_NETCAT
1200Set to not build
1201.Xr nc 1
1202utility.
1203.It Va WITHOUT_NETGRAPH
1204Set to not build applications to support
1205.Xr netgraph 4 .
1206When set, it enforces these options:
1207.Pp
1208.Bl -item -compact
1209.It
1210.Va WITHOUT_ATM
1211.It
1212.Va WITHOUT_BLUETOOTH
1213.El
1214.Pp
1215When set, these options are also in effect:
1216.Pp
1217.Bl -inset -compact
1218.It Va WITHOUT_NETGRAPH_SUPPORT
1219(unless
1220.Va WITH_NETGRAPH_SUPPORT
1221is set explicitly)
1222.El
1223.It Va WITHOUT_NETGRAPH_SUPPORT
1224Set to build libraries, programs, and kernel modules without netgraph support.
1225.It Va WITHOUT_NIS
1226Set to not build
1227.Xr NIS 8
1228support and related programs.
1229If set, you might need to adopt your
1230.Xr nsswitch.conf 5
1231and remove
1232.Sq nis
1233entries.
1234.It Va WITHOUT_NLS
1235Set to not build NLS catalogs.
1236When set, it enforces these options:
1237.Pp
1238.Bl -item -compact
1239.It
1240.Va WITHOUT_NLS_CATALOGS
1241.El
1242.It Va WITHOUT_NLS_CATALOGS
1243Set to not build NLS catalog support for
1244.Xr csh 1 .
1245.It Va WITHOUT_NS_CACHING
1246Set to disable name caching in the
1247.Pa nsswitch
1248subsystem.
1249The generic caching daemon,
1250.Xr nscd 8 ,
1251will not be built either if this option is set.
1252.It Va WITHOUT_NTP
1253Set to not build
1254.Xr ntpd 8
1255and related programs.
1256.It Va WITHOUT_NVME
1257Set to not build nvme related tools and kernel modules.
1258.Pp
1259This is a default setting on
1260arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1261.It Va WITH_NVME
1262Set to build nvme related tools and kernel modules.
1263
1264.Pp
1265This is a default setting on
1266amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1267.It Va WITH_OFED
1268Set to build the
1269.Dq "OpenFabrics Enterprise Distribution"
1270Infiniband software stack.
1271.It Va WITH_OFED_EXTRA
1272Set to build the non-essential components of the
1273.Dq "OpenFabrics Enterprise Distribution"
1274Infiniband software stack, mostly examples.
1275.It Va WITH_OPENLDAP
1276Enable building openldap support for kerberos.
1277.It Va WITHOUT_OPENMP
1278Set to not build LLVM's OpenMP runtime.
1279.Pp
1280This is a default setting on
1281arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1282.It Va WITH_OPENMP
1283Set to build LLVM's OpenMP runtime.
1284.Pp
1285This is a default setting on
1286amd64/amd64, i386/i386 and powerpc/powerpc64.
1287.It Va WITHOUT_OPENSSH
1288Set to not build OpenSSH.
1289.It Va WITHOUT_OPENSSL
1290Set to not build OpenSSL.
1291When set, it enforces these options:
1292.Pp
1293.Bl -item -compact
1294.It
1295.Va WITHOUT_DMAGENT
1296.It
1297.Va WITHOUT_KERBEROS
1298.It
1299.Va WITHOUT_KERBEROS_SUPPORT
1300.It
1301.Va WITHOUT_LDNS
1302.It
1303.Va WITHOUT_LDNS_UTILS
1304.It
1305.Va WITHOUT_OPENSSH
1306.It
1307.Va WITHOUT_PKGBOOTSTRAP
1308.It
1309.Va WITHOUT_SVN
1310.It
1311.Va WITHOUT_SVNLITE
1312.It
1313.Va WITHOUT_UNBOUND
1314.It
1315.Va WITHOUT_WIRELESS
1316.El
1317.Pp
1318When set, these options are also in effect:
1319.Pp
1320.Bl -inset -compact
1321.It Va WITHOUT_GSSAPI
1322(unless
1323.Va WITH_GSSAPI
1324is set explicitly)
1325.El
1326.It Va WITHOUT_PAM
1327Set to not build PAM library and modules.
1328.Bf -symbolic
1329This option is deprecated and does nothing.
1330.Ef
1331When set, these options are also in effect:
1332.Pp
1333.Bl -inset -compact
1334.It Va WITHOUT_PAM_SUPPORT
1335(unless
1336.Va WITH_PAM_SUPPORT
1337is set explicitly)
1338.El
1339.It Va WITHOUT_PAM_SUPPORT
1340Set to build some programs without PAM support, particularly
1341.Xr ftpd 8
1342and
1343.Xr ppp 8 .
1344.It Va WITHOUT_PF
1345Set to not build PF firewall package.
1346When set, it enforces these options:
1347.Pp
1348.Bl -item -compact
1349.It
1350.Va WITHOUT_AUTHPF
1351.El
1352.It Va WITH_PIE
1353Build dynamically linked binaries as
1354Position-Independent Executable (PIE).
1355.It Va WITHOUT_PKGBOOTSTRAP
1356Set to not build
1357.Xr pkg 7
1358bootstrap tool.
1359.It Va WITHOUT_PMC
1360Set to not build
1361.Xr pmccontrol 8
1362and related programs.
1363.It Va WITHOUT_PORTSNAP
1364Set to not build or install
1365.Xr portsnap 8
1366and related files.
1367When set, it enforces these options:
1368.Pp
1369.Bl -item -compact
1370.It
1371.Va WITHOUT_FREEBSD_UPDATE
1372.El
1373.It Va WITHOUT_PPP
1374Set to not build
1375.Xr ppp 8
1376and related programs.
1377.It Va WITHOUT_PROFILE
1378Set to not build profiled libraries for use with
1379.Xr gprof 8 .
1380.Pp
1381This is a default setting on
1382mips/mips64.
1383.It Va WITH_PROFILE
1384Set to build profiled libraries for use with
1385.Xr gprof 8 .
1386.Pp
1387This is a default setting on
1388amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
1389.It Va WITHOUT_QUOTAS
1390Set to not build
1391.Xr quota 1
1392and related programs.
1393.It Va WITHOUT_RADIUS_SUPPORT
1394Set to not build radius support into various applications, like
1395.Xr pam_radius 8
1396and
1397.Xr ppp 8 .
1398.It Va WITH_RATELIMIT
1399Set to build the system with rate limit support.
1400.Pp
1401This makes
1402.Dv SO_MAX_PACING_RATE
1403effective in
1404.Xr getsockopt 2 ,
1405and
1406.Ar txrlimit
1407support in
1408.Xr ifconfig 8 ,
1409by proxy.
1410.It Va WITHOUT_RBOOTD
1411Set to not build or install
1412.Xr rbootd 8 .
1413.It Va WITH_REPRODUCIBLE_BUILD
1414Set to exclude build metadata (such as the build time, user, or host)
1415from the kernel, boot loaders, and uname output, so that builds produce
1416bit-for-bit identical output.
1417.It Va WITHOUT_RESCUE
1418Set to not build
1419.Xr rescue 8 .
1420.It Va WITH_RETPOLINE
1421Set to build the base system with the retpoline speculative execution
1422vulnerability mitigation for CVE-2017-5715.
1423.It Va WITHOUT_ROUTED
1424Set to not build
1425.Xr routed 8
1426utility.
1427.It Va WITH_RPCBIND_WARMSTART_SUPPORT
1428Set to build
1429.Xr rpcbind 8
1430with warmstart support.
1431.It Va WITHOUT_SENDMAIL
1432Set to not build
1433.Xr sendmail 8
1434and related programs.
1435.It Va WITHOUT_SERVICESDB
1436Set to not install
1437.Pa /var/db/services.db .
1438.It Va WITHOUT_SETUID_LOGIN
1439Set this to disable the installation of
1440.Xr login 1
1441as a set-user-ID root program.
1442.It Va WITHOUT_SHAREDOCS
1443Set to not build the
1444.Bx 4.4
1445legacy docs.
1446.It Va WITHOUT_SHARED_TOOLCHAIN
1447Set to build the toolchain binaries as statically linked executables.
1448The set includes
1449.Xr cc 1 ,
1450.Xr make 1
1451and necessary utilities like assembler, linker and library archive manager.
1452.It Va WITH_SORT_THREADS
1453Set to enable threads in
1454.Xr sort 1 .
1455.It Va WITHOUT_SOURCELESS
1456Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1457When set, it enforces these options:
1458.Pp
1459.Bl -item -compact
1460.It
1461.Va WITHOUT_SOURCELESS_HOST
1462.It
1463.Va WITHOUT_SOURCELESS_UCODE
1464.El
1465.It Va WITHOUT_SOURCELESS_HOST
1466Set to not build kernel modules that include sourceless native code for host CPU.
1467.It Va WITHOUT_SOURCELESS_UCODE
1468Set to not build kernel modules that include sourceless microcode.
1469.It Va WITHOUT_SSP
1470Set to not build world with propolice stack smashing protection.
1471.Pp
1472This is a default setting on
1473mips/mips and mips/mips64.
1474.It Va WITH_SSP
1475Set to build world with propolice stack smashing protection.
1476.Pp
1477This is a default setting on
1478amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
1479.It Va WITH_STAGING
1480Enable staging of files to a stage tree.
1481This can be best thought of as auto-install to
1482.Va DESTDIR
1483with some extra meta data to ensure dependencies can be tracked.
1484Depends on
1485.Va WITH_DIRDEPS_BUILD .
1486When set, these options are also in effect:
1487.Pp
1488.Bl -inset -compact
1489.It Va WITH_STAGING_MAN
1490(unless
1491.Va WITHOUT_STAGING_MAN
1492is set explicitly)
1493.It Va WITH_STAGING_PROG
1494(unless
1495.Va WITHOUT_STAGING_PROG
1496is set explicitly)
1497.El
1498.Pp
1499This must be set in the environment, make command line, or
1500.Pa /etc/src-env.conf ,
1501not
1502.Pa /etc/src.conf .
1503.It Va WITH_STAGING_MAN
1504Enable staging of man pages to stage tree.
1505.It Va WITH_STAGING_PROG
1506Enable staging of PROGs to stage tree.
1507.It Va WITH_STALE_STAGED
1508Check staged files are not stale.
1509.It Va WITHOUT_STATS
1510Set to neither build nor install
1511.Lb libstats
1512and dependent binaries.
1513.It Va WITH_SVN
1514Set to install
1515.Xr svnlite 1
1516as
1517.Xr svn 1 .
1518.It Va WITHOUT_SVNLITE
1519Set to not build
1520.Xr svnlite 1
1521and related programs.
1522.It Va WITHOUT_SYSCONS
1523Set to not build
1524.Xr syscons 4
1525support files such as keyboard maps, fonts, and screen output maps.
1526.It Va WITH_SYSROOT
1527Enable use of sysroot during build.
1528Depends on
1529.Va WITH_DIRDEPS_BUILD .
1530.Pp
1531This must be set in the environment, make command line, or
1532.Pa /etc/src-env.conf ,
1533not
1534.Pa /etc/src.conf .
1535.It Va WITHOUT_SYSTEM_COMPILER
1536Set to not opportunistically skip building a cross-compiler during the
1537bootstrap phase of the build.
1538Normally, if the currently installed compiler matches the planned bootstrap
1539compiler type and revision, then it will not be built.
1540This does not prevent a compiler from being built for installation though,
1541only for building one for the build itself.
1542The
1543.Va WITHOUT_CLANG
1544option controls that.
1545.It Va WITHOUT_SYSTEM_LINKER
1546Set to not opportunistically skip building a cross-linker during the
1547bootstrap phase of the build.
1548Normally, if the currently installed linker matches the planned bootstrap
1549linker type and revision, then it will not be built.
1550This does not prevent a linker from being built for installation though,
1551only for building one for the build itself.
1552The
1553.Va WITHOUT_LLD
1554option controls that.
1555.Pp
1556This option is only relevant when
1557.Va WITH_LLD_BOOTSTRAP
1558is set.
1559.It Va WITHOUT_TALK
1560Set to not build or install
1561.Xr talk 1
1562and
1563.Xr talkd 8 .
1564.It Va WITHOUT_TCP_WRAPPERS
1565Set to not build or install
1566.Xr tcpd 8 ,
1567and related utilities.
1568.It Va WITHOUT_TCSH
1569Set to not build and install
1570.Pa /bin/csh
1571(which is
1572.Xr tcsh 1 ) .
1573.It Va WITHOUT_TELNET
1574Set to not build
1575.Xr telnet 1
1576and related programs.
1577.It Va WITHOUT_TESTS
1578Set to not build nor install the
1579.Fx
1580Test Suite in
1581.Pa /usr/tests/ .
1582See
1583.Xr tests 7
1584for more details.
1585This also disables the build of all test-related dependencies, including ATF.
1586When set, it enforces these options:
1587.Pp
1588.Bl -item -compact
1589.It
1590.Va WITHOUT_DTRACE_TESTS
1591.El
1592.Pp
1593When set, these options are also in effect:
1594.Pp
1595.Bl -inset -compact
1596.It Va WITHOUT_GOOGLETEST
1597(unless
1598.Va WITH_GOOGLETEST
1599is set explicitly)
1600.It Va WITHOUT_TESTS_SUPPORT
1601(unless
1602.Va WITH_TESTS_SUPPORT
1603is set explicitly)
1604.El
1605.It Va WITHOUT_TESTS_SUPPORT
1606Set to disables the build of all test-related dependencies, including ATF.
1607When set, it enforces these options:
1608.Pp
1609.Bl -item -compact
1610.It
1611.Va WITHOUT_GOOGLETEST
1612.El
1613.It Va WITHOUT_TEXTPROC
1614Set to not build
1615programs used for text processing.
1616.It Va WITHOUT_TFTP
1617Set to not build or install
1618.Xr tftp 1
1619and
1620.Xr tftpd 8 .
1621.It Va WITHOUT_TOOLCHAIN
1622Set to not install header or
1623programs used for program development,
1624compilers, debuggers etc.
1625When set, it enforces these options:
1626.Pp
1627.Bl -item -compact
1628.It
1629.Va WITHOUT_CLANG
1630.It
1631.Va WITHOUT_CLANG_EXTRAS
1632.It
1633.Va WITHOUT_CLANG_FORMAT
1634.It
1635.Va WITHOUT_CLANG_FULL
1636.It
1637.Va WITHOUT_GDB
1638.It
1639.Va WITHOUT_INCLUDES
1640.It
1641.Va WITHOUT_LLD
1642.It
1643.Va WITHOUT_LLDB
1644.It
1645.Va WITHOUT_LLVM_COV
1646.El
1647.It Va WITHOUT_UNBOUND
1648Set to not build
1649.Xr unbound 8
1650and related programs.
1651.It Va WITHOUT_UNIFIED_OBJDIR
1652Set to use the historical object directory format for
1653.Xr build 7
1654targets.
1655For native-builds and builds done directly in sub-directories the format of
1656.Pa ${MAKEOBJDIRPREFIX}/${.CURDIR}
1657is used,
1658while for cross-builds
1659.Pa ${MAKEOBJDIRPREFIX}/${TARGET}.${TARGET_ARCH}/${.CURDIR}
1660is used.
1661.Pp
1662This option is transitional and will be removed before the 12.0 release,
1663at which time
1664.va WITH_UNIFIED_OBJDIR
1665will be enabled permanently.
1666.Pp
1667This must be set in the environment, make command line, or
1668.Pa /etc/src-env.conf ,
1669not
1670.Pa /etc/src.conf .
1671.It Va WITHOUT_USB
1672Set to not build USB-related programs and libraries.
1673.It Va WITHOUT_USB_GADGET_EXAMPLES
1674Set to not build USB gadget kernel modules.
1675.It Va WITHOUT_UTMPX
1676Set to not build user accounting tools such as
1677.Xr last 1 ,
1678.Xr users 1 ,
1679.Xr who 1 ,
1680.Xr ac 8 ,
1681.Xr lastlogin 8
1682and
1683.Xr utx 8 .
1684.It Va WITH_VERIEXEC
1685Enable building
1686.Xr veriexec 8
1687which loads the contents of verified manifests into the kernel
1688for use by
1689.Xr mac_veriexec 4
1690.Pp
1691Depends on
1692.Va WITH_BEARSSL .
1693.It Va WITHOUT_VI
1694Set to not build and install vi, view, ex and related programs.
1695.It Va WITHOUT_VT
1696Set to not build
1697.Xr vt 4
1698support files (fonts and keymaps).
1699.It Va WITHOUT_WARNS
1700Set this to not add warning flags to the compiler invocations.
1701Useful as a temporary workaround when code enters the tree
1702which triggers warnings in environments that differ from the
1703original developer.
1704.It Va WITHOUT_WIRELESS
1705Set to not build programs used for 802.11 wireless networks; especially
1706.Xr wpa_supplicant 8
1707and
1708.Xr hostapd 8 .
1709When set, these options are also in effect:
1710.Pp
1711.Bl -inset -compact
1712.It Va WITHOUT_WIRELESS_SUPPORT
1713(unless
1714.Va WITH_WIRELESS_SUPPORT
1715is set explicitly)
1716.El
1717.It Va WITHOUT_WIRELESS_SUPPORT
1718Set to build libraries, programs, and kernel modules without
1719802.11 wireless support.
1720.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1721Build
1722.Xr wpa_supplicant 8
1723without support for the IEEE 802.1X protocol and without
1724support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1725protocols (usable only via 802.1X).
1726.It Va WITHOUT_ZFS
1727Set to not build ZFS file system kernel module, libraries, and user commands.
1728.It Va WITHOUT_ZONEINFO
1729Set to not build the timezone database.
1730When set, it enforces these options:
1731.Pp
1732.Bl -item -compact
1733.It
1734.Va WITHOUT_ZONEINFO_LEAPSECONDS_SUPPORT
1735.El
1736.It Va WITH_ZONEINFO_LEAPSECONDS_SUPPORT
1737Set to build leapsecond information in to the timezone database.
1738.El
1739.Sh FILES
1740.Bl -tag -compact -width Pa
1741.It Pa /etc/src.conf
1742.It Pa /etc/src-env.conf
1743.It Pa /usr/share/mk/bsd.own.mk
1744.El
1745.Sh SEE ALSO
1746.Xr make 1 ,
1747.Xr make.conf 5 ,
1748.Xr build 7 ,
1749.Xr ports 7
1750.Sh HISTORY
1751The
1752.Nm
1753file appeared in
1754.Fx 7.0 .
1755.Sh AUTHORS
1756This manual page was autogenerated by
1757.An tools/build/options/makeman .
1758