xref: /freebsd/share/man/man5/src.conf.5 (revision 4ca50eab86aec8001978a612a42f9ae8388eceab)
1.\" DO NOT EDIT-- this file is automatically generated.
2.\" from FreeBSD: head/tools/build/options/makeman 315768 2017-03-23 02:26:15Z ngie
3.\" $FreeBSD$
4.Dd April 10, 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_IPSEC_SUPPORT
932.\" from FreeBSD: head/tools/build/options/WITHOUT_IPSEC_SUPPORT 315765 2017-03-23 02:13:59Z ngie
933Set to not build the kernel with
934.Xr ipsec 4
935support.
936This option is needed for
937.Xr ipsec 4
938and
939.Xr tcpmd5 4 .
940.It Va WITHOUT_ISCSI
941.\" from FreeBSD: head/tools/build/options/WITHOUT_ISCSI 277675 2015-01-25 04:20:11Z ngie
942Set to not build
943.Xr iscid 8
944and related utilities.
945.It Va WITHOUT_JAIL
946.\" from FreeBSD: head/tools/build/options/WITHOUT_JAIL 249966 2013-04-27 04:09:09Z eadler
947Set to not build tools for the support of jails; e.g.,
948.Xr jail 8 .
949.It Va WITHOUT_KDUMP
950.\" from FreeBSD: head/tools/build/options/WITHOUT_KDUMP 240690 2012-09-19 11:38:37Z zeising
951Set to not build
952.Xr kdump 1
953and
954.Xr truss 1 .
955.It Va WITHOUT_KERBEROS
956.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 313169 2017-02-03 19:09:46Z wblock
957Set this to not build Kerberos 5 (KTH Heimdal).
958When set, it enforces these options:
959.Pp
960.Bl -item -compact
961.It
962.Va WITHOUT_KERBEROS_SUPPORT
963.El
964.Pp
965When set, these options are also in effect:
966.Pp
967.Bl -inset -compact
968.It Va WITHOUT_GSSAPI
969(unless
970.Va WITH_GSSAPI
971is set explicitly)
972.El
973.It Va WITHOUT_KERBEROS_SUPPORT
974.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 251794 2013-06-15 20:29:07Z eadler
975Set to build some programs without Kerberos support, like
976.Xr ssh 1 ,
977.Xr telnet 1 ,
978.Xr sshd 8 ,
979and
980.Xr telnetd 8 .
981.It Va WITHOUT_KERNEL_SYMBOLS
982.\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
983Set to not install kernel symbol files.
984.Bf -symbolic
985This option is recommended for those people who have small root partitions.
986.Ef
987.It Va WITHOUT_KVM
988.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
989Set to not build the
990.Nm libkvm
991library as a part of the base system.
992.Bf -symbolic
993The option has no effect yet.
994.Ef
995When set, it enforces these options:
996.Pp
997.Bl -item -compact
998.It
999.Va WITHOUT_KVM_SUPPORT
1000.El
1001.It Va WITHOUT_KVM_SUPPORT
1002.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
1003Set to build some programs without optional
1004.Nm libkvm
1005support.
1006.It Va WITHOUT_LDNS
1007.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS 255591 2013-09-15 13:11:13Z des
1008Setting this variable will prevent the LDNS library from being built.
1009When set, it enforces these options:
1010.Pp
1011.Bl -item -compact
1012.It
1013.Va WITHOUT_LDNS_UTILS
1014.It
1015.Va WITHOUT_UNBOUND
1016.El
1017.It Va WITHOUT_LDNS_UTILS
1018.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS_UTILS 255850 2013-09-24 14:33:31Z des
1019Setting this variable will prevent building the LDNS utilities
1020.Xr drill 1
1021and
1022.Xr host 1 .
1023.It Va WITHOUT_LEGACY_CONSOLE
1024.\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 296264 2016-03-01 11:36:10Z trasz
1025Set to not build programs that support a legacy PC console; e.g.,
1026.Xr kbdcontrol 1
1027and
1028.Xr vidcontrol 1 .
1029.It Va WITHOUT_LIB32
1030.\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 274664 2014-11-18 17:06:48Z imp
1031On 64-bit platforms, set to not build 32-bit library set and a
1032.Nm ld-elf32.so.1
1033runtime linker.
1034.It Va WITHOUT_LIBCPLUSPLUS
1035.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBCPLUSPLUS 246262 2013-02-02 22:42:46Z dim
1036Set to avoid building libcxxrt and libc++.
1037.It Va WITHOUT_LIBPTHREAD
1038.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
1039Set to not build the
1040.Nm libpthread
1041providing library,
1042.Nm libthr .
1043When set, it enforces these options:
1044.Pp
1045.Bl -item -compact
1046.It
1047.Va WITHOUT_LIBTHR
1048.El
1049.It Va WITH_LIBSOFT
1050.\" from FreeBSD: head/tools/build/options/WITH_LIBSOFT 300325 2016-05-20 19:23:07Z bdrewery
1051On armv6 only, set to enable soft float ABI compatibility libraries.
1052This option is for transitioning to the new hard float ABI.
1053.It Va WITHOUT_LIBTHR
1054.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
1055Set to not build the
1056.Nm libthr
1057(1:1 threading)
1058library.
1059.It Va WITHOUT_LLD
1060.\" from FreeBSD: head/tools/build/options/WITHOUT_LLD 309124 2016-11-24 22:54:55Z dim
1061Set to not build LLVM's lld linker.
1062.Pp
1063This is a default setting on
1064mips/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.
1065When set, it enforces these options:
1066.Pp
1067.Bl -item -compact
1068.It
1069.Va WITHOUT_LLD_IS_LD
1070.El
1071.It Va WITH_LLD
1072.\" from FreeBSD: head/tools/build/options/WITH_LLD 309124 2016-11-24 22:54:55Z dim
1073Set to build LLVM's lld linker.
1074.Pp
1075This is a default setting on
1076amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64 and i386/i386.
1077.It Va WITHOUT_LLDB
1078.\" from FreeBSD: head/tools/build/options/WITHOUT_LLDB 289275 2015-10-14 00:23:31Z emaste
1079Set to not build the LLDB debugger.
1080.Pp
1081This is a default setting on
1082arm/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.
1083.It Va WITH_LLDB
1084.\" from FreeBSD: head/tools/build/options/WITH_LLDB 255722 2013-09-20 01:52:02Z emaste
1085Set to build the LLDB debugger.
1086.Pp
1087This is a default setting on
1088amd64/amd64 and arm64/aarch64.
1089.It Va WITHOUT_LLD_BOOTSTRAP
1090.\" from FreeBSD: head/tools/build/options/WITHOUT_LLD_BOOTSTRAP 316647 2017-04-09 01:35:19Z emaste
1091Set to not build the LLD linker during the bootstrap phase of
1092the build.
1093To be able to build the system, either Binutils or LLD bootstrap must be
1094enabled unless an alternate linker is provided via XLD.
1095.Pp
1096This is a default setting on
1097amd64/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.
1098.It Va WITH_LLD_BOOTSTRAP
1099.\" from FreeBSD: head/tools/build/options/WITH_LLD_BOOTSTRAP 316647 2017-04-09 01:35:19Z emaste
1100Set to build the LLD linker during the bootstrap phase of the build.
1101.Pp
1102This is a default setting on
1103arm64/aarch64.
1104.It Va WITHOUT_LLD_IS_LD
1105.\" from FreeBSD: head/tools/build/options/WITHOUT_LLD_IS_LD 312855 2017-01-27 01:59:12Z emaste
1106Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
1107.Pp
1108This is a default setting on
1109amd64/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.
1110.It Va WITH_LLD_IS_LD
1111.\" from FreeBSD: head/tools/build/options/WITH_LLD_IS_LD 312855 2017-01-27 01:59:12Z emaste
1112Set to use LLVM's LLD as the system linker, instead of GNU binutils ld.
1113.Pp
1114This is a default setting on
1115arm64/aarch64.
1116When set, these options are also in effect:
1117.Pp
1118.Bl -inset -compact
1119.It Va WITHOUT_SYSTEM_COMPILER
1120(unless
1121.Va WITH_SYSTEM_COMPILER
1122is set explicitly)
1123.El
1124.It Va WITHOUT_LLVM_LIBUNWIND
1125.\" from FreeBSD: head/tools/build/options/WITHOUT_LLVM_LIBUNWIND 293450 2016-01-09 00:42:07Z emaste
1126Set to use GCC's stack unwinder (instead of LLVM's libunwind).
1127.Pp
1128This is a default setting on
1129arm/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.
1130.It Va WITH_LLVM_LIBUNWIND
1131.\" from FreeBSD: head/tools/build/options/WITH_LLVM_LIBUNWIND 293450 2016-01-09 00:42:07Z emaste
1132Set to use LLVM's libunwind stack unwinder (instead of GCC's unwinder).
1133.Pp
1134This is a default setting on
1135amd64/amd64, arm64/aarch64 and i386/i386.
1136.It Va WITHOUT_LOCALES
1137.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
1138Set to not build localization files; see
1139.Xr locale 1 .
1140.It Va WITHOUT_LOCATE
1141.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
1142Set to not build
1143.Xr locate 1
1144and related programs.
1145.It Va WITHOUT_LPR
1146.\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
1147Set to not build
1148.Xr lpr 1
1149and related programs.
1150.It Va WITHOUT_LS_COLORS
1151.\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
1152Set to build
1153.Xr ls 1
1154without support for colors to distinguish file types.
1155.It Va WITHOUT_LZMA_SUPPORT
1156.\" from FreeBSD: head/tools/build/options/WITHOUT_LZMA_SUPPORT 245171 2013-01-08 18:37:12Z obrien
1157Set to build some programs without optional lzma compression support.
1158.It Va WITHOUT_MAIL
1159.\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
1160Set to not build any mail support (MUA or MTA).
1161When set, it enforces these options:
1162.Pp
1163.Bl -item -compact
1164.It
1165.Va WITHOUT_DMAGENT
1166.It
1167.Va WITHOUT_MAILWRAPPER
1168.It
1169.Va WITHOUT_SENDMAIL
1170.El
1171.It Va WITHOUT_MAILWRAPPER
1172.\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
1173Set to not build the
1174.Xr mailwrapper 8
1175MTA selector.
1176.It Va WITHOUT_MAKE
1177.\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
1178Set to not install
1179.Xr make 1
1180and related support files.
1181.It Va WITHOUT_MAN
1182.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
1183Set to not build manual pages.
1184When set, these options are also in effect:
1185.Pp
1186.Bl -inset -compact
1187.It Va WITHOUT_MAN_UTILS
1188(unless
1189.Va WITH_MAN_UTILS
1190is set explicitly)
1191.El
1192.It Va WITHOUT_MANCOMPRESS
1193.\" from FreeBSD: head/tools/build/options/WITHOUT_MANCOMPRESS 266752 2014-05-27 15:52:27Z gjb
1194Set to not to install compressed man pages.
1195Only the uncompressed versions will be installed.
1196.It Va WITHOUT_MAN_UTILS
1197.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
1198Set to not build utilities for manual pages,
1199.Xr apropos 1 ,
1200.Xr catman 1 ,
1201.Xr makewhatis 1 ,
1202.Xr man 1 ,
1203.Xr whatis 1 ,
1204.Xr manctl 8 ,
1205and related support files.
1206.It Va WITH_META_MODE
1207.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 313169 2017-02-03 19:09:46Z wblock
1208Create
1209.Xr make 1
1210meta files when building, which can provide a reliable incremental build when
1211using
1212.Xr filemon 4 .
1213The meta file is created in OBJDIR as
1214.Pa target.meta .
1215These meta files track the command that was executed, its output, and the
1216current directory.
1217The
1218.Xr filemon 4
1219module is required unless
1220.Va NO_FILEMON
1221is defined.
1222When the module is loaded, any files used by the commands executed are
1223tracked as dependencies for the target in its meta file.
1224The target is considered out-of-date and rebuilt if any of these
1225conditions are true compared to the last build:
1226.Bl -bullet -compact
1227.It
1228The command to execute changes.
1229.It
1230The current working directory changes.
1231.It
1232The target's meta file is missing.
1233.It
1234The target's meta file is missing filemon data when filemon is loaded
1235and a previous run did not have it loaded.
1236.It
1237[requires
1238.Xr filemon 4 ]
1239Files read, executed or linked to are newer than the target.
1240.It
1241[requires
1242.Xr filemon 4 ]
1243Files read, written, executed or linked are missing.
1244.El
1245The meta files can also be useful for debugging.
1246.Pp
1247The build hides commands that are executed unless
1248.Va NO_SILENT
1249is defined.
1250Errors cause
1251.Xr make 1
1252to show some of its environment for further debugging.
1253.Pp
1254The build operates as it normally would otherwise.
1255This option originally invoked a different build system but that was renamed
1256to
1257.Va WITH_DIRDEPS_BUILD .
1258.Pp
1259This must be set in the environment, make command line, or
1260.Pa /etc/src-env.conf ,
1261not
1262.Pa /etc/src.conf .
1263.It Va WITH_NAND
1264.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
1265Set to build the NAND Flash components.
1266.It Va WITHOUT_NDIS
1267.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
1268Set to not build programs and libraries
1269related to NDIS emulation support.
1270.It Va WITHOUT_NETCAT
1271.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
1272Set to not build
1273.Xr nc 1
1274utility.
1275.It Va WITHOUT_NETGRAPH
1276.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
1277Set to not build applications to support
1278.Xr netgraph 4 .
1279When set, it enforces these options:
1280.Pp
1281.Bl -item -compact
1282.It
1283.Va WITHOUT_ATM
1284.It
1285.Va WITHOUT_BLUETOOTH
1286.It
1287.Va WITHOUT_NETGRAPH_SUPPORT
1288.El
1289.It Va WITHOUT_NETGRAPH_SUPPORT
1290.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
1291Set to build libraries, programs, and kernel modules without netgraph support.
1292.It Va WITHOUT_NIS
1293.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
1294Set to not build
1295.Xr NIS 8
1296support and related programs.
1297If set, you might need to adopt your
1298.Xr nsswitch.conf 5
1299and remove
1300.Sq nis
1301entries.
1302.It Va WITHOUT_NLS
1303.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
1304Set to not build NLS catalogs.
1305.It Va WITHOUT_NLS_CATALOGS
1306.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
1307Set to not build NLS catalog support for
1308.Xr csh 1 .
1309.It Va WITHOUT_NS_CACHING
1310.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
1311Set to disable name caching in the
1312.Pa nsswitch
1313subsystem.
1314The generic caching daemon,
1315.Xr nscd 8 ,
1316will not be built either if this option is set.
1317.It Va WITHOUT_NTP
1318.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
1319Set to not build
1320.Xr ntpd 8
1321and related programs.
1322.It Va WITH_OFED
1323.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
1324Set to build the
1325.Dq "OpenFabrics Enterprise Distribution"
1326Infiniband software stack.
1327.It Va WITH_OPENLDAP
1328.\" from FreeBSD: head/tools/build/options/WITH_OPENLDAP 264902 2014-04-24 23:17:31Z imp
1329Enable building openldap support for kerberos.
1330.It Va WITHOUT_OPENSSH
1331.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
1332Set to not build OpenSSH.
1333.It Va WITHOUT_OPENSSL
1334.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
1335Set to not build OpenSSL.
1336When set, it enforces these options:
1337.Pp
1338.Bl -item -compact
1339.It
1340.Va WITHOUT_KERBEROS
1341.It
1342.Va WITHOUT_KERBEROS_SUPPORT
1343.It
1344.Va WITHOUT_OPENSSH
1345.El
1346.Pp
1347When set, these options are also in effect:
1348.Pp
1349.Bl -inset -compact
1350.It Va WITHOUT_GSSAPI
1351(unless
1352.Va WITH_GSSAPI
1353is set explicitly)
1354.El
1355.It Va WITHOUT_PAM
1356.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
1357Set to not build PAM library and modules.
1358.Bf -symbolic
1359This option is deprecated and does nothing.
1360.Ef
1361When set, it enforces these options:
1362.Pp
1363.Bl -item -compact
1364.It
1365.Va WITHOUT_PAM_SUPPORT
1366.El
1367.It Va WITHOUT_PAM_SUPPORT
1368.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
1369Set to build some programs without PAM support, particularly
1370.Xr ftpd 8
1371and
1372.Xr ppp 8 .
1373.It Va WITHOUT_PC_SYSINSTALL
1374.\" from FreeBSD: head/tools/build/options/WITHOUT_PC_SYSINSTALL 245606 2013-01-18 15:57:09Z eadler
1375Set to not build
1376.Xr pc-sysinstall 8
1377and related programs.
1378.It Va WITHOUT_PF
1379.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
1380Set to not build PF firewall package.
1381When set, it enforces these options:
1382.Pp
1383.Bl -item -compact
1384.It
1385.Va WITHOUT_AUTHPF
1386.El
1387.It Va WITHOUT_PKGBOOTSTRAP
1388.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 258924 2013-12-04 15:58:42Z bdrewery
1389Set to not build
1390.Xr pkg 7
1391bootstrap tool.
1392.It Va WITHOUT_PMC
1393.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
1394Set to not build
1395.Xr pmccontrol 8
1396and related programs.
1397.It Va WITHOUT_PORTSNAP
1398.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
1399Set to not build or install
1400.Xr portsnap 8
1401and related files.
1402.It Va WITHOUT_PPP
1403.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
1404Set to not build
1405.Xr ppp 8
1406and related programs.
1407.It Va WITHOUT_PROFILE
1408.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
1409Set to avoid compiling profiled libraries.
1410.It Va WITHOUT_QUOTAS
1411.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 296264 2016-03-01 11:36:10Z trasz
1412Set to not build
1413.Xr quota 1
1414and related programs.
1415.It Va WITHOUT_RADIUS_SUPPORT
1416.\" from FreeBSD: head/tools/build/options/WITHOUT_RADIUS_SUPPORT 278182 2015-02-04 06:53:45Z ngie
1417Set to not build radius support into various applications, like
1418.Xr pam_radius 8
1419and
1420.Xr ppp 8 .
1421.It Va WITH_RATELIMIT
1422.\" from FreeBSD: head/tools/build/options/WITH_RATELIMIT 315763 2017-03-23 01:44:17Z ngie
1423Set to build the system with rate limit support.
1424.Pp
1425This makes
1426.Dv SO_MAX_PACING_RATE
1427effective in
1428.Xr getsockopt 2 ,
1429and
1430.Ar txrlimit
1431support in
1432.Xr ifconfig 8 ,
1433by proxy.
1434.It Va WITHOUT_RBOOTD
1435.\" from FreeBSD: head/tools/build/options/WITHOUT_RBOOTD 278192 2015-02-04 10:19:32Z ngie
1436Set to not build or install
1437.Xr rbootd 8 .
1438.It Va WITHOUT_RCMDS
1439.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
1440Disable building of the
1441.Bx
1442r-commands.
1443This includes
1444.Xr rlogin 1 ,
1445.Xr rsh 1 ,
1446etc.
1447.It Va WITH_REPRODUCIBLE_BUILD
1448.\" from FreeBSD: head/tools/build/options/WITH_REPRODUCIBLE_BUILD 310271 2016-12-19 15:09:30Z gjb
1449Set to exclude build metadata (such as the build time, user, or host)
1450from the kernel, boot loaders, and uname output, so that builds produce
1451bit-for-bit identical output.
1452.It Va WITHOUT_RESCUE
1453.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
1454Set to not build
1455.Xr rescue 8 .
1456.It Va WITHOUT_ROUTED
1457.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
1458Set to not build
1459.Xr routed 8
1460utility.
1461.It Va WITHOUT_SENDMAIL
1462.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
1463Set to not build
1464.Xr sendmail 8
1465and related programs.
1466.It Va WITHOUT_SETUID_LOGIN
1467.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
1468Set this to disable the installation of
1469.Xr login 1
1470as a set-user-ID root program.
1471.It Va WITHOUT_SHAREDOCS
1472.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
1473Set to not build the
1474.Bx 4.4
1475legacy docs.
1476.It Va WITH_SHARED_TOOLCHAIN
1477.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
1478Set to build the toolchain binaries shared.
1479The set includes
1480.Xr cc 1 ,
1481.Xr make 1
1482and necessary utilities like assembler, linker and library archive manager.
1483.It Va WITH_SORT_THREADS
1484.\" from FreeBSD: head/tools/build/options/WITH_SORT_THREADS 264158 2014-04-05 18:00:45Z imp
1485Set to enable threads in
1486.Xr sort 1 .
1487.It Va WITHOUT_SOURCELESS
1488.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
1489Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1490When set, it enforces these options:
1491.Pp
1492.Bl -item -compact
1493.It
1494.Va WITHOUT_SOURCELESS_HOST
1495.It
1496.Va WITHOUT_SOURCELESS_UCODE
1497.El
1498.It Va WITHOUT_SOURCELESS_HOST
1499.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
1500Set to not build kernel modules that include sourceless native code for host CPU.
1501.It Va WITHOUT_SOURCELESS_UCODE
1502.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
1503Set to not build kernel modules that include sourceless microcode.
1504.It Va WITHOUT_SSP
1505.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
1506Set to not build world with propolice stack smashing protection.
1507.Pp
1508This is a default setting on
1509mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf and mips/mips64hf.
1510.It Va WITH_SSP
1511.\" from FreeBSD: head/tools/build/options/WITH_SSP 311136 2017-01-02 20:09:09Z ngie
1512Set to build world with propolice stack smashing protection.
1513.Pp
1514This is a default setting on
1515amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1516.It Va WITH_STAGING
1517.\" from FreeBSD: head/tools/build/options/WITH_STAGING 290816 2015-11-14 03:24:48Z sjg
1518Enable staging of files to a stage tree.
1519This can be best thought of as auto-install to
1520.Va DESTDIR
1521with some extra meta data to ensure dependencies can be tracked.
1522Depends on
1523.Va WITH_DIRDEPS_BUILD .
1524When set, these options are also in effect:
1525.Pp
1526.Bl -inset -compact
1527.It Va WITH_STAGING_MAN
1528(unless
1529.Va WITHOUT_STAGING_MAN
1530is set explicitly)
1531.It Va WITH_STAGING_PROG
1532(unless
1533.Va WITHOUT_STAGING_PROG
1534is set explicitly)
1535.El
1536.Pp
1537This must be set in the environment, make command line, or
1538.Pa /etc/src-env.conf ,
1539not
1540.Pa /etc/src.conf .
1541.It Va WITH_STAGING_MAN
1542.\" from FreeBSD: head/tools/build/options/WITH_STAGING_MAN 313169 2017-02-03 19:09:46Z wblock
1543Enable staging of man pages to stage tree.
1544.It Va WITH_STAGING_PROG
1545.\" from FreeBSD: head/tools/build/options/WITH_STAGING_PROG 284708 2015-06-22 20:21:57Z sjg
1546Enable staging of PROGs to stage tree.
1547.It Va WITH_STALE_STAGED
1548.\" from FreeBSD: head/tools/build/options/WITH_STALE_STAGED 284708 2015-06-22 20:21:57Z sjg
1549Check staged files are not stale.
1550.It Va WITH_SVN
1551.\" from FreeBSD: head/tools/build/options/WITH_SVN 252561 2013-07-03 12:36:47Z zeising
1552Set to install
1553.Xr svnlite 1
1554as
1555.Xr svn 1 .
1556.It Va WITHOUT_SVNLITE
1557.\" from FreeBSD: head/tools/build/options/WITHOUT_SVNLITE 252561 2013-07-03 12:36:47Z zeising
1558Set to not build
1559.Xr svnlite 1
1560and related programs.
1561.It Va WITHOUT_SYMVER
1562.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
1563Set to disable symbol versioning when building shared libraries.
1564.It Va WITHOUT_SYSCONS
1565.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
1566Set to not build
1567.Xr syscons 4
1568support files such as keyboard maps, fonts, and screen output maps.
1569.It Va WITH_SYSROOT
1570.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 290816 2015-11-14 03:24:48Z sjg
1571Enable use of sysroot during build.
1572Depends on
1573.Va WITH_DIRDEPS_BUILD .
1574.Pp
1575This must be set in the environment, make command line, or
1576.Pa /etc/src-env.conf ,
1577not
1578.Pa /etc/src.conf .
1579.It Va WITHOUT_SYSTEM_COMPILER
1580.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSTEM_COMPILER 300354 2016-05-21 01:32:23Z bdrewery
1581Set to not opportunistically skip building a cross-compiler during the
1582bootstrap phase of the build.
1583Normally, if the currently installed compiler matches the planned bootstrap
1584compiler type and revision, then it will not be built.
1585This does not prevent a compiler from being built for installation though,
1586only for building one for the build itself.
1587The
1588.Va WITHOUT_CLANG
1589and
1590.Va WITHOUT_GCC
1591options control those.
1592.Pp
1593This is a default setting on
1594arm64/aarch64.
1595.It Va WITH_SYSTEM_COMPILER
1596.\" from FreeBSD: head/tools/build/options/WITH_SYSTEM_COMPILER 300354 2016-05-21 01:32:23Z bdrewery
1597Set to opportunistically skip building a cross-compiler during the
1598bootstrap phase of the build.
1599If the currently installed compiler matches the planned bootstrap compiler
1600type and revision, then it will not be built.
1601This does not prevent a compiler from being built for installation though,
1602only for building one for the build itself.
1603The
1604.Va WITHOUT_CLANG
1605and
1606.Va WITHOUT_GCC
1607options control those.
1608.Pp
1609This is a default setting on
1610amd64/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.
1611.It Va WITHOUT_TALK
1612.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie
1613Set to not build or install
1614.Xr talk 1
1615and
1616.Xr talkd 8 .
1617.It Va WITHOUT_TCP_WRAPPERS
1618.\" from FreeBSD: head/tools/build/options/WITHOUT_TCP_WRAPPERS 278192 2015-02-04 10:19:32Z ngie
1619Set to not build or install
1620.Xr tcpd 8 ,
1621and related utilities.
1622.It Va WITHOUT_TCSH
1623.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
1624Set to not build and install
1625.Pa /bin/csh
1626(which is
1627.Xr tcsh 1 ) .
1628.It Va WITHOUT_TELNET
1629.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 296264 2016-03-01 11:36:10Z trasz
1630Set to not build
1631.Xr telnet 1
1632and related programs.
1633.It Va WITHOUT_TESTS
1634.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS 268778 2014-07-16 21:40:11Z jmmv
1635Set to not build nor install the
1636.Fx
1637Test Suite in
1638.Pa /usr/tests/ .
1639See
1640.Xr tests 7
1641for more details.
1642This also disables the build of all test-related dependencies, including ATF.
1643When set, it enforces these options:
1644.Pp
1645.Bl -item -compact
1646.It
1647.Va WITHOUT_DTRACE_TESTS
1648.It
1649.Va WITHOUT_TESTS_SUPPORT
1650.El
1651.It Va WITHOUT_TESTS_SUPPORT
1652.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS_SUPPORT 274665 2014-11-18 17:06:50Z imp
1653Set to disables the build of all test-related dependencies, including ATF.
1654.It Va WITHOUT_TEXTPROC
1655.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
1656Set to not build
1657programs used for text processing.
1658When set, it enforces these options:
1659.Pp
1660.Bl -item -compact
1661.It
1662.Va WITHOUT_GROFF
1663.El
1664.It Va WITHOUT_TFTP
1665.\" from FreeBSD: head/tools/build/options/WITHOUT_TFTP 278192 2015-02-04 10:19:32Z ngie
1666Set to not build or install
1667.Xr tftp 1
1668and
1669.Xr tftpd 8 .
1670.It Va WITHOUT_TIMED
1671.\" from FreeBSD: head/tools/build/options/WITHOUT_TIMED 278192 2015-02-04 10:19:32Z ngie
1672Set to not build or install
1673.Xr timed 8 .
1674.It Va WITHOUT_TOOLCHAIN
1675.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 297939 2016-04-13 20:55:05Z bdrewery
1676Set to not install header or
1677programs used for program development,
1678compilers, debuggers etc.
1679When set, it enforces these options:
1680.Pp
1681.Bl -item -compact
1682.It
1683.Va WITHOUT_BINUTILS
1684.It
1685.Va WITHOUT_CLANG
1686.It
1687.Va WITHOUT_CLANG_EXTRAS
1688.It
1689.Va WITHOUT_CLANG_FULL
1690.It
1691.Va WITHOUT_GCC
1692.It
1693.Va WITHOUT_GDB
1694.It
1695.Va WITHOUT_INCLUDES
1696.It
1697.Va WITHOUT_LLD
1698.It
1699.Va WITHOUT_LLDB
1700.El
1701.It Va WITHOUT_UNBOUND
1702.\" from FreeBSD: head/tools/build/options/WITHOUT_UNBOUND 255597 2013-09-15 14:51:23Z des
1703Set to not build
1704.Xr unbound 8
1705and related programs.
1706.It Va WITHOUT_USB
1707.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1708Set to not build USB-related programs and libraries.
1709.It Va WITHOUT_USB_GADGET_EXAMPLES
1710.\" from FreeBSD: head/tools/build/options/WITHOUT_USB_GADGET_EXAMPLES 311548 2017-01-06 21:08:19Z ngie
1711Set to not build USB gadget kernel modules.
1712.It Va WITHOUT_UTMPX
1713.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1714Set to not build user accounting tools such as
1715.Xr last 1 ,
1716.Xr users 1 ,
1717.Xr who 1 ,
1718.Xr ac 8 ,
1719.Xr lastlogin 8
1720and
1721.Xr utx 8 .
1722.It Va WITHOUT_VI
1723.\" from FreeBSD: head/tools/build/options/WITHOUT_VI 264903 2014-04-24 23:17:40Z imp
1724Set to not build and install vi, view, ex and related programs.
1725.It Va WITHOUT_VT
1726.\" from FreeBSD: head/tools/build/options/WITHOUT_VT 268022 2014-06-30 00:20:12Z emaste
1727Set to not build
1728.Xr vt 4
1729support files (fonts and keymaps).
1730.It Va WITHOUT_WARNS
1731.\" from FreeBSD: head/tools/build/options/WITHOUT_WARNS 276559 2015-01-02 18:57:58Z bapt
1732Set this to not add warning flags to the compiler invocations.
1733Useful as a temporary workaround when code enters the tree
1734which triggers warnings in environments that differ from the
1735original developer.
1736.It Va WITHOUT_WIRELESS
1737.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1738Set to not build programs used for 802.11 wireless networks; especially
1739.Xr wpa_supplicant 8
1740and
1741.Xr hostapd 8 .
1742When set, it enforces these options:
1743.Pp
1744.Bl -item -compact
1745.It
1746.Va WITHOUT_WIRELESS_SUPPORT
1747.El
1748.It Va WITHOUT_WIRELESS_SUPPORT
1749.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1750Set to build libraries, programs, and kernel modules without
1751802.11 wireless support.
1752.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1753.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1754Build
1755.Xr wpa_supplicant 8
1756without support for the IEEE 802.1X protocol and without
1757support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1758protocols (usable only via 802.1X).
1759.It Va WITHOUT_ZFS
1760.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1761Set to not build ZFS file system.
1762.It Va WITHOUT_ZONEINFO
1763.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1764Set to not build the timezone database.
1765.El
1766.Sh FILES
1767.Bl -tag -compact -width Pa
1768.It Pa /etc/src.conf
1769.It Pa /etc/src-env.conf
1770.It Pa /usr/share/mk/bsd.own.mk
1771.El
1772.Sh SEE ALSO
1773.Xr make 1 ,
1774.Xr make.conf 5 ,
1775.Xr build 7 ,
1776.Xr ports 7
1777.Sh HISTORY
1778The
1779.Nm
1780file appeared in
1781.Fx 7.0 .
1782.Sh AUTHORS
1783This manual page was autogenerated by
1784.An tools/build/options/makeman .
1785