xref: /freebsd/share/man/man5/src.conf.5 (revision 3c134670993bf525fcd6c4dfef84a3dfc3d4ed1b)
1.\" DO NOT EDIT-- this file is @generated by tools/build/options/makeman.
2.\" $FreeBSD$
3.Dd September 8, 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_CLEAN
350Do not clean before building world and/or kernel.
351.It Va WITHOUT_CPP
352Set to not build
353.Xr cpp 1 .
354.It Va WITHOUT_CROSS_COMPILER
355Set to not build any cross compiler in the cross-tools stage of buildworld.
356When compiling a different version of
357.Fx
358than what is installed on the system, provide an alternate
359compiler with XCC to ensure success.
360When compiling with an identical version of
361.Fx
362to the host, this option may be safely used.
363This option may also be safe when the host version of
364.Fx
365is close to the sources being built, but all bets are off if there have
366been any changes to the toolchain between the versions.
367When set, it enforces these options:
368.Pp
369.Bl -item -compact
370.It
371.Va WITHOUT_CLANG_BOOTSTRAP
372.It
373.Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
374.It
375.Va WITHOUT_LLD_BOOTSTRAP
376.El
377.It Va WITHOUT_CRYPT
378Set to not build any crypto code.
379When set, it enforces these options:
380.Pp
381.Bl -item -compact
382.It
383.Va WITHOUT_DMAGENT
384.It
385.Va WITHOUT_KERBEROS
386.It
387.Va WITHOUT_KERBEROS_SUPPORT
388.It
389.Va WITHOUT_LDNS
390.It
391.Va WITHOUT_LDNS_UTILS
392.It
393.Va WITHOUT_OPENSSH
394.It
395.Va WITHOUT_OPENSSL
396.It
397.Va WITHOUT_PKGBOOTSTRAP
398.It
399.Va WITHOUT_SVN
400.It
401.Va WITHOUT_SVNLITE
402.It
403.Va WITHOUT_UNBOUND
404.It
405.Va WITHOUT_WIRELESS
406.El
407.Pp
408When set, these options are also in effect:
409.Pp
410.Bl -inset -compact
411.It Va WITHOUT_GSSAPI
412(unless
413.Va WITH_GSSAPI
414is set explicitly)
415.El
416.It Va WITH_CTF
417Set to compile with CTF (Compact C Type Format) data.
418CTF data encapsulates a reduced form of debugging information
419similar to DWARF and the venerable stabs and is required for DTrace.
420.It Va WITHOUT_CUSE
421Set to not build CUSE-related programs and libraries.
422.It Va WITHOUT_CXGBETOOL
423Set to not build
424.Xr cxgbetool 8
425.Pp
426This is a default setting on
427arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
428.It Va WITH_CXGBETOOL
429Set to build
430.Xr cxgbetool 8
431.Pp
432This is a default setting on
433amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
434.It Va WITHOUT_CXX
435Set to not build
436.Xr c++ 1
437and related libraries.
438It will also prevent building of
439.Xr gperf 1
440and
441.Xr devd 8 .
442When set, it enforces these options:
443.Pp
444.Bl -item -compact
445.It
446.Va WITHOUT_CLANG
447.It
448.Va WITHOUT_CLANG_EXTRAS
449.It
450.Va WITHOUT_CLANG_FORMAT
451.It
452.Va WITHOUT_CLANG_FULL
453.It
454.Va WITHOUT_DTRACE_TESTS
455.It
456.Va WITHOUT_GOOGLETEST
457.It
458.Va WITHOUT_LLVM_COV
459.It
460.Va WITHOUT_TESTS
461.El
462.It Va WITHOUT_DEBUG_FILES
463Set to avoid building or installing standalone debug files for each
464executable binary and shared library.
465.It Va WITHOUT_DIALOG
466Set to not build
467.Xr dialog 1 ,
468.Xr dialog 3 ,
469.Xr dpv 1 ,
470and
471.Xr dpv 3 .
472When set, it enforces these options:
473.Pp
474.Bl -item -compact
475.It
476.Va WITHOUT_BSDINSTALL
477.El
478.It Va WITHOUT_DICT
479Set to not build the Webster dictionary files.
480.It Va WITH_DIRDEPS_BUILD
481This is an experimental build system.
482For details see
483http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
484Build commands can be seen from the top-level with:
485.Dl make show-valid-targets
486The build is driven by dirdeps.mk using
487.Va DIRDEPS
488stored in
489Makefile.depend files found in each directory.
490.Pp
491The build can be started from anywhere, and behaves the same.
492The initial instance of
493.Xr make 1
494recursively reads
495.Va DIRDEPS
496from
497.Pa Makefile.depend ,
498computing a graph of tree dependencies from the current origin.
499Setting
500.Va NO_DIRDEPS
501skips checking dirdep dependencies and will only build in the current
502and child directories.
503.Va NO_DIRDEPS_BELOW
504skips building any dirdeps and only build the current directory.
505.Pp
506This also utilizes the
507.Va WITH_META_MODE
508logic for incremental builds.
509.Pp
510The build hides commands executed unless
511.Va NO_SILENT
512is defined.
513.Pp
514Note that there is currently no mass install feature for this.
515.Pp
516When set, it enforces these options:
517.Pp
518.Bl -item -compact
519.It
520.Va WITH_INSTALL_AS_USER
521.El
522.Pp
523When set, these options are also in effect:
524.Pp
525.Bl -inset -compact
526.It Va WITH_META_MODE
527(unless
528.Va WITHOUT_META_MODE
529is set explicitly)
530.It Va WITH_STAGING
531(unless
532.Va WITHOUT_STAGING
533is set explicitly)
534.It Va WITH_STAGING_MAN
535(unless
536.Va WITHOUT_STAGING_MAN
537is set explicitly)
538.It Va WITH_STAGING_PROG
539(unless
540.Va WITHOUT_STAGING_PROG
541is set explicitly)
542.It Va WITH_SYSROOT
543(unless
544.Va WITHOUT_SYSROOT
545is set explicitly)
546.El
547.Pp
548This must be set in the environment, make command line, or
549.Pa /etc/src-env.conf ,
550not
551.Pa /etc/src.conf .
552.It Va WITH_DIRDEPS_CACHE
553Cache result of dirdeps.mk which can save significant time
554for subsequent builds.
555Depends on
556.Va WITH_DIRDEPS_BUILD .
557.Pp
558This must be set in the environment, make command line, or
559.Pa /etc/src-env.conf ,
560not
561.Pa /etc/src.conf .
562.It Va WITHOUT_DMAGENT
563Set to not build dma Mail Transport Agent.
564.It Va WITHOUT_DOCCOMPRESS
565Set to not install compressed system documentation.
566Only the uncompressed version will be installed.
567.It Va WITH_DTRACE_TESTS
568Set to build and install the DTrace test suite in
569.Pa /usr/tests/cddl/usr.sbin/dtrace .
570This test suite is considered experimental on architectures other than
571amd64/amd64 and running it may cause system instability.
572.It Va WITHOUT_DYNAMICROOT
573Set this if you do not want to link
574.Pa /bin
575and
576.Pa /sbin
577dynamically.
578.It Va WITHOUT_EE
579Set to not build and install
580.Xr edit 1 ,
581.Xr ee 1 ,
582and related programs.
583.It Va WITHOUT_EFI
584Set not to build
585.Xr efivar 3
586and
587.Xr efivar 8 .
588.Pp
589This is a default setting on
590mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
591.It Va WITH_EFI
592Set to build
593.Xr efivar 3
594and
595.Xr efivar 8 .
596.Pp
597This is a default setting on
598amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
599.It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
600Set to not build ELF Tool Chain tools
601(addr2line, nm, size, strings and strip)
602as part of the bootstrap process.
603.Bf -symbolic
604An alternate bootstrap tool chain must be provided.
605.Ef
606.It Va WITHOUT_EXAMPLES
607Set to avoid installing examples to
608.Pa /usr/share/examples/ .
609.It Va WITH_EXPERIMENTAL
610Set to include experimental features in the build.
611.It Va WITH_EXTRA_TCP_STACKS
612Set to build extra TCP stack modules.
613.It Va WITHOUT_FDT
614Set to not build Flattened Device Tree support as part of the base system.
615This includes the device tree compiler (dtc) and libfdt support library.
616.It Va WITHOUT_FILE
617Set to not build
618.Xr file 1
619and related programs.
620When set, it enforces these options:
621.Pp
622.Bl -item -compact
623.It
624.Va WITHOUT_SVNLITE
625.El
626.It Va WITHOUT_FINGER
627Set to not build or install
628.Xr finger 1
629and
630.Xr fingerd 8 .
631.It Va WITHOUT_FLOPPY
632Set to not build or install programs
633for operating floppy disk driver.
634.It Va WITHOUT_FMTREE
635Set to not build and install
636.Pa /usr/sbin/fmtree .
637.It Va WITHOUT_FORMAT_EXTENSIONS
638Set to not enable
639.Fl fformat-extensions
640when compiling the kernel.
641Also disables all format checking.
642.It Va WITHOUT_FORTH
643Set to build bootloaders without Forth support.
644.It Va WITHOUT_FP_LIBC
645Set to build
646.Nm libc
647without floating-point support.
648.It Va WITHOUT_FREEBSD_UPDATE
649Set to not build
650.Xr freebsd-update 8 .
651.It Va WITHOUT_FTP
652Set to not build or install
653.Xr ftp 1
654and
655.Xr ftpd 8 .
656.It Va WITHOUT_GAMES
657Set to not build games.
658.It Va WITHOUT_GDB
659Set to not build
660.Xr gdb 1 .
661.Pp
662This is a default setting on
663arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
664.It Va WITH_GDB
665Set to build
666.Xr gdb 1 .
667.Pp
668This is a default setting on
669amd64/amd64, arm/armv6, arm/armv7, i386/i386, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
670.It Va WITHOUT_GNU_DIFF
671Set to not build GNU
672.Xr diff3 1 .
673.It Va WITHOUT_GNU_GREP
674Set to not build GNU
675.Xr grep 1 .
676.It Va WITH_GNU_GREP_COMPAT
677Set this option to include GNU extensions in
678.Xr bsdgrep 1
679by linking against libgnuregex.
680.It Va WITHOUT_GOOGLETEST
681Set to neither build nor install
682.Lb libgmock ,
683.Lb libgtest ,
684and dependent tests.
685.Pp
686This is a default setting on
687mips/mips and mips/mips64.
688.It Va WITH_GOOGLETEST
689Set to build and install
690.Lb libgmock ,
691.Lb libgtest ,
692and dependent tests.
693.Pp
694This is a default setting on
695amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
696.It Va WITHOUT_GPIO
697Set to not build
698.Xr gpioctl 8
699as part of the base system.
700.It Va WITHOUT_GSSAPI
701Set to not build libgssapi.
702.It Va WITHOUT_HAST
703Set to not build
704.Xr hastd 8
705and related utilities.
706.It Va WITH_HESIOD
707Set to build Hesiod support.
708.It Va WITHOUT_HTML
709Set to not build HTML docs.
710.It Va WITHOUT_HYPERV
711Set to not build or install HyperV utilities.
712.Pp
713This is a default setting on
714arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
715.It Va WITH_HYPERV
716Set to build or install HyperV utilities.
717.Pp
718This is a default setting on
719amd64/amd64 and i386/i386.
720.It Va WITHOUT_ICONV
721Set to not build iconv as part of libc.
722.It Va WITHOUT_INCLUDES
723Set to not install header files.
724This option used to be spelled
725.Va NO_INCS .
726.Bf -symbolic
727The option does not work for build targets.
728.Ef
729.It Va WITHOUT_INET
730Set to not build programs and libraries related to IPv4 networking.
731When set, it enforces these options:
732.Pp
733.Bl -item -compact
734.It
735.Va WITHOUT_INET_SUPPORT
736.El
737.It Va WITHOUT_INET6
738Set to not build
739programs and libraries related to IPv6 networking.
740When set, it enforces these options:
741.Pp
742.Bl -item -compact
743.It
744.Va WITHOUT_INET6_SUPPORT
745.El
746.It Va WITHOUT_INET6_SUPPORT
747Set to build libraries, programs, and kernel modules without IPv6 support.
748.It Va WITHOUT_INETD
749Set to not build
750.Xr inetd 8 .
751.It Va WITHOUT_INET_SUPPORT
752Set to build libraries, programs, and kernel modules without IPv4 support.
753.It Va WITHOUT_INSTALLLIB
754Set this to not install optional libraries.
755For example, when creating a
756.Xr nanobsd 8
757image.
758.Bf -symbolic
759The option does not work for build targets.
760.Ef
761.It Va WITH_INSTALL_AS_USER
762Set to make install targets succeed for non-root users by installing
763files with owner and group attributes set to that of the user running
764the
765.Xr make 1
766command.
767The user still must set the
768.Va DESTDIR
769variable to point to a directory where the user has write permissions.
770.It Va WITHOUT_IPFILTER
771Set to not build IP Filter package.
772.It Va WITHOUT_IPFW
773Set to not build IPFW tools.
774.It Va WITHOUT_IPSEC_SUPPORT
775Set to not build the kernel with
776.Xr ipsec 4
777support.
778This option is needed for
779.Xr ipsec 4
780and
781.Xr tcpmd5 4 .
782.It Va WITHOUT_ISCSI
783Set to not build
784.Xr iscsid 8
785and related utilities.
786.It Va WITHOUT_JAIL
787Set to not build tools for the support of jails; e.g.,
788.Xr jail 8 .
789.It Va WITHOUT_KDUMP
790Set to not build
791.Xr kdump 1
792and
793.Xr truss 1 .
794.It Va WITHOUT_KERBEROS
795Set this to not build Kerberos 5 (KTH Heimdal).
796When set, these options are also in effect:
797.Pp
798.Bl -inset -compact
799.It Va WITHOUT_GSSAPI
800(unless
801.Va WITH_GSSAPI
802is set explicitly)
803.It Va WITHOUT_KERBEROS_SUPPORT
804(unless
805.Va WITH_KERBEROS_SUPPORT
806is set explicitly)
807.El
808.It Va WITHOUT_KERBEROS_SUPPORT
809Set to build some programs without Kerberos support, like
810.Xr ssh 1 ,
811.Xr telnet 1 ,
812.Xr sshd 8 ,
813and
814.Xr telnetd 8 .
815.It Va WITH_KERNEL_RETPOLINE
816Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
817build.
818.It Va WITHOUT_KERNEL_SYMBOLS
819Set to not install kernel symbol files.
820.Bf -symbolic
821This option is recommended for those people who have small root partitions.
822.Ef
823.It Va WITHOUT_KVM
824Set to not build the
825.Nm libkvm
826library as a part of the base system.
827.Bf -symbolic
828The option has no effect yet.
829.Ef
830When set, these options are also in effect:
831.Pp
832.Bl -inset -compact
833.It Va WITHOUT_KVM_SUPPORT
834(unless
835.Va WITH_KVM_SUPPORT
836is set explicitly)
837.El
838.It Va WITHOUT_KVM_SUPPORT
839Set to build some programs without optional
840.Nm libkvm
841support.
842.It Va WITHOUT_LDNS
843Setting this variable will prevent the LDNS library from being built.
844When set, it enforces these options:
845.Pp
846.Bl -item -compact
847.It
848.Va WITHOUT_LDNS_UTILS
849.It
850.Va WITHOUT_UNBOUND
851.El
852.It Va WITHOUT_LDNS_UTILS
853Setting this variable will prevent building the LDNS utilities
854.Xr drill 1
855and
856.Xr host 1 .
857.It Va WITHOUT_LEGACY_CONSOLE
858Set to not build programs that support a legacy PC console; e.g.,
859.Xr kbdcontrol 1
860and
861.Xr vidcontrol 1 .
862.It Va WITHOUT_LIB32
863On 64-bit platforms, set to not build 32-bit library set and a
864.Nm ld-elf32.so.1
865runtime linker.
866.Pp
867This is a default setting on
868arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
869.It Va WITHOUT_LIBCPLUSPLUS
870Set to avoid building libcxxrt and libc++.
871.It Va WITHOUT_LIBPTHREAD
872Set to not build the
873.Nm libpthread
874providing library,
875.Nm libthr .
876When set, it enforces these options:
877.Pp
878.Bl -item -compact
879.It
880.Va WITHOUT_LIBTHR
881.El
882.It Va WITH_LIBSOFT
883On armv6 only, set to enable soft float ABI compatibility libraries.
884This option is for transitioning to the new hard float ABI.
885.It Va WITHOUT_LIBTHR
886Set to not build the
887.Nm libthr
888(1:1 threading)
889library.
890.It Va WITHOUT_LLD
891Set to not build LLVM's lld linker.
892.It Va WITHOUT_LLDB
893Set to not build the LLDB debugger.
894.Pp
895This is a default setting on
896arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
897.It Va WITH_LLDB
898Set to build the LLDB debugger.
899.Pp
900This is a default setting on
901amd64/amd64, arm64/aarch64 and i386/i386.
902.It Va WITHOUT_LLD_BOOTSTRAP
903Set to not build the LLD linker during the bootstrap phase of
904the build.
905To be able to build the system, either Binutils or LLD bootstrap must be
906enabled unless an alternate linker is provided via XLD.
907.It Va WITHOUT_LLD_IS_LD
908Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
909.It Va WITHOUT_LLVM_ASSERTIONS
910Set to disable debugging assertions in LLVM.
911.It Va WITHOUT_LLVM_COV
912Set to not build the
913.Xr llvm-cov 1
914tool.
915.It Va WITHOUT_LLVM_TARGET_AARCH64
916Set to not build LLVM target support for AArch64.
917The
918.Va LLVM_TARGET_ALL
919option should be used rather than this in most cases.
920.It Va WITHOUT_LLVM_TARGET_ALL
921Set to only build the required LLVM target support.
922This option is preferred to specific target support options.
923When set, these options are also in effect:
924.Pp
925.Bl -inset -compact
926.It Va WITHOUT_LLVM_TARGET_AARCH64
927(unless
928.Va WITH_LLVM_TARGET_AARCH64
929is set explicitly)
930.It Va WITHOUT_LLVM_TARGET_ARM
931(unless
932.Va WITH_LLVM_TARGET_ARM
933is set explicitly)
934.It Va WITHOUT_LLVM_TARGET_MIPS
935(unless
936.Va WITH_LLVM_TARGET_MIPS
937is set explicitly)
938.It Va WITHOUT_LLVM_TARGET_POWERPC
939(unless
940.Va WITH_LLVM_TARGET_POWERPC
941is set explicitly)
942.It Va WITHOUT_LLVM_TARGET_RISCV
943(unless
944.Va WITH_LLVM_TARGET_RISCV
945is set explicitly)
946.El
947.It Va WITHOUT_LLVM_TARGET_ARM
948Set to not build LLVM target support for ARM.
949The
950.Va LLVM_TARGET_ALL
951option should be used rather than this in most cases.
952.It Va WITH_LLVM_TARGET_BPF
953Set to build LLVM target support for BPF.
954The
955.Va LLVM_TARGET_ALL
956option should be used rather than this in most cases.
957.It Va WITHOUT_LLVM_TARGET_MIPS
958Set to not build LLVM target support for MIPS.
959The
960.Va LLVM_TARGET_ALL
961option should be used rather than this in most cases.
962.It Va WITHOUT_LLVM_TARGET_POWERPC
963Set to not build LLVM target support for PowerPC.
964The
965.Va LLVM_TARGET_ALL
966option should be used rather than this in most cases.
967.It Va WITHOUT_LLVM_TARGET_RISCV
968Set to not build LLVM target support for RISC-V.
969The
970.Va LLVM_TARGET_ALL
971option should be used rather than this in most cases.
972.It Va WITHOUT_LLVM_TARGET_X86
973Set to not build LLVM target support for X86.
974The
975.Va LLVM_TARGET_ALL
976option should be used rather than this in most cases.
977.It Va WITH_LOADER_EFI_SECUREBOOT
978Enable building
979.Xr loader 8
980with support for verification based on certificates obtained from UEFI.
981.Pp
982.It Va WITH_LOADER_FIREWIRE
983Enable firewire support in /boot/loader on x86. This option is a nop
984on all other platforms.
985.It Va WITH_LOADER_FORCE_LE
986Set to force the powerpc boot loader to launch the kernel in little
987endian mode.
988.It Va WITHOUT_LOADER_GELI
989Disable inclusion of GELI crypto support in the boot chain binaries.
990.Pp
991This is a default setting on
992powerpc/powerpc and powerpc/powerpc64.
993.It Va WITH_LOADER_GELI
994Set to build GELI bootloader support.
995.Pp
996This is a default setting on
997amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
998.It Va WITHOUT_LOADER_LUA
999Set to not build LUA bindings for the boot loader.
1000.Pp
1001This is a default setting on
1002powerpc/powerpc and powerpc/powerpc64.
1003.It Va WITH_LOADER_LUA
1004Set to build LUA bindings for the boot loader.
1005.Pp
1006This is a default setting on
1007amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1008.It Va WITHOUT_LOADER_OFW
1009Disable building of openfirmware bootloader components.
1010.Pp
1011This is a default setting on
1012amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1013.It Va WITH_LOADER_OFW
1014Set to build openfirmware bootloader components.
1015.Pp
1016This is a default setting on
1017powerpc/powerpc and powerpc/powerpc64.
1018.It Va WITHOUT_LOADER_UBOOT
1019Disable building of ubldr.
1020.Pp
1021This is a default setting on
1022amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
1023.It Va WITH_LOADER_UBOOT
1024Set to build ubldr.
1025.Pp
1026This is a default setting on
1027arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
1028.It Va WITH_LOADER_VERBOSE
1029Set to build with extra verbose debugging in the loader.
1030May explode already nearly too large loader over the limit.
1031Use with care.
1032
1033.It Va WITH_LOADER_VERIEXEC
1034Enable building
1035.Xr loader 8
1036with support for verification similar to Verified Exec.
1037.Pp
1038Depends on
1039.Va WITH_BEARSSL .
1040When set, these options are also in effect:
1041.Pp
1042.Bl -inset -compact
1043.It Va WITH_LOADER_EFI_SECUREBOOT
1044(unless
1045.Va WITHOUT_LOADER_EFI_SECUREBOOT
1046is set explicitly)
1047.It Va WITH_LOADER_VERIEXEC_VECTX
1048(unless
1049.Va WITHOUT_LOADER_VERIEXEC_VECTX
1050is set explicitly)
1051.El
1052.It Va WITH_LOADER_VERIEXEC_PASS_MANIFEST
1053Enable building
1054.Xr loader 8
1055with support to pass a verified manifest to the kernel.
1056The kernel has to be built with a module to parse the manifest.
1057.Pp
1058Depends on
1059.Va WITH_LOADER_VERIEXEC .
1060.It Va WITHOUT_LOADER_ZFS
1061Set to not build ZFS file system boot loader support.
1062.It Va WITHOUT_LOCALES
1063Set to not build localization files; see
1064.Xr locale 1 .
1065.It Va WITHOUT_LOCATE
1066Set to not build
1067.Xr locate 1
1068and related programs.
1069.It Va WITHOUT_LPR
1070Set to not build
1071.Xr lpr 1
1072and related programs.
1073.It Va WITHOUT_LS_COLORS
1074Set to build
1075.Xr ls 1
1076without support for colors to distinguish file types.
1077.It Va WITHOUT_LZMA_SUPPORT
1078Set to build some programs without optional lzma compression support.
1079.It Va WITHOUT_MAIL
1080Set to not build any mail support (MUA or MTA).
1081When set, it enforces these options:
1082.Pp
1083.Bl -item -compact
1084.It
1085.Va WITHOUT_DMAGENT
1086.It
1087.Va WITHOUT_MAILWRAPPER
1088.It
1089.Va WITHOUT_SENDMAIL
1090.El
1091.It Va WITHOUT_MAILWRAPPER
1092Set to not build the
1093.Xr mailwrapper 8
1094MTA selector.
1095.It Va WITHOUT_MAKE
1096Set to not install
1097.Xr make 1
1098and related support files.
1099.It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1100Set to not execute
1101.Dq Li "make check"
1102in limited sandbox mode.
1103This option should be paired with
1104.Va WITH_INSTALL_AS_USER
1105if executed as an unprivileged user.
1106See
1107.Xr tests 7
1108for more details.
1109.It Va WITH_MALLOC_PRODUCTION
1110Set to disable assertions and statistics gathering in
1111.Xr malloc 3 .
1112It also defaults the A and J runtime options to off.
1113.It Va WITHOUT_MAN
1114Set to not build manual pages.
1115When set, these options are also in effect:
1116.Pp
1117.Bl -inset -compact
1118.It Va WITHOUT_MAN_UTILS
1119(unless
1120.Va WITH_MAN_UTILS
1121is set explicitly)
1122.El
1123.It Va WITHOUT_MANCOMPRESS
1124Set to not to install compressed man pages.
1125Only the uncompressed versions will be installed.
1126.It Va WITHOUT_MAN_UTILS
1127Set to not build utilities for manual pages,
1128.Xr apropos 1 ,
1129.Xr makewhatis 1 ,
1130.Xr man 1 ,
1131.Xr whatis 1 ,
1132.Xr manctl 8 ,
1133and related support files.
1134.It Va WITH_META_MODE
1135Create
1136.Xr make 1
1137meta files when building, which can provide a reliable incremental build when
1138using
1139.Xr filemon 4 .
1140The meta file is created in OBJDIR as
1141.Pa target.meta .
1142These meta files track the command that was executed, its output, and the
1143current directory.
1144The
1145.Xr filemon 4
1146module is required unless
1147.Va NO_FILEMON
1148is defined.
1149When the module is loaded, any files used by the commands executed are
1150tracked as dependencies for the target in its meta file.
1151The target is considered out-of-date and rebuilt if any of these
1152conditions are true compared to the last build:
1153.Bl -bullet -compact
1154.It
1155The command to execute changes.
1156.It
1157The current working directory changes.
1158.It
1159The target's meta file is missing.
1160.It
1161The target's meta file is missing filemon data when filemon is loaded
1162and a previous run did not have it loaded.
1163.It
1164[requires
1165.Xr filemon 4 ]
1166Files read, executed or linked to are newer than the target.
1167.It
1168[requires
1169.Xr filemon 4 ]
1170Files read, written, executed or linked are missing.
1171.El
1172The meta files can also be useful for debugging.
1173.Pp
1174The build hides commands that are executed unless
1175.Va NO_SILENT
1176is defined.
1177Errors cause
1178.Xr make 1
1179to show some of its environment for further debugging.
1180.Pp
1181The build operates as it normally would otherwise.
1182This option originally invoked a different build system but that was renamed
1183to
1184.Va WITH_DIRDEPS_BUILD .
1185.Pp
1186This must be set in the environment, make command line, or
1187.Pa /etc/src-env.conf ,
1188not
1189.Pa /etc/src.conf .
1190.It Va WITHOUT_MLX5TOOL
1191Set to not build
1192.Xr mlx5tool 8
1193.Pp
1194This is a default setting on
1195arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1196.It Va WITH_MLX5TOOL
1197Set to build
1198.Xr mlx5tool 8
1199.Pp
1200This is a default setting on
1201amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1202.It Va WITHOUT_NDIS
1203Set to not build programs and libraries
1204related to NDIS emulation support.
1205.It Va WITHOUT_NETCAT
1206Set to not build
1207.Xr nc 1
1208utility.
1209.It Va WITHOUT_NETGRAPH
1210Set to not build applications to support
1211.Xr netgraph 4 .
1212When set, it enforces these options:
1213.Pp
1214.Bl -item -compact
1215.It
1216.Va WITHOUT_ATM
1217.It
1218.Va WITHOUT_BLUETOOTH
1219.El
1220.Pp
1221When set, these options are also in effect:
1222.Pp
1223.Bl -inset -compact
1224.It Va WITHOUT_NETGRAPH_SUPPORT
1225(unless
1226.Va WITH_NETGRAPH_SUPPORT
1227is set explicitly)
1228.El
1229.It Va WITHOUT_NETGRAPH_SUPPORT
1230Set to build libraries, programs, and kernel modules without netgraph support.
1231.It Va WITHOUT_NIS
1232Set to not build
1233.Xr NIS 8
1234support and related programs.
1235If set, you might need to adopt your
1236.Xr nsswitch.conf 5
1237and remove
1238.Sq nis
1239entries.
1240.It Va WITHOUT_NLS
1241Set to not build NLS catalogs.
1242When set, it enforces these options:
1243.Pp
1244.Bl -item -compact
1245.It
1246.Va WITHOUT_NLS_CATALOGS
1247.El
1248.It Va WITHOUT_NLS_CATALOGS
1249Set to not build NLS catalog support for
1250.Xr csh 1 .
1251.It Va WITHOUT_NS_CACHING
1252Set to disable name caching in the
1253.Pa nsswitch
1254subsystem.
1255The generic caching daemon,
1256.Xr nscd 8 ,
1257will not be built either if this option is set.
1258.It Va WITHOUT_NTP
1259Set to not build
1260.Xr ntpd 8
1261and related programs.
1262.It Va WITHOUT_NVME
1263Set to not build nvme related tools and kernel modules.
1264.Pp
1265This is a default setting on
1266arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1267.It Va WITH_NVME
1268Set to build nvme related tools and kernel modules.
1269
1270.Pp
1271This is a default setting on
1272amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1273.It Va WITH_OFED
1274Set to build the
1275.Dq "OpenFabrics Enterprise Distribution"
1276Infiniband software stack.
1277.It Va WITH_OFED_EXTRA
1278Set to build the non-essential components of the
1279.Dq "OpenFabrics Enterprise Distribution"
1280Infiniband software stack, mostly examples.
1281.It Va WITH_OPENLDAP
1282Enable building openldap support for kerberos.
1283.It Va WITHOUT_OPENMP
1284Set to not build LLVM's OpenMP runtime.
1285.Pp
1286This is a default setting on
1287arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1288.It Va WITH_OPENMP
1289Set to build LLVM's OpenMP runtime.
1290.Pp
1291This is a default setting on
1292amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1293.It Va WITHOUT_OPENSSH
1294Set to not build OpenSSH.
1295.It Va WITHOUT_OPENSSL
1296Set to not build OpenSSL.
1297When set, it enforces these options:
1298.Pp
1299.Bl -item -compact
1300.It
1301.Va WITHOUT_DMAGENT
1302.It
1303.Va WITHOUT_KERBEROS
1304.It
1305.Va WITHOUT_KERBEROS_SUPPORT
1306.It
1307.Va WITHOUT_LDNS
1308.It
1309.Va WITHOUT_LDNS_UTILS
1310.It
1311.Va WITHOUT_OPENSSH
1312.It
1313.Va WITHOUT_PKGBOOTSTRAP
1314.It
1315.Va WITHOUT_SVN
1316.It
1317.Va WITHOUT_SVNLITE
1318.It
1319.Va WITHOUT_UNBOUND
1320.It
1321.Va WITHOUT_WIRELESS
1322.El
1323.Pp
1324When set, these options are also in effect:
1325.Pp
1326.Bl -inset -compact
1327.It Va WITHOUT_GSSAPI
1328(unless
1329.Va WITH_GSSAPI
1330is set explicitly)
1331.El
1332.It Va WITHOUT_PAM
1333Set to not build PAM library and modules.
1334.Bf -symbolic
1335This option is deprecated and does nothing.
1336.Ef
1337When set, these options are also in effect:
1338.Pp
1339.Bl -inset -compact
1340.It Va WITHOUT_PAM_SUPPORT
1341(unless
1342.Va WITH_PAM_SUPPORT
1343is set explicitly)
1344.El
1345.It Va WITHOUT_PAM_SUPPORT
1346Set to build some programs without PAM support, particularly
1347.Xr ftpd 8
1348and
1349.Xr ppp 8 .
1350.It Va WITHOUT_PF
1351Set to not build PF firewall package.
1352When set, it enforces these options:
1353.Pp
1354.Bl -item -compact
1355.It
1356.Va WITHOUT_AUTHPF
1357.El
1358.It Va WITH_PIE
1359Build dynamically linked binaries as
1360Position-Independent Executable (PIE).
1361.It Va WITHOUT_PKGBOOTSTRAP
1362Set to not build
1363.Xr pkg 7
1364bootstrap tool.
1365.It Va WITHOUT_PMC
1366Set to not build
1367.Xr pmccontrol 8
1368and related programs.
1369.It Va WITHOUT_PORTSNAP
1370Set to not build or install
1371.Xr portsnap 8
1372and related files.
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