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