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