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