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