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