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