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