xref: /freebsd/share/man/man5/src.conf.5 (revision 64a0982bee3db2236df43357e70ce8dddbc21d48)
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 3, 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_MANDOCDB
1173.\" from FreeBSD: head/tools/build/options/WITHOUT_MANDOCDB 306966 2016-10-10 15:40:08Z emaste
1174Use the version of
1175.Xr makewhatis 1
1176introduced in
1177.Fx 2.1 ,
1178instead of the
1179.Xr makewhatis 8
1180database and utilities from
1181.Xr mandoc 1 .
1182.It Va WITHOUT_MAN_UTILS
1183.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
1184Set to not build utilities for manual pages,
1185.Xr apropos 1 ,
1186.Xr catman 1 ,
1187.Xr makewhatis 1 ,
1188.Xr man 1 ,
1189.Xr whatis 1 ,
1190.Xr manctl 8 ,
1191and related support files.
1192.It Va WITH_META_MODE
1193.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 313169 2017-02-03 19:09:46Z wblock
1194Create
1195.Xr make 1
1196meta files when building, which can provide a reliable incremental build when
1197using
1198.Xr filemon 4 .
1199The meta file is created in OBJDIR as
1200.Pa target.meta .
1201These meta files track the command that was executed, its output, and the
1202current directory.
1203The
1204.Xr filemon 4
1205module is required unless
1206.Va NO_FILEMON
1207is defined.
1208When the module is loaded, any files used by the commands executed are
1209tracked as dependencies for the target in its meta file.
1210The target is considered out-of-date and rebuilt if any of these
1211conditions are true compared to the last build:
1212.Bl -bullet -compact
1213.It
1214The command to execute changes.
1215.It
1216The current working directory changes.
1217.It
1218The target's meta file is missing.
1219.It
1220The target's meta file is missing filemon data when filemon is loaded
1221and a previous run did not have it loaded.
1222.It
1223[requires
1224.Xr filemon 4 ]
1225Files read, executed or linked to are newer than the target.
1226.It
1227[requires
1228.Xr filemon 4 ]
1229Files read, written, executed or linked are missing.
1230.El
1231The meta files can also be useful for debugging.
1232.Pp
1233The build hides commands that are executed unless
1234.Va NO_SILENT
1235is defined.
1236Errors cause
1237.Xr make 1
1238to show some of its environment for further debugging.
1239.Pp
1240The build operates as it normally would otherwise.
1241This option originally invoked a different build system but that was renamed
1242to
1243.Va WITH_DIRDEPS_BUILD .
1244.Pp
1245This must be set in the environment, make command line, or
1246.Pa /etc/src-env.conf ,
1247not
1248.Pa /etc/src.conf .
1249.It Va WITH_NAND
1250.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
1251Set to build the NAND Flash components.
1252.It Va WITHOUT_NDIS
1253.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
1254Set to not build programs and libraries
1255related to NDIS emulation support.
1256.It Va WITHOUT_NETCAT
1257.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
1258Set to not build
1259.Xr nc 1
1260utility.
1261.It Va WITHOUT_NETGRAPH
1262.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
1263Set to not build applications to support
1264.Xr netgraph 4 .
1265When set, it enforces these options:
1266.Pp
1267.Bl -item -compact
1268.It
1269.Va WITHOUT_ATM
1270.It
1271.Va WITHOUT_BLUETOOTH
1272.It
1273.Va WITHOUT_NETGRAPH_SUPPORT
1274.El
1275.It Va WITHOUT_NETGRAPH_SUPPORT
1276.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
1277Set to build libraries, programs, and kernel modules without netgraph support.
1278.It Va WITHOUT_NIS
1279.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
1280Set to not build
1281.Xr NIS 8
1282support and related programs.
1283If set, you might need to adopt your
1284.Xr nsswitch.conf 5
1285and remove
1286.Sq nis
1287entries.
1288.It Va WITHOUT_NLS
1289.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
1290Set to not build NLS catalogs.
1291.It Va WITHOUT_NLS_CATALOGS
1292.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
1293Set to not build NLS catalog support for
1294.Xr csh 1 .
1295.It Va WITHOUT_NS_CACHING
1296.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
1297Set to disable name caching in the
1298.Pa nsswitch
1299subsystem.
1300The generic caching daemon,
1301.Xr nscd 8 ,
1302will not be built either if this option is set.
1303.It Va WITHOUT_NTP
1304.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
1305Set to not build
1306.Xr ntpd 8
1307and related programs.
1308.It Va WITH_OFED
1309.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
1310Set to build the
1311.Dq "OpenFabrics Enterprise Distribution"
1312Infiniband software stack.
1313.It Va WITH_OPENLDAP
1314.\" from FreeBSD: head/tools/build/options/WITH_OPENLDAP 264902 2014-04-24 23:17:31Z imp
1315Enable building openldap support for kerberos.
1316.It Va WITHOUT_OPENSSH
1317.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
1318Set to not build OpenSSH.
1319.It Va WITHOUT_OPENSSL
1320.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
1321Set to not build OpenSSL.
1322When set, it enforces these options:
1323.Pp
1324.Bl -item -compact
1325.It
1326.Va WITHOUT_KERBEROS
1327.It
1328.Va WITHOUT_KERBEROS_SUPPORT
1329.It
1330.Va WITHOUT_OPENSSH
1331.El
1332.Pp
1333When set, these options are also in effect:
1334.Pp
1335.Bl -inset -compact
1336.It Va WITHOUT_GSSAPI
1337(unless
1338.Va WITH_GSSAPI
1339is set explicitly)
1340.El
1341.It Va WITHOUT_PAM
1342.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
1343Set to not build PAM library and modules.
1344.Bf -symbolic
1345This option is deprecated and does nothing.
1346.Ef
1347When set, it enforces these options:
1348.Pp
1349.Bl -item -compact
1350.It
1351.Va WITHOUT_PAM_SUPPORT
1352.El
1353.It Va WITHOUT_PAM_SUPPORT
1354.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
1355Set to build some programs without PAM support, particularly
1356.Xr ftpd 8
1357and
1358.Xr ppp 8 .
1359.It Va WITHOUT_PC_SYSINSTALL
1360.\" from FreeBSD: head/tools/build/options/WITHOUT_PC_SYSINSTALL 245606 2013-01-18 15:57:09Z eadler
1361Set to not build
1362.Xr pc-sysinstall 8
1363and related programs.
1364.It Va WITHOUT_PF
1365.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
1366Set to not build PF firewall package.
1367When set, it enforces these options:
1368.Pp
1369.Bl -item -compact
1370.It
1371.Va WITHOUT_AUTHPF
1372.El
1373.It Va WITHOUT_PKGBOOTSTRAP
1374.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 258924 2013-12-04 15:58:42Z bdrewery
1375Set to not build
1376.Xr pkg 7
1377bootstrap tool.
1378.It Va WITHOUT_PMC
1379.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
1380Set to not build
1381.Xr pmccontrol 8
1382and related programs.
1383.It Va WITHOUT_PORTSNAP
1384.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
1385Set to not build or install
1386.Xr portsnap 8
1387and related files.
1388.It Va WITHOUT_PPP
1389.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
1390Set to not build
1391.Xr ppp 8
1392and related programs.
1393.It Va WITHOUT_PROFILE
1394.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
1395Set to avoid compiling profiled libraries.
1396.It Va WITHOUT_QUOTAS
1397.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 296264 2016-03-01 11:36:10Z trasz
1398Set to not build
1399.Xr quota 1
1400and related programs.
1401.It Va WITHOUT_RADIUS_SUPPORT
1402.\" from FreeBSD: head/tools/build/options/WITHOUT_RADIUS_SUPPORT 278182 2015-02-04 06:53:45Z ngie
1403Set to not build radius support into various applications, like
1404.Xr pam_radius 8
1405and
1406.Xr ppp 8 .
1407.It Va WITHOUT_RBOOTD
1408.\" from FreeBSD: head/tools/build/options/WITHOUT_RBOOTD 278192 2015-02-04 10:19:32Z ngie
1409Set to not build or install
1410.Xr rbootd 8 .
1411.It Va WITHOUT_RCMDS
1412.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
1413Disable building of the
1414.Bx
1415r-commands.
1416This includes
1417.Xr rlogin 1 ,
1418.Xr rsh 1 ,
1419etc.
1420.It Va WITH_REPRODUCIBLE_BUILD
1421.\" from FreeBSD: head/tools/build/options/WITH_REPRODUCIBLE_BUILD 310271 2016-12-19 15:09:30Z gjb
1422Set to exclude build metadata (such as the build time, user, or host)
1423from the kernel, boot loaders, and uname output, so that builds produce
1424bit-for-bit identical output.
1425.It Va WITHOUT_RESCUE
1426.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
1427Set to not build
1428.Xr rescue 8 .
1429.It Va WITHOUT_ROUTED
1430.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
1431Set to not build
1432.Xr routed 8
1433utility.
1434.It Va WITHOUT_SENDMAIL
1435.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
1436Set to not build
1437.Xr sendmail 8
1438and related programs.
1439.It Va WITHOUT_SETUID_LOGIN
1440.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
1441Set this to disable the installation of
1442.Xr login 1
1443as a set-user-ID root program.
1444.It Va WITHOUT_SHAREDOCS
1445.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
1446Set to not build the
1447.Bx 4.4
1448legacy docs.
1449.It Va WITH_SHARED_TOOLCHAIN
1450.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
1451Set to build the toolchain binaries shared.
1452The set includes
1453.Xr cc 1 ,
1454.Xr make 1
1455and necessary utilities like assembler, linker and library archive manager.
1456.It Va WITH_SORT_THREADS
1457.\" from FreeBSD: head/tools/build/options/WITH_SORT_THREADS 264158 2014-04-05 18:00:45Z imp
1458Set to enable threads in
1459.Xr sort 1 .
1460.It Va WITHOUT_SOURCELESS
1461.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
1462Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1463When set, it enforces these options:
1464.Pp
1465.Bl -item -compact
1466.It
1467.Va WITHOUT_SOURCELESS_HOST
1468.It
1469.Va WITHOUT_SOURCELESS_UCODE
1470.El
1471.It Va WITHOUT_SOURCELESS_HOST
1472.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
1473Set to not build kernel modules that include sourceless native code for host CPU.
1474.It Va WITHOUT_SOURCELESS_UCODE
1475.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
1476Set to not build kernel modules that include sourceless microcode.
1477.It Va WITHOUT_SSP
1478.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
1479Set to not build world with propolice stack smashing protection.
1480.Pp
1481This is a default setting on
1482mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf and mips/mips64hf.
1483.It Va WITH_SSP
1484.\" from FreeBSD: head/tools/build/options/WITH_SSP 311136 2017-01-02 20:09:09Z ngie
1485Set to build world with propolice stack smashing protection.
1486.Pp
1487This is a default setting on
1488amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1489.It Va WITH_STAGING
1490.\" from FreeBSD: head/tools/build/options/WITH_STAGING 290816 2015-11-14 03:24:48Z sjg
1491Enable staging of files to a stage tree.
1492This can be best thought of as auto-install to
1493.Va DESTDIR
1494with some extra meta data to ensure dependencies can be tracked.
1495Depends on
1496.Va WITH_DIRDEPS_BUILD .
1497When set, these options are also in effect:
1498.Pp
1499.Bl -inset -compact
1500.It Va WITH_STAGING_MAN
1501(unless
1502.Va WITHOUT_STAGING_MAN
1503is set explicitly)
1504.It Va WITH_STAGING_PROG
1505(unless
1506.Va WITHOUT_STAGING_PROG
1507is set explicitly)
1508.El
1509.Pp
1510This must be set in the environment, make command line, or
1511.Pa /etc/src-env.conf ,
1512not
1513.Pa /etc/src.conf .
1514.It Va WITH_STAGING_MAN
1515.\" from FreeBSD: head/tools/build/options/WITH_STAGING_MAN 313169 2017-02-03 19:09:46Z wblock
1516Enable staging of man pages to stage tree.
1517.It Va WITH_STAGING_PROG
1518.\" from FreeBSD: head/tools/build/options/WITH_STAGING_PROG 284708 2015-06-22 20:21:57Z sjg
1519Enable staging of PROGs to stage tree.
1520.It Va WITH_STALE_STAGED
1521.\" from FreeBSD: head/tools/build/options/WITH_STALE_STAGED 284708 2015-06-22 20:21:57Z sjg
1522Check staged files are not stale.
1523.It Va WITH_SVN
1524.\" from FreeBSD: head/tools/build/options/WITH_SVN 252561 2013-07-03 12:36:47Z zeising
1525Set to install
1526.Xr svnlite 1
1527as
1528.Xr svn 1 .
1529.It Va WITHOUT_SVNLITE
1530.\" from FreeBSD: head/tools/build/options/WITHOUT_SVNLITE 252561 2013-07-03 12:36:47Z zeising
1531Set to not build
1532.Xr svnlite 1
1533and related programs.
1534.It Va WITHOUT_SYMVER
1535.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
1536Set to disable symbol versioning when building shared libraries.
1537.It Va WITHOUT_SYSCONS
1538.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
1539Set to not build
1540.Xr syscons 4
1541support files such as keyboard maps, fonts, and screen output maps.
1542.It Va WITH_SYSROOT
1543.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 290816 2015-11-14 03:24:48Z sjg
1544Enable use of sysroot during build.
1545Depends on
1546.Va WITH_DIRDEPS_BUILD .
1547.Pp
1548This must be set in the environment, make command line, or
1549.Pa /etc/src-env.conf ,
1550not
1551.Pa /etc/src.conf .
1552.It Va WITHOUT_SYSTEM_COMPILER
1553.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSTEM_COMPILER 300354 2016-05-21 01:32:23Z bdrewery
1554Set to not opportunistically skip building a cross-compiler during the
1555bootstrap phase of the build.
1556Normally, if the currently installed compiler matches the planned bootstrap
1557compiler type and revision, then it will not be built.
1558This does not prevent a compiler from being built for installation though,
1559only for building one for the build itself.
1560The
1561.Va WITHOUT_CLANG
1562and
1563.Va WITHOUT_GCC
1564options control those.
1565.Pp
1566This is a default setting on
1567arm64/aarch64.
1568.It Va WITH_SYSTEM_COMPILER
1569.\" from FreeBSD: head/tools/build/options/WITH_SYSTEM_COMPILER 300354 2016-05-21 01:32:23Z bdrewery
1570Set to opportunistically skip building a cross-compiler during the
1571bootstrap phase of the build.
1572If the currently installed compiler matches the planned bootstrap compiler
1573type and revision, then it will not be built.
1574This does not prevent a compiler from being built for installation though,
1575only for building one for the build itself.
1576The
1577.Va WITHOUT_CLANG
1578and
1579.Va WITHOUT_GCC
1580options control those.
1581.Pp
1582This is a default setting on
1583amd64/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.
1584.It Va WITHOUT_TALK
1585.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie
1586Set to not build or install
1587.Xr talk 1
1588and
1589.Xr talkd 8 .
1590.It Va WITHOUT_TCP_WRAPPERS
1591.\" from FreeBSD: head/tools/build/options/WITHOUT_TCP_WRAPPERS 278192 2015-02-04 10:19:32Z ngie
1592Set to not build or install
1593.Xr tcpd 8 ,
1594and related utilities.
1595.It Va WITHOUT_TCSH
1596.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
1597Set to not build and install
1598.Pa /bin/csh
1599(which is
1600.Xr tcsh 1 ) .
1601.It Va WITHOUT_TELNET
1602.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 296264 2016-03-01 11:36:10Z trasz
1603Set to not build
1604.Xr telnet 1
1605and related programs.
1606.It Va WITHOUT_TESTS
1607.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS 268778 2014-07-16 21:40:11Z jmmv
1608Set to not build nor install the
1609.Fx
1610Test Suite in
1611.Pa /usr/tests/ .
1612See
1613.Xr tests 7
1614for more details.
1615This also disables the build of all test-related dependencies, including ATF.
1616When set, it enforces these options:
1617.Pp
1618.Bl -item -compact
1619.It
1620.Va WITHOUT_DTRACE_TESTS
1621.It
1622.Va WITHOUT_TESTS_SUPPORT
1623.El
1624.It Va WITHOUT_TESTS_SUPPORT
1625.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS_SUPPORT 274665 2014-11-18 17:06:50Z imp
1626Set to disables the build of all test-related dependencies, including ATF.
1627.It Va WITHOUT_TEXTPROC
1628.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
1629Set to not build
1630programs used for text processing.
1631When set, it enforces these options:
1632.Pp
1633.Bl -item -compact
1634.It
1635.Va WITHOUT_GROFF
1636.El
1637.It Va WITHOUT_TFTP
1638.\" from FreeBSD: head/tools/build/options/WITHOUT_TFTP 278192 2015-02-04 10:19:32Z ngie
1639Set to not build or install
1640.Xr tftp 1
1641and
1642.Xr tftpd 8 .
1643.It Va WITHOUT_TIMED
1644.\" from FreeBSD: head/tools/build/options/WITHOUT_TIMED 278192 2015-02-04 10:19:32Z ngie
1645Set to not build or install
1646.Xr timed 8 .
1647.It Va WITHOUT_TOOLCHAIN
1648.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 297939 2016-04-13 20:55:05Z bdrewery
1649Set to not install header or
1650programs used for program development,
1651compilers, debuggers etc.
1652When set, it enforces these options:
1653.Pp
1654.Bl -item -compact
1655.It
1656.Va WITHOUT_BINUTILS
1657.It
1658.Va WITHOUT_CLANG
1659.It
1660.Va WITHOUT_CLANG_EXTRAS
1661.It
1662.Va WITHOUT_CLANG_FULL
1663.It
1664.Va WITHOUT_GCC
1665.It
1666.Va WITHOUT_GDB
1667.It
1668.Va WITHOUT_INCLUDES
1669.It
1670.Va WITHOUT_LLDB
1671.El
1672.It Va WITHOUT_UNBOUND
1673.\" from FreeBSD: head/tools/build/options/WITHOUT_UNBOUND 255597 2013-09-15 14:51:23Z des
1674Set to not build
1675.Xr unbound 8
1676and related programs.
1677.It Va WITHOUT_USB
1678.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1679Set to not build USB-related programs and libraries.
1680.It Va WITHOUT_USB_GADGET_EXAMPLES
1681.\" from FreeBSD: head/tools/build/options/WITHOUT_USB_GADGET_EXAMPLES 311548 2017-01-06 21:08:19Z ngie
1682Set to not build USB gadget kernel modules.
1683.It Va WITHOUT_UTMPX
1684.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1685Set to not build user accounting tools such as
1686.Xr last 1 ,
1687.Xr users 1 ,
1688.Xr who 1 ,
1689.Xr ac 8 ,
1690.Xr lastlogin 8
1691and
1692.Xr utx 8 .
1693.It Va WITHOUT_VI
1694.\" from FreeBSD: head/tools/build/options/WITHOUT_VI 264903 2014-04-24 23:17:40Z imp
1695Set to not build and install vi, view, ex and related programs.
1696.It Va WITHOUT_VT
1697.\" from FreeBSD: head/tools/build/options/WITHOUT_VT 268022 2014-06-30 00:20:12Z emaste
1698Set to not build
1699.Xr vt 4
1700support files (fonts and keymaps).
1701.It Va WITHOUT_WARNS
1702.\" from FreeBSD: head/tools/build/options/WITHOUT_WARNS 276559 2015-01-02 18:57:58Z bapt
1703Set this to not add warning flags to the compiler invocations.
1704Useful as a temporary workaround when code enters the tree
1705which triggers warnings in environments that differ from the
1706original developer.
1707.It Va WITHOUT_WIRELESS
1708.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1709Set to not build programs used for 802.11 wireless networks; especially
1710.Xr wpa_supplicant 8
1711and
1712.Xr hostapd 8 .
1713When set, it enforces these options:
1714.Pp
1715.Bl -item -compact
1716.It
1717.Va WITHOUT_WIRELESS_SUPPORT
1718.El
1719.It Va WITHOUT_WIRELESS_SUPPORT
1720.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1721Set to build libraries, programs, and kernel modules without
1722802.11 wireless support.
1723.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1724.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1725Build
1726.Xr wpa_supplicant 8
1727without support for the IEEE 802.1X protocol and without
1728support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1729protocols (usable only via 802.1X).
1730.It Va WITHOUT_ZFS
1731.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1732Set to not build ZFS file system.
1733.It Va WITHOUT_ZONEINFO
1734.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1735Set to not build the timezone database.
1736.El
1737.Sh FILES
1738.Bl -tag -compact -width Pa
1739.It Pa /etc/src.conf
1740.It Pa /etc/src-env.conf
1741.It Pa /usr/share/mk/bsd.own.mk
1742.El
1743.Sh SEE ALSO
1744.Xr make 1 ,
1745.Xr make.conf 5 ,
1746.Xr build 7 ,
1747.Xr ports 7
1748.Sh HISTORY
1749The
1750.Nm
1751file appeared in
1752.Fx 7.0 .
1753.Sh AUTHORS
1754This manual page was autogenerated.
1755