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