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