xref: /freebsd/share/man/man5/src.conf.5 (revision cc349066556bcdeed0d6cc72aad340d0f383e35c)
1.\" DO NOT EDIT-- this file is automatically generated.
2.\" from FreeBSD: head/tools/build/options/makeman 306729 2016-10-05 20:12:00Z emaste
3.\" $FreeBSD$
4.Dd January 2, 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 .
89Just the existence of an option will cause
90it to be honoured by
91.Xr make 1 .
92.Pp
93The following 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
166It is a default setting on
167arm64/aarch64.
168When set, it also enforces the following 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
179It 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, pc98/i386, 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
190It 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
197It 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, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
199.It Va WITHOUT_BLACKLIST
200.\" from FreeBSD: head/tools/build/options/WITHOUT_BLACKLIST 301554 2016-06-07 16:35:55Z lidl
201Set this if you do not want to build blacklistd / blacklistctl.
202When set, it also enforces the following 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 also enforces the following 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 also enforces the following 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 297436 2016-03-30 23:53:12Z bdrewery
282Set to use
283.Xr ccache 1
284for the build.
285No configuration is required except to install the
286.Sy devel/ccache
287package.
288Using with
289.Xr distcc 1
290should set
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 also enforces the following 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
340It is a default setting on
341mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf and sparc64/sparc64.
342When set, it also enforces the following 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
354It is a default setting on
355amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpcspe.
356.It Va WITHOUT_CLANG_BOOTSTRAP
357.\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG_BOOTSTRAP 273177 2014-10-16 18:28:11Z skreuzer
358Set to not build the Clang C/C++ compiler during the bootstrap phase of the build.
359You must enable either gcc or clang bootstrap to be able to build the system,
360unless an alternative compiler is provided via
361XCC.
362.Pp
363It 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
369It is a default setting on
370amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/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
379It is a default setting on
380mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf and sparc64/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
386It is a default setting on
387amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, pc98/i386, 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
396It 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
406It is a default setting on
407amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/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 275138 2014-11-26 20:43:09Z gjb
414Set to not build any cross compiler in the cross-tools stage of buildworld.
415If you are compiling a different version of
416.Fx
417than what is installed on the system, you will need to provide an alternate
418compiler with XCC to ensure success.
419If you are 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 also enforces the following 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 also enforces the following 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, the following 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_CXX
476.\" from FreeBSD: head/tools/build/options/WITHOUT_CXX 281053 2015-04-03 23:55:04Z bdrewery
477Set to not build
478.Xr c++ 1
479and related libraries.
480It will also prevent building of
481.Xr gperf 1
482and
483.Xr devd 8 .
484When set, it also enforces the following options:
485.Pp
486.Bl -item -compact
487.It
488.Va WITHOUT_CLANG
489.It
490.Va WITHOUT_CLANG_EXTRAS
491.It
492.Va WITHOUT_CLANG_FULL
493.It
494.Va WITHOUT_DTRACE_TESTS
495.It
496.Va WITHOUT_GNUCXX
497.It
498.Va WITHOUT_GROFF
499.It
500.Va WITHOUT_TESTS
501.It
502.Va WITHOUT_TESTS_SUPPORT
503.El
504.It Va WITHOUT_DEBUG_FILES
505.\" from FreeBSD: head/tools/build/options/WITHOUT_DEBUG_FILES 290059 2015-10-27 20:49:56Z emaste
506Set to avoid building or installing standalone debug files for each
507executable binary and shared library.
508.It Va WITHOUT_DIALOG
509.\" from FreeBSD: head/tools/build/options/WITHOUT_DIALOG 306375 2016-09-27 18:08:38Z emaste
510Set to not build dialog(1), dialog(1,3), and dpv(1,3).
511When set, it also enforces the following options:
512.Pp
513.Bl -item -compact
514.It
515.Va WITHOUT_BSDINSTALL
516.El
517.It Va WITHOUT_DICT
518.\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru
519Set to not build the Webster dictionary files.
520.It Va WITH_DIRDEPS_BUILD
521.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_BUILD 298007 2016-04-14 22:00:49Z bdrewery
522This is an experimental build system.
523For details see
524http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
525Build commands can be seen from the top-level with:
526.Dl make show-valid-targets
527The build is driven by dirdeps.mk using
528.Va DIRDEPS
529stored in
530Makefile.depend files found in each directory.
531.Pp
532The build can be started from anywhere, and behaves the same.
533The initial instance of
534.Xr make 1
535recursively reads
536.Va DIRDEPS
537from Makefile.depend
538computing a graph of tree dependencies from the current origin.
539Setting
540.Va NO_DIRDEPS
541will skip checking dirdep dependencies and will only build in the current
542and child directories.
543.Va NO_DIRDEPS_BELOW
544will skip building any dirdeps and only build the current directory.
545.Pp
546This also utilizes the
547.Va WITH_META_MODE
548logic for incremental builds.
549.Pp
550The build will hide commands ran unless
551.Va NO_SILENT
552is defined.
553.Pp
554Note that there is currently no mass install feature for this.
555.Pp
556When set, it also enforces the following options:
557.Pp
558.Bl -item -compact
559.It
560.Va WITH_INSTALL_AS_USER
561.El
562.Pp
563When set, the following options are also in effect:
564.Pp
565.Bl -inset -compact
566.It Va WITH_AUTO_OBJ
567(unless
568.Va WITHOUT_AUTO_OBJ
569is set explicitly)
570.It Va WITH_META_MODE
571(unless
572.Va WITHOUT_META_MODE
573is set explicitly)
574.It Va WITH_STAGING
575(unless
576.Va WITHOUT_STAGING
577is set explicitly)
578.It Va WITH_STAGING_MAN
579(unless
580.Va WITHOUT_STAGING_MAN
581is set explicitly)
582.It Va WITH_STAGING_PROG
583(unless
584.Va WITHOUT_STAGING_PROG
585is set explicitly)
586.It Va WITH_SYSROOT
587(unless
588.Va WITHOUT_SYSROOT
589is set explicitly)
590.El
591.Pp
592This must be set in the environment, make command line, or
593.Pa /etc/src-env.conf ,
594not
595.Pa /etc/src.conf .
596.It Va WITH_DIRDEPS_CACHE
597.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_CACHE 290816 2015-11-14 03:24:48Z sjg
598Cache result of dirdeps.mk which can save significant time
599for subsequent builds.
600Depends on
601.Va WITH_DIRDEPS_BUILD .
602.Pp
603This must be set in the environment, make command line, or
604.Pa /etc/src-env.conf ,
605not
606.Pa /etc/src.conf .
607.It Va WITHOUT_DMAGENT
608.\" from FreeBSD: head/tools/build/options/WITHOUT_DMAGENT 262335 2014-02-22 13:05:23Z bapt
609Set to not build dma Mail Transport Agent
610.It Va WITHOUT_DOCCOMPRESS
611.\" from FreeBSD: head/tools/build/options/WITHOUT_DOCCOMPRESS 266752 2014-05-27 15:52:27Z gjb
612Set to not to install compressed system documentation.
613Only the uncompressed version will be installed.
614.It Va WITH_DTRACE_TESTS
615.\" from FreeBSD: head/tools/build/options/WITH_DTRACE_TESTS 286174 2015-08-02 00:37:33Z markj
616Set to build and install the DTrace test suite in
617.Pa /usr/tests/cddl/usr.sbin/dtrace .
618This test suite is considered experimental on architectures other than
619amd64/amd64 and running it may cause system instability.
620.It Va WITHOUT_DYNAMICROOT
621.\" from FreeBSD: head/tools/build/options/WITHOUT_DYNAMICROOT 156932 2006-03-21 07:50:50Z ru
622Set this if you do not want to link
623.Pa /bin
624and
625.Pa /sbin
626dynamically.
627.It Va WITHOUT_ED_CRYPTO
628.\" from FreeBSD: head/tools/build/options/WITHOUT_ED_CRYPTO 235660 2012-05-19 20:05:27Z marcel
629Set to build
630.Xr ed 1
631without support for encryption/decryption.
632.It Va WITHOUT_EE
633.\" from FreeBSD: head/tools/build/options/WITHOUT_EE 277663 2015-01-25 00:03:44Z ngie
634Set to not build and install
635.Xr edit 1 ,
636.Xr ee 1 ,
637and related programs.
638.It Va WITHOUT_EFI
639.\" from FreeBSD: head/tools/build/options/WITHOUT_EFI 311135 2017-01-02 20:07:56Z ngie
640Set not to build
641.Xr efivar 3
642and
643.Xr efivar 8 .
644.Pp
645It is a default setting on
646mips/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.
647.It Va WITH_EFI
648.\" from FreeBSD: head/tools/build/options/WITH_EFI 311135 2017-01-02 20:07:56Z ngie
649Set to build
650.Xr efivar 3
651and
652.Xr efivar 8 .
653.Pp
654It is a default setting on
655amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
656.It Va WITH_EISA
657.\" from FreeBSD: head/tools/build/options/WITH_EISA 264654 2014-04-18 16:53:06Z imp
658Set to build EISA kernel modules.
659.It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
660.\" from FreeBSD: head/tools/build/options/WITHOUT_ELFTOOLCHAIN_BOOTSTRAP 295491 2016-02-11 00:14:00Z emaste
661Set to not build ELF Tool Chain tools
662(addr2line, nm, size, strings and strip)
663as part of the bootstrap process.
664.Bf -symbolic
665An alternate bootstrap tool chain must be provided.
666.Ef
667.It Va WITHOUT_EXAMPLES
668.\" from FreeBSD: head/tools/build/options/WITHOUT_EXAMPLES 156938 2006-03-21 09:06:24Z ru
669Set to avoid installing examples to
670.Pa /usr/share/examples/ .
671.It Va WITH_EXTRA_TCP_STACKS
672.\" from FreeBSD: head/tools/build/options/WITH_EXTRA_TCP_STACKS 302247 2016-06-28 13:37:01Z jtl
673Set to build extra TCP stack modules.
674.It Va WITHOUT_FDT
675.\" from FreeBSD: head/tools/build/options/WITHOUT_FDT 221539 2011-05-06 19:10:27Z ru
676Set to not build Flattened Device Tree support as part of the base system.
677This includes the device tree compiler (dtc) and libfdt support library.
678.It Va WITHOUT_FILE
679.\" from FreeBSD: head/tools/build/options/WITHOUT_FILE 278193 2015-02-04 10:24:40Z ngie
680Set to not build
681.Xr file 1
682and related programs.
683.It Va WITHOUT_FINGER
684.\" from FreeBSD: head/tools/build/options/WITHOUT_FINGER 278192 2015-02-04 10:19:32Z ngie
685Set to not build or install
686.Xr finger 1
687and
688.Xr fingerd 8 .
689.It Va WITHOUT_FLOPPY
690.\" from FreeBSD: head/tools/build/options/WITHOUT_FLOPPY 221540 2011-05-06 19:13:03Z ru
691Set to not build or install programs
692for operating floppy disk driver.
693.It Va WITHOUT_FMTREE
694.\" from FreeBSD: head/tools/build/options/WITHOUT_FMTREE 261299 2014-01-30 21:37:43Z brooks
695Set to not build and install
696.Pa /usr/sbin/fmtree .
697.It Va WITHOUT_FORMAT_EXTENSIONS
698.\" from FreeBSD: head/tools/build/options/WITHOUT_FORMAT_EXTENSIONS 250658 2013-05-15 13:04:10Z brooks
699Set to not enable
700.Fl fformat-extensions
701when compiling the kernel.
702Also disables all format checking.
703.It Va WITHOUT_FORTH
704.\" from FreeBSD: head/tools/build/options/WITHOUT_FORTH 156932 2006-03-21 07:50:50Z ru
705Set to build bootloaders without Forth support.
706.It Va WITHOUT_FP_LIBC
707.\" from FreeBSD: head/tools/build/options/WITHOUT_FP_LIBC 156932 2006-03-21 07:50:50Z ru
708Set to build
709.Nm libc
710without floating-point support.
711.It Va WITHOUT_FREEBSD_UPDATE
712.\" from FreeBSD: head/tools/build/options/WITHOUT_FREEBSD_UPDATE 183242 2008-09-21 22:02:26Z sam
713Set to not build
714.Xr freebsd-update 8 .
715.It Va WITHOUT_FTP
716.\" from FreeBSD: head/tools/build/options/WITHOUT_FTP 278192 2015-02-04 10:19:32Z ngie
717Set to not build or install
718.Xr ftp 1
719and
720.Xr ftpd 8 .
721.It Va WITHOUT_GAMES
722.\" from FreeBSD: head/tools/build/options/WITHOUT_GAMES 156932 2006-03-21 07:50:50Z ru
723Set to not build games.
724.It Va WITHOUT_GCC
725.\" from FreeBSD: head/tools/build/options/WITHOUT_GCC 264660 2014-04-18 17:03:58Z imp
726Set to not build and install gcc and g++ as part of the normal build process.
727.Pp
728It is a default setting on
729amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
730.It Va WITH_GCC
731.\" from FreeBSD: head/tools/build/options/WITH_GCC 255326 2013-09-06 20:49:48Z zeising
732Set to build and install gcc and g++.
733.Pp
734It is a default setting on
735mips/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.
736.It Va WITHOUT_GCC_BOOTSTRAP
737.\" from FreeBSD: head/tools/build/options/WITHOUT_GCC_BOOTSTRAP 273177 2014-10-16 18:28:11Z skreuzer
738Set to not build gcc and g++ as part of the bootstrap process.
739You must enable either gcc or clang bootstrap to be able to build the system,
740unless an alternative compiler is provided via
741XCC.
742.Pp
743It is a default setting on
744amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
745.It Va WITH_GCC_BOOTSTRAP
746.\" from FreeBSD: head/tools/build/options/WITH_GCC_BOOTSTRAP 264660 2014-04-18 17:03:58Z imp
747Set to build gcc and g++ as part of the bootstrap process.
748.Pp
749It is a default setting on
750mips/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.
751.It Va WITHOUT_GCOV
752.\" from FreeBSD: head/tools/build/options/WITHOUT_GCOV 156932 2006-03-21 07:50:50Z ru
753Set to not build the
754.Xr gcov 1
755tool.
756.It Va WITHOUT_GDB
757.\" from FreeBSD: head/tools/build/options/WITHOUT_GDB 156932 2006-03-21 07:50:50Z ru
758Set to not build
759.Xr gdb 1 .
760.Pp
761It is a default setting on
762arm64/aarch64.
763.It Va WITH_GDB
764.\" from FreeBSD: head/tools/build/options/WITH_GDB 295493 2016-02-11 00:30:51Z emaste
765Set to build
766.Xr gdb 1 .
767.Pp
768It is a default setting on
769amd64/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, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
770.It Va WITHOUT_GNU
771.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU 174550 2007-12-12 16:43:17Z ru
772Set to not build contributed GNU software as a part of the base system.
773This option can be useful if the system built must not contain any code
774covered by the GNU Public License due to legal reasons.
775.Bf -symbolic
776The option has no effect yet.
777.Ef
778When set, it also enforces the following options:
779.Pp
780.Bl -item -compact
781.It
782.Va WITHOUT_GNU_SUPPORT
783.El
784.It Va WITHOUT_GNUCXX
785.\" from FreeBSD: head/tools/build/options/WITHOUT_GNUCXX 255321 2013-09-06 20:08:03Z theraven
786Do not build the GNU C++ stack (g++, libstdc++).
787This is the default on platforms where clang is the system compiler.
788.Pp
789It is a default setting on
790amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
791.It Va WITH_GNUCXX
792.\" from FreeBSD: head/tools/build/options/WITH_GNUCXX 255321 2013-09-06 20:08:03Z theraven
793Build the GNU C++ stack (g++, libstdc++).
794This is the default on platforms where gcc is the system compiler.
795.Pp
796It is a default setting on
797mips/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.
798.It Va WITHOUT_GNU_DIFF
799.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_DIFF 307674 2016-10-20 14:48:57Z emaste
800Set to not build GNU
801.Xr diff 1
802and
803.Xr diff3 1 .
804.It Va WITHOUT_GNU_GREP
805.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_GREP 307674 2016-10-20 14:48:57Z emaste
806Set to not build GNU
807.Xr grep 1 .
808.It Va WITHOUT_GNU_GREP_COMPAT
809.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_GREP_COMPAT 273421 2014-10-21 20:44:33Z emaste
810Set this option to omit the gnu extensions to grep from being included in
811BSD grep.
812.It Va WITHOUT_GNU_SUPPORT
813.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_SUPPORT 156932 2006-03-21 07:50:50Z ru
814Set to build some programs without optional GNU support.
815.It Va WITHOUT_GPIO
816.\" from FreeBSD: head/tools/build/options/WITHOUT_GPIO 228081 2011-11-28 17:54:34Z dim
817Set to not build
818.Xr gpioctl 8
819as part of the base system.
820.It Va WITHOUT_GPL_DTC
821.\" from FreeBSD: head/tools/build/options/WITHOUT_GPL_DTC 264515 2014-04-15 20:41:55Z imp
822Set to build the BSD licensed version of the device tree compiler, instead of the
823GPL'd one from elinux.org.
824.It Va WITHOUT_GROFF
825.\" from FreeBSD: head/tools/build/options/WITHOUT_GROFF 218941 2011-02-22 08:13:49Z uqs
826Set to not build
827.Xr groff 1
828and
829.Xr vgrind 1 .
830You should consider installing the textproc/groff port to not break
831.Xr man 1 .
832.It Va WITHOUT_GSSAPI
833.\" from FreeBSD: head/tools/build/options/WITHOUT_GSSAPI 174548 2007-12-12 16:39:32Z ru
834Set to not build libgssapi.
835.It Va WITHOUT_HAST
836.\" from FreeBSD: head/tools/build/options/WITHOUT_HAST 277725 2015-01-26 06:27:07Z ngie
837Set to not build
838.Xr hastd 8
839and related utilities.
840.It Va WITH_HESIOD
841.\" from FreeBSD: head/tools/build/options/WITH_HESIOD 156932 2006-03-21 07:50:50Z ru
842Set to build Hesiod support.
843.It Va WITHOUT_HTML
844.\" from FreeBSD: head/tools/build/options/WITHOUT_HTML 156932 2006-03-21 07:50:50Z ru
845Set to not build HTML docs.
846.It Va WITHOUT_HYPERV
847.\" from FreeBSD: head/tools/build/options/WITHOUT_HYPERV 271493 2014-09-13 02:15:31Z delphij
848Set to not build or install HyperV utilities.
849.It Va WITHOUT_ICONV
850.\" from FreeBSD: head/tools/build/options/WITHOUT_ICONV 254919 2013-08-26 17:15:56Z antoine
851Set to not build iconv as part of libc.
852.It Va WITHOUT_INCLUDES
853.\" from FreeBSD: head/tools/build/options/WITHOUT_INCLUDES 275138 2014-11-26 20:43:09Z gjb
854Set to not install header files.
855This option used to be spelled
856.Va NO_INCS .
857.Bf -symbolic
858The option does not work for build targets.
859.Ef
860.It Va WITHOUT_INET
861.\" from FreeBSD: head/tools/build/options/WITHOUT_INET 221266 2011-04-30 17:58:28Z bz
862Set to not build programs and libraries related to IPv4 networking.
863When set, it also enforces the following options:
864.Pp
865.Bl -item -compact
866.It
867.Va WITHOUT_INET_SUPPORT
868.El
869.It Va WITHOUT_INET6
870.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6 156932 2006-03-21 07:50:50Z ru
871Set to not build
872programs and libraries related to IPv6 networking.
873When set, it also enforces the following options:
874.Pp
875.Bl -item -compact
876.It
877.Va WITHOUT_INET6_SUPPORT
878.El
879.It Va WITHOUT_INET6_SUPPORT
880.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6_SUPPORT 156932 2006-03-21 07:50:50Z ru
881Set to build libraries, programs, and kernel modules without IPv6 support.
882.It Va WITHOUT_INETD
883.\" from FreeBSD: head/tools/build/options/WITHOUT_INETD 278192 2015-02-04 10:19:32Z ngie
884Set to not build
885.Xr inetd 8 .
886.It Va WITHOUT_INET_SUPPORT
887.\" from FreeBSD: head/tools/build/options/WITHOUT_INET_SUPPORT 221266 2011-04-30 17:58:28Z bz
888Set to build libraries, programs, and kernel modules without IPv4 support.
889.It Va WITHOUT_INSTALLLIB
890.\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 297941 2016-04-13 21:01:58Z bdrewery
891Set this if you do not want to install optional libraries.
892For example when creating a
893.Xr nanobsd 8
894image.
895.Bf -symbolic
896The option does not work for build targets.
897.Ef
898.It Va WITH_INSTALL_AS_USER
899.\" from FreeBSD: head/tools/build/options/WITH_INSTALL_AS_USER 238021 2012-07-02 20:24:01Z marcel
900Set to make install targets succeed for non-root users by installing
901files with owner and group attributes set to that of the user running
902the
903.Xr make 1
904command.
905The user still has to set the
906.Va DESTDIR
907variable to point to a directory where the user has write permissions.
908.It Va WITHOUT_IPFILTER
909.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFILTER 156932 2006-03-21 07:50:50Z ru
910Set to not build IP Filter package.
911.It Va WITHOUT_IPFW
912.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFW 183242 2008-09-21 22:02:26Z sam
913Set to not build IPFW tools.
914.It Va WITHOUT_ISCSI
915.\" from FreeBSD: head/tools/build/options/WITHOUT_ISCSI 277675 2015-01-25 04:20:11Z ngie
916Set to not build
917.Xr iscid 8
918and related utilities.
919.It Va WITHOUT_JAIL
920.\" from FreeBSD: head/tools/build/options/WITHOUT_JAIL 249966 2013-04-27 04:09:09Z eadler
921Set to not build tools for the support of jails; e.g.,
922.Xr jail 8 .
923.It Va WITHOUT_KDUMP
924.\" from FreeBSD: head/tools/build/options/WITHOUT_KDUMP 240690 2012-09-19 11:38:37Z zeising
925Set to not build
926.Xr kdump 1
927and
928.Xr truss 1 .
929.It Va WITHOUT_KERBEROS
930.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 174549 2007-12-12 16:42:03Z ru
931Set this if you do not want to build Kerberos 5 (KTH Heimdal).
932When set, it also enforces the following options:
933.Pp
934.Bl -item -compact
935.It
936.Va WITHOUT_KERBEROS_SUPPORT
937.El
938.Pp
939When set, the following options are also in effect:
940.Pp
941.Bl -inset -compact
942.It Va WITHOUT_GSSAPI
943(unless
944.Va WITH_GSSAPI
945is set explicitly)
946.El
947.It Va WITHOUT_KERBEROS_SUPPORT
948.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 251794 2013-06-15 20:29:07Z eadler
949Set to build some programs without Kerberos support, like
950.Xr ssh 1 ,
951.Xr telnet 1 ,
952.Xr sshd 8 ,
953and
954.Xr telnetd 8 .
955.It Va WITHOUT_KERNEL_SYMBOLS
956.\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
957Set to not install kernel symbol files.
958.Bf -symbolic
959This option is recommended for those people who have small root partitions.
960.Ef
961.It Va WITHOUT_KVM
962.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
963Set to not build the
964.Nm libkvm
965library as a part of the base system.
966.Bf -symbolic
967The option has no effect yet.
968.Ef
969When set, it also enforces the following options:
970.Pp
971.Bl -item -compact
972.It
973.Va WITHOUT_KVM_SUPPORT
974.El
975.It Va WITHOUT_KVM_SUPPORT
976.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
977Set to build some programs without optional
978.Nm libkvm
979support.
980.It Va WITHOUT_LDNS
981.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS 255591 2013-09-15 13:11:13Z des
982Setting this variable will prevent the LDNS library from being built.
983When set, it also enforces the following options:
984.Pp
985.Bl -item -compact
986.It
987.Va WITHOUT_LDNS_UTILS
988.It
989.Va WITHOUT_UNBOUND
990.El
991.It Va WITHOUT_LDNS_UTILS
992.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS_UTILS 255850 2013-09-24 14:33:31Z des
993Setting this variable will prevent building the LDNS utilities
994.Xr drill 1
995and
996.Xr host 1 .
997.It Va WITHOUT_LEGACY_CONSOLE
998.\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 296264 2016-03-01 11:36:10Z trasz
999Set to not build programs that support a legacy PC console; e.g.,
1000.Xr kbdcontrol 1
1001and
1002.Xr vidcontrol 1 .
1003.It Va WITHOUT_LIB32
1004.\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 274664 2014-11-18 17:06:48Z imp
1005On 64-bit platforms, set to not build 32-bit library set and a
1006.Nm ld-elf32.so.1
1007runtime linker.
1008.It Va WITHOUT_LIBCPLUSPLUS
1009.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBCPLUSPLUS 246262 2013-02-02 22:42:46Z dim
1010Set to avoid building libcxxrt and libc++.
1011.It Va WITHOUT_LIBPTHREAD
1012.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
1013Set to not build the
1014.Nm libpthread
1015providing library,
1016.Nm libthr .
1017When set, it also enforces the following options:
1018.Pp
1019.Bl -item -compact
1020.It
1021.Va WITHOUT_LIBTHR
1022.El
1023.It Va WITH_LIBSOFT
1024.\" from FreeBSD: head/tools/build/options/WITH_LIBSOFT 300325 2016-05-20 19:23:07Z bdrewery
1025On armv6 only, set to enable soft float ABI compatibility libraries.
1026This option is for transitioning to the new hard float ABI.
1027.It Va WITHOUT_LIBTHR
1028.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
1029Set to not build the
1030.Nm libthr
1031(1:1 threading)
1032library.
1033.It Va WITHOUT_LLD
1034.\" from FreeBSD: head/tools/build/options/WITHOUT_LLD 309124 2016-11-24 22:54:55Z dim
1035Set to not build LLVM's lld linker.
1036.Pp
1037It is a default setting on
1038arm/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, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1039.It Va WITH_LLD
1040.\" from FreeBSD: head/tools/build/options/WITH_LLD 309124 2016-11-24 22:54:55Z dim
1041Set to build LLVM's lld linker.
1042.Pp
1043It is a default setting on
1044amd64/amd64 and arm64/aarch64.
1045.It Va WITHOUT_LLDB
1046.\" from FreeBSD: head/tools/build/options/WITHOUT_LLDB 289275 2015-10-14 00:23:31Z emaste
1047Set to not build the LLDB debugger.
1048.Pp
1049It is a default setting on
1050arm/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, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1051.It Va WITH_LLDB
1052.\" from FreeBSD: head/tools/build/options/WITH_LLDB 255722 2013-09-20 01:52:02Z emaste
1053Set to build the LLDB debugger.
1054.Pp
1055It is a default setting on
1056amd64/amd64 and arm64/aarch64.
1057.It Va WITHOUT_LLD_AS_LD
1058.\" from FreeBSD: head/tools/build/options/WITHOUT_LLD_AS_LD 309142 2016-11-25 13:15:28Z emaste
1059Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
1060.Pp
1061It is a default setting on
1062amd64/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, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1063.It Va WITH_LLD_AS_LD
1064.\" from FreeBSD: head/tools/build/options/WITH_LLD_AS_LD 309142 2016-11-25 13:15:28Z emaste
1065Set to use LLVM's LLD as the system linker, instead of GNU binutils ld.
1066.Pp
1067It is a default setting on
1068arm64/aarch64.
1069.It Va WITHOUT_LLVM_LIBUNWIND
1070.\" from FreeBSD: head/tools/build/options/WITHOUT_LLVM_LIBUNWIND 293450 2016-01-09 00:42:07Z emaste
1071Set to use GCC's stack unwinder (instead of LLVM's libunwind).
1072.Pp
1073It is a default setting on
1074arm/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.
1075.It Va WITH_LLVM_LIBUNWIND
1076.\" from FreeBSD: head/tools/build/options/WITH_LLVM_LIBUNWIND 293450 2016-01-09 00:42:07Z emaste
1077Set to use LLVM's libunwind stack unwinder (instead of GCC's unwinder).
1078.Pp
1079It is a default setting on
1080amd64/amd64, arm64/aarch64, i386/i386 and pc98/i386.
1081.It Va WITHOUT_LOCALES
1082.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
1083Set to not build localization files; see
1084.Xr locale 1 .
1085.It Va WITHOUT_LOCATE
1086.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
1087Set to not build
1088.Xr locate 1
1089and related programs.
1090.It Va WITHOUT_LPR
1091.\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
1092Set to not build
1093.Xr lpr 1
1094and related programs.
1095.It Va WITHOUT_LS_COLORS
1096.\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
1097Set to build
1098.Xr ls 1
1099without support for colors to distinguish file types.
1100.It Va WITHOUT_LZMA_SUPPORT
1101.\" from FreeBSD: head/tools/build/options/WITHOUT_LZMA_SUPPORT 245171 2013-01-08 18:37:12Z obrien
1102Set to build some programs without optional lzma compression support.
1103.It Va WITHOUT_MAIL
1104.\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
1105Set to not build any mail support (MUA or MTA).
1106When set, it also enforces the following options:
1107.Pp
1108.Bl -item -compact
1109.It
1110.Va WITHOUT_DMAGENT
1111.It
1112.Va WITHOUT_MAILWRAPPER
1113.It
1114.Va WITHOUT_SENDMAIL
1115.El
1116.It Va WITHOUT_MAILWRAPPER
1117.\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
1118Set to not build the
1119.Xr mailwrapper 8
1120MTA selector.
1121.It Va WITHOUT_MAKE
1122.\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
1123Set to not install
1124.Xr make 1
1125and related support files.
1126.It Va WITHOUT_MAN
1127.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
1128Set to not build manual pages.
1129When set, the following options are also in effect:
1130.Pp
1131.Bl -inset -compact
1132.It Va WITHOUT_MAN_UTILS
1133(unless
1134.Va WITH_MAN_UTILS
1135is set explicitly)
1136.El
1137.It Va WITHOUT_MANCOMPRESS
1138.\" from FreeBSD: head/tools/build/options/WITHOUT_MANCOMPRESS 266752 2014-05-27 15:52:27Z gjb
1139Set to not to install compressed man pages.
1140Only the uncompressed versions will be installed.
1141.It Va WITHOUT_MANDOCDB
1142.\" from FreeBSD: head/tools/build/options/WITHOUT_MANDOCDB 306966 2016-10-10 15:40:08Z emaste
1143Use the version of
1144.Xr makewhatis 1
1145introduced in
1146.Fx 2.1 ,
1147instead of the
1148.Xr makewhatis 8
1149database and utilities from
1150.Xr mandoc 1 .
1151.It Va WITHOUT_MAN_UTILS
1152.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
1153Set to not build utilities for manual pages,
1154.Xr apropos 1 ,
1155.Xr catman 1 ,
1156.Xr makewhatis 1 ,
1157.Xr man 1 ,
1158.Xr whatis 1 ,
1159.Xr manctl 8 ,
1160and related support files.
1161.It Va WITH_META_MODE
1162.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 306145 2016-09-21 21:32:05Z bdrewery
1163Creates
1164.Xr make 1
1165meta files when building, which can provide a reliable incremental build when
1166using
1167.Xr filemon 4 .
1168The meta file is created in the OBJDIR as
1169.Pa target.meta .
1170These meta files track the command ran, its output, and the current directory.
1171The
1172.Xr filemon 4
1173module is required unless
1174.Va NO_FILEMON
1175is defined.
1176When the module is loaded, any files used by the commands executed will be
1177tracked as
1178dependencies for the target in its meta file.
1179The target will be considered out-of-date and rebuilt if any of the following
1180are true compared to the last build:
1181.Bl -bullet -compact
1182.It
1183The command to execute changes.
1184.It
1185The current working directory changes.
1186.It
1187The target's meta file is missing.
1188.It
1189The target's meta file is missing filemon data when filemon is loaded
1190and a previous run did not have it loaded.
1191.It
1192[requires
1193.Xr filemon 4 ]
1194Files read, executed or linked to are newer than the target.
1195.It
1196[requires
1197.Xr filemon 4 ]
1198Files read, written, executed or linked are missing.
1199.El
1200The meta files can also be useful for debugging.
1201.Pp
1202The build will hide commands ran unless
1203.Va NO_SILENT
1204is defined.
1205Errors will cause
1206.Xr make 1
1207to show some of its environment for further debugging.
1208.Pp
1209The build operates as it normally would otherwise.
1210This option originally invoked a different build system but that was renamed
1211to
1212.Va WITH_DIRDEPS_BUILD .
1213.Pp
1214This must be set in the environment, make command line, or
1215.Pa /etc/src-env.conf ,
1216not
1217.Pa /etc/src.conf .
1218.It Va WITH_NAND
1219.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
1220Set to build the NAND Flash components.
1221.It Va WITHOUT_NDIS
1222.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
1223Set to not build programs and libraries
1224related to NDIS emulation support.
1225.It Va WITHOUT_NETCAT
1226.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
1227Set to not build
1228.Xr nc 1
1229utility.
1230.It Va WITHOUT_NETGRAPH
1231.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
1232Set to not build applications to support
1233.Xr netgraph 4 .
1234When set, it also enforces the following options:
1235.Pp
1236.Bl -item -compact
1237.It
1238.Va WITHOUT_ATM
1239.It
1240.Va WITHOUT_BLUETOOTH
1241.It
1242.Va WITHOUT_NETGRAPH_SUPPORT
1243.El
1244.It Va WITHOUT_NETGRAPH_SUPPORT
1245.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
1246Set to build libraries, programs, and kernel modules without netgraph support.
1247.It Va WITHOUT_NIS
1248.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
1249Set to not build
1250.Xr NIS 8
1251support and related programs.
1252If set, you might need to adopt your
1253.Xr nsswitch.conf 5
1254and remove
1255.Sq nis
1256entries.
1257.It Va WITHOUT_NLS
1258.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
1259Set to not build NLS catalogs.
1260.It Va WITHOUT_NLS_CATALOGS
1261.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
1262Set to not build NLS catalog support for
1263.Xr csh 1 .
1264.It Va WITHOUT_NS_CACHING
1265.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
1266Set to disable name caching in the
1267.Pa nsswitch
1268subsystem.
1269The generic caching daemon,
1270.Xr nscd 8 ,
1271will not be built either if this option is set.
1272.It Va WITHOUT_NTP
1273.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
1274Set to not build
1275.Xr ntpd 8
1276and related programs.
1277.It Va WITH_OFED
1278.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
1279Set to build the
1280.Dq "OpenFabrics Enterprise Distribution"
1281Infiniband software stack.
1282.It Va WITH_OPENLDAP
1283.\" from FreeBSD: head/tools/build/options/WITH_OPENLDAP 264902 2014-04-24 23:17:31Z imp
1284Enable building openldap support for kerberos.
1285.It Va WITHOUT_OPENSSH
1286.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
1287Set to not build OpenSSH.
1288.It Va WITHOUT_OPENSSL
1289.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
1290Set to not build OpenSSL.
1291When set, it also enforces the following options:
1292.Pp
1293.Bl -item -compact
1294.It
1295.Va WITHOUT_KERBEROS
1296.It
1297.Va WITHOUT_KERBEROS_SUPPORT
1298.It
1299.Va WITHOUT_OPENSSH
1300.El
1301.Pp
1302When set, the following options are also in effect:
1303.Pp
1304.Bl -inset -compact
1305.It Va WITHOUT_GSSAPI
1306(unless
1307.Va WITH_GSSAPI
1308is set explicitly)
1309.El
1310.It Va WITHOUT_PAM
1311.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
1312Set to not build PAM library and modules.
1313.Bf -symbolic
1314This option is deprecated and does nothing.
1315.Ef
1316When set, it also enforces the following options:
1317.Pp
1318.Bl -item -compact
1319.It
1320.Va WITHOUT_PAM_SUPPORT
1321.El
1322.It Va WITHOUT_PAM_SUPPORT
1323.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
1324Set to build some programs without PAM support, particularly
1325.Xr ftpd 8
1326and
1327.Xr ppp 8 .
1328.It Va WITHOUT_PC_SYSINSTALL
1329.\" from FreeBSD: head/tools/build/options/WITHOUT_PC_SYSINSTALL 245606 2013-01-18 15:57:09Z eadler
1330Set to not build
1331.Xr pc-sysinstall 8
1332and related programs.
1333.It Va WITHOUT_PF
1334.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
1335Set to not build PF firewall package.
1336When set, it also enforces the following options:
1337.Pp
1338.Bl -item -compact
1339.It
1340.Va WITHOUT_AUTHPF
1341.El
1342.It Va WITHOUT_PKGBOOTSTRAP
1343.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 258924 2013-12-04 15:58:42Z bdrewery
1344Set to not build
1345.Xr pkg 7
1346bootstrap tool.
1347.It Va WITHOUT_PMC
1348.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
1349Set to not build
1350.Xr pmccontrol 8
1351and related programs.
1352.It Va WITHOUT_PORTSNAP
1353.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
1354Set to not build or install
1355.Xr portsnap 8
1356and related files.
1357.It Va WITHOUT_PPP
1358.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
1359Set to not build
1360.Xr ppp 8
1361and related programs.
1362.It Va WITHOUT_PROFILE
1363.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
1364Set to avoid compiling profiled libraries.
1365.It Va WITHOUT_QUOTAS
1366.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 296264 2016-03-01 11:36:10Z trasz
1367Set to not build
1368.Xr quota 1
1369and related programs.
1370.It Va WITHOUT_RADIUS_SUPPORT
1371.\" from FreeBSD: head/tools/build/options/WITHOUT_RADIUS_SUPPORT 278182 2015-02-04 06:53:45Z ngie
1372Set to not build radius support into various applications, like
1373.Xr pam_radius 8
1374and
1375.Xr ppp 8 .
1376.It Va WITHOUT_RBOOTD
1377.\" from FreeBSD: head/tools/build/options/WITHOUT_RBOOTD 278192 2015-02-04 10:19:32Z ngie
1378Set to not build or install
1379.Xr rbootd 8 .
1380.It Va WITHOUT_RCMDS
1381.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
1382Disable building of the
1383.Bx
1384r-commands.
1385This includes
1386.Xr rlogin 1 ,
1387.Xr rsh 1 ,
1388etc.
1389.It Va WITH_REPRODUCIBLE_BUILD
1390.\" from FreeBSD: head/tools/build/options/WITH_REPRODUCIBLE_BUILD 310271 2016-12-19 15:09:30Z gjb
1391Set to exclude build metadata (such as the build time, user, or host)
1392from the kernel, boot loaders, and uname output, so that builds produce
1393bit-for-bit identical output.
1394.It Va WITHOUT_RESCUE
1395.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
1396Set to not build
1397.Xr rescue 8 .
1398.It Va WITHOUT_ROUTED
1399.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
1400Set to not build
1401.Xr routed 8
1402utility.
1403.It Va WITHOUT_SENDMAIL
1404.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
1405Set to not build
1406.Xr sendmail 8
1407and related programs.
1408.It Va WITHOUT_SETUID_LOGIN
1409.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
1410Set this to disable the installation of
1411.Xr login 1
1412as a set-user-ID root program.
1413.It Va WITHOUT_SHAREDOCS
1414.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
1415Set to not build the
1416.Bx 4.4
1417legacy docs.
1418.It Va WITH_SHARED_TOOLCHAIN
1419.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
1420Set to build the toolchain binaries shared.
1421The set includes
1422.Xr cc 1 ,
1423.Xr make 1
1424and necessary utilities like assembler, linker and library archive manager.
1425.It Va WITH_SORT_THREADS
1426.\" from FreeBSD: head/tools/build/options/WITH_SORT_THREADS 264158 2014-04-05 18:00:45Z imp
1427Set to enable threads in
1428.Xr sort 1 .
1429.It Va WITHOUT_SOURCELESS
1430.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
1431Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1432When set, it also enforces the following options:
1433.Pp
1434.Bl -item -compact
1435.It
1436.Va WITHOUT_SOURCELESS_HOST
1437.It
1438.Va WITHOUT_SOURCELESS_UCODE
1439.El
1440.It Va WITHOUT_SOURCELESS_HOST
1441.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
1442Set to not build kernel modules that include sourceless native code for host CPU.
1443.It Va WITHOUT_SOURCELESS_UCODE
1444.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
1445Set to not build kernel modules that include sourceless microcode.
1446.It Va WITHOUT_SSP
1447.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
1448Set to not build world with propolice stack smashing protection.
1449.Pp
1450It is a default setting on
1451mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf and mips/mips64hf.
1452.It Va WITH_SSP
1453.\" from FreeBSD: head/tools/build/options/WITH_SSP 311136 2017-01-02 20:09:09Z ngie
1454Set to build world with propolice stack smashing protection.
1455.Pp
1456It is a default setting on
1457amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, pc98/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1458.It Va WITH_STAGING
1459.\" from FreeBSD: head/tools/build/options/WITH_STAGING 290816 2015-11-14 03:24:48Z sjg
1460Enable staging of files to a stage tree.
1461This can be best thought of as auto-install to
1462.Va DESTDIR
1463with some extra meta data to ensure dependencies can be tracked.
1464Depends on
1465.Va WITH_DIRDEPS_BUILD .
1466When set, the following options are also in effect:
1467.Pp
1468.Bl -inset -compact
1469.It Va WITH_STAGING_MAN
1470(unless
1471.Va WITHOUT_STAGING_MAN
1472is set explicitly)
1473.It Va WITH_STAGING_PROG
1474(unless
1475.Va WITHOUT_STAGING_PROG
1476is set explicitly)
1477.El
1478.Pp
1479This must be set in the environment, make command line, or
1480.Pa /etc/src-env.conf ,
1481not
1482.Pa /etc/src.conf .
1483.It Va WITH_STAGING_MAN
1484.\" from FreeBSD: head/tools/build/options/WITH_STAGING_MAN 284708 2015-06-22 20:21:57Z sjg
1485Enable staging of MAN pages to stage tree.
1486.It Va WITH_STAGING_PROG
1487.\" from FreeBSD: head/tools/build/options/WITH_STAGING_PROG 284708 2015-06-22 20:21:57Z sjg
1488Enable staging of PROGs to stage tree.
1489.It Va WITH_STALE_STAGED
1490.\" from FreeBSD: head/tools/build/options/WITH_STALE_STAGED 284708 2015-06-22 20:21:57Z sjg
1491Check staged files are not stale.
1492.It Va WITH_SVN
1493.\" from FreeBSD: head/tools/build/options/WITH_SVN 252561 2013-07-03 12:36:47Z zeising
1494Set to install
1495.Xr svnlite 1
1496as
1497.Xr svn 1 .
1498.It Va WITHOUT_SVNLITE
1499.\" from FreeBSD: head/tools/build/options/WITHOUT_SVNLITE 252561 2013-07-03 12:36:47Z zeising
1500Set to not build
1501.Xr svnlite 1
1502and related programs.
1503.It Va WITHOUT_SYMVER
1504.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
1505Set to disable symbol versioning when building shared libraries.
1506.It Va WITHOUT_SYSCONS
1507.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
1508Set to not build
1509.Xr syscons 4
1510support files such as keyboard maps, fonts, and screen output maps.
1511.It Va WITH_SYSROOT
1512.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 290816 2015-11-14 03:24:48Z sjg
1513Enable use of sysroot during build.
1514Depends on
1515.Va WITH_DIRDEPS_BUILD .
1516.Pp
1517This must be set in the environment, make command line, or
1518.Pa /etc/src-env.conf ,
1519not
1520.Pa /etc/src.conf .
1521.It Va WITHOUT_SYSTEM_COMPILER
1522.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSTEM_COMPILER 300354 2016-05-21 01:32:23Z bdrewery
1523Set to not opportunistically skip building a cross-compiler during the
1524bootstrap phase of the build.
1525Normally, if the currently installed compiler matches the planned bootstrap
1526compiler type and revision, then it will not be built.
1527This does not prevent a compiler from being built for installation though,
1528only for building one for the build itself.
1529The
1530.Va WITHOUT_CLANG
1531and
1532.Va WITHOUT_GCC
1533options control those.
1534.It Va WITHOUT_TALK
1535.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie
1536Set to not build or install
1537.Xr talk 1
1538and
1539.Xr talkd 8 .
1540.It Va WITHOUT_TCP_WRAPPERS
1541.\" from FreeBSD: head/tools/build/options/WITHOUT_TCP_WRAPPERS 278192 2015-02-04 10:19:32Z ngie
1542Set to not build or install
1543.Xr tcpd 8 ,
1544and related utilities.
1545.It Va WITHOUT_TCSH
1546.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
1547Set to not build and install
1548.Pa /bin/csh
1549(which is
1550.Xr tcsh 1 ) .
1551.It Va WITHOUT_TELNET
1552.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 296264 2016-03-01 11:36:10Z trasz
1553Set to not build
1554.Xr telnet 1
1555and related programs.
1556.It Va WITHOUT_TESTS
1557.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS 268778 2014-07-16 21:40:11Z jmmv
1558Set to not build nor install the
1559.Fx
1560Test Suite in
1561.Pa /usr/tests/ .
1562See
1563.Xr tests 7
1564for more details.
1565This also disables the build of all test-related dependencies, including ATF.
1566When set, it also enforces the following options:
1567.Pp
1568.Bl -item -compact
1569.It
1570.Va WITHOUT_DTRACE_TESTS
1571.It
1572.Va WITHOUT_TESTS_SUPPORT
1573.El
1574.It Va WITHOUT_TESTS_SUPPORT
1575.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS_SUPPORT 274665 2014-11-18 17:06:50Z imp
1576Set to disables the build of all test-related dependencies, including ATF.
1577.It Va WITHOUT_TEXTPROC
1578.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
1579Set to not build
1580programs used for text processing.
1581When set, it also enforces the following options:
1582.Pp
1583.Bl -item -compact
1584.It
1585.Va WITHOUT_GROFF
1586.El
1587.It Va WITHOUT_TFTP
1588.\" from FreeBSD: head/tools/build/options/WITHOUT_TFTP 278192 2015-02-04 10:19:32Z ngie
1589Set to not build or install
1590.Xr tftp 1
1591and
1592.Xr tftpd 8 .
1593.It Va WITHOUT_TIMED
1594.\" from FreeBSD: head/tools/build/options/WITHOUT_TIMED 278192 2015-02-04 10:19:32Z ngie
1595Set to not build or install
1596.Xr timed 8 .
1597.It Va WITHOUT_TOOLCHAIN
1598.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 297939 2016-04-13 20:55:05Z bdrewery
1599Set to not install header or
1600programs used for program development,
1601compilers, debuggers etc.
1602When set, it also enforces the following options:
1603.Pp
1604.Bl -item -compact
1605.It
1606.Va WITHOUT_BINUTILS
1607.It
1608.Va WITHOUT_CLANG
1609.It
1610.Va WITHOUT_CLANG_EXTRAS
1611.It
1612.Va WITHOUT_CLANG_FULL
1613.It
1614.Va WITHOUT_GCC
1615.It
1616.Va WITHOUT_GDB
1617.It
1618.Va WITHOUT_INCLUDES
1619.It
1620.Va WITHOUT_LLDB
1621.El
1622.It Va WITHOUT_UNBOUND
1623.\" from FreeBSD: head/tools/build/options/WITHOUT_UNBOUND 255597 2013-09-15 14:51:23Z des
1624Set to not build
1625.Xr unbound 8
1626and related programs.
1627.It Va WITHOUT_USB
1628.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1629Set to not build USB-related programs and libraries.
1630.It Va WITHOUT_USB_GADGET_EXAMPLES
1631.\" from FreeBSD: head/tools/build/options/WITHOUT_USB_GADGET_EXAMPLES 274665 2014-11-18 17:06:50Z imp
1632Set to build USB gadget kernel modules.
1633.It Va WITHOUT_UTMPX
1634.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1635Set to not build user accounting tools such as
1636.Xr last 1 ,
1637.Xr users 1 ,
1638.Xr who 1 ,
1639.Xr ac 8 ,
1640.Xr lastlogin 8
1641and
1642.Xr utx 8 .
1643.It Va WITHOUT_VI
1644.\" from FreeBSD: head/tools/build/options/WITHOUT_VI 264903 2014-04-24 23:17:40Z imp
1645Set to not build and install vi, view, ex and related programs.
1646.It Va WITHOUT_VT
1647.\" from FreeBSD: head/tools/build/options/WITHOUT_VT 268022 2014-06-30 00:20:12Z emaste
1648Set to not build
1649.Xr vt 4
1650support files (fonts and keymaps).
1651.It Va WITHOUT_WARNS
1652.\" from FreeBSD: head/tools/build/options/WITHOUT_WARNS 276559 2015-01-02 18:57:58Z bapt
1653Set this to not add warning flags to the compiler invocations.
1654Useful as a temporary workaround when code enters the tree
1655which triggers warnings in environments that differ from the
1656original developer.
1657.It Va WITHOUT_WIRELESS
1658.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1659Set to not build programs used for 802.11 wireless networks; especially
1660.Xr wpa_supplicant 8
1661and
1662.Xr hostapd 8 .
1663When set, it also enforces the following options:
1664.Pp
1665.Bl -item -compact
1666.It
1667.Va WITHOUT_WIRELESS_SUPPORT
1668.El
1669.It Va WITHOUT_WIRELESS_SUPPORT
1670.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1671Set to build libraries, programs, and kernel modules without
1672802.11 wireless support.
1673.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1674.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1675Build
1676.Xr wpa_supplicant 8
1677without support for the IEEE 802.1X protocol and without
1678support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1679protocols (usable only via 802.1X).
1680.It Va WITHOUT_ZFS
1681.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1682Set to not build ZFS file system.
1683.It Va WITHOUT_ZONEINFO
1684.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1685Set to not build the timezone database.
1686.El
1687.Sh FILES
1688.Bl -tag -compact -width Pa
1689.It Pa /etc/src.conf
1690.It Pa /etc/src-env.conf
1691.It Pa /usr/share/mk/bsd.own.mk
1692.El
1693.Sh SEE ALSO
1694.Xr make 1 ,
1695.Xr make.conf 5 ,
1696.Xr build 7 ,
1697.Xr ports 7
1698.Sh HISTORY
1699The
1700.Nm
1701file appeared in
1702.Fx 7.0 .
1703.Sh AUTHORS
1704This manual page was autogenerated.
1705