xref: /freebsd/share/man/man5/src.conf.5 (revision a476e3a5678de5ca7ad765315f28308410d4f09e)
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 November 28, 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 WITH_DEBUG_FILES
456.\" from FreeBSD: head/tools/build/options/WITH_DEBUG_FILES 251512 2013-06-07 21:40:02Z emaste
457Set to strip debug info into a separate file for each executable binary
458and shared library.
459The debug files will be placed in a subdirectory of
460.Pa /usr/lib/debug
461and are located automatically by
462.Xr gdb 1 .
463.It Va WITHOUT_DICT
464.\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru
465Set to not build the Webster dictionary files.
466.It Va WITH_DIRDEPS_BUILD
467.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_BUILD 290816 2015-11-14 03:24:48Z sjg
468Enable building in meta mode.
469This is an experimental build feature.
470For details see
471http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
472.Pp
473The build is driven by dirdeps.mk using
474.Va DIRDEPS
475stored in
476Makefile.depend files found in each directory.
477.Pp
478The build can be started from anywhere, and behaves the same.
479The initial instance of
480.Xr make 1
481recursively reads
482.Va DIRDEPS
483from Makefile.depend
484computing a graph of tree dependencies from the current origin.
485Setting
486.Va NO_DIRDEPS
487will skip checking dirdep dependencies and will only build in the current
488directory.
489.Pp
490As each target is made
491.Xr make 1
492produces a meta file which is used to capture (and compare)
493the command line,
494as well as any command output.
495If
496.Xr filemon 4
497is available the meta file will also capture a record of files
498used to produce the target by tracking syscalls.
499.Pp
500The build will hide commands ran unless
501.Va NO_SILENT
502is defined.
503.Pp
504When set, it also enforces the following options:
505.Pp
506.Bl -item -compact
507.It
508.Va WITH_INSTALL_AS_USER
509.El
510.Pp
511When set, the following options are also in effect:
512.Pp
513.Bl -inset -compact
514.It Va WITH_AUTO_OBJ
515(unless
516.Va WITHOUT_AUTO_OBJ
517is set explicitly)
518.It Va WITH_META_MODE
519(unless
520.Va WITHOUT_META_MODE
521is set explicitly)
522.It Va WITH_STAGING
523(unless
524.Va WITHOUT_STAGING
525is set explicitly)
526.It Va WITH_STAGING_MAN
527(unless
528.Va WITHOUT_STAGING_MAN
529is set explicitly)
530.It Va WITH_STAGING_PROG
531(unless
532.Va WITHOUT_STAGING_PROG
533is set explicitly)
534.It Va WITH_SYSROOT
535(unless
536.Va WITHOUT_SYSROOT
537is set explicitly)
538.El
539.Pp
540This must be set in the environment, make command line, or
541.Pa /etc/src-env.conf ,
542not
543.Pa /etc/src.conf .
544.It Va WITH_DIRDEPS_CACHE
545.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_CACHE 290816 2015-11-14 03:24:48Z sjg
546Cache result of dirdeps.mk which can save significant time
547for subsequent builds.
548Depends on
549.Va WITH_DIRDEPS_BUILD .
550.Pp
551This must be set in the environment, make command line, or
552.Pa /etc/src-env.conf ,
553not
554.Pa /etc/src.conf .
555.It Va WITHOUT_DMAGENT
556.\" from FreeBSD: head/tools/build/options/WITHOUT_DMAGENT 262335 2014-02-22 13:05:23Z bapt
557Set to not build dma Mail Transport Agent
558.It Va WITHOUT_DOCCOMPRESS
559.\" from FreeBSD: head/tools/build/options/WITHOUT_DOCCOMPRESS 266752 2014-05-27 15:52:27Z gjb
560Set to not to install compressed system documentation.
561Only the uncompressed version will be installed.
562.It Va WITH_DTRACE_TESTS
563.\" from FreeBSD: head/tools/build/options/WITH_DTRACE_TESTS 286174 2015-08-02 00:37:33Z markj
564Set to build and install the DTrace test suite in
565.Pa /usr/tests/cddl/usr.sbin/dtrace .
566This test suite is considered experimental on architectures other than
567amd64/amd64 and running it may cause system instability.
568.It Va WITHOUT_DYNAMICROOT
569.\" from FreeBSD: head/tools/build/options/WITHOUT_DYNAMICROOT 156932 2006-03-21 07:50:50Z ru
570Set this if you do not want to link
571.Pa /bin
572and
573.Pa /sbin
574dynamically.
575.It Va WITHOUT_ED_CRYPTO
576.\" from FreeBSD: head/tools/build/options/WITHOUT_ED_CRYPTO 235660 2012-05-19 20:05:27Z marcel
577Set to build
578.Xr ed 1
579without support for encryption/decryption.
580.It Va WITHOUT_EE
581.\" from FreeBSD: head/tools/build/options/WITHOUT_EE 277663 2015-01-25 00:03:44Z ngie
582Set to not build and install
583.Xr edit 1 ,
584.Xr ee 1 ,
585and related programs.
586.It Va WITH_EISA
587.\" from FreeBSD: head/tools/build/options/WITH_EISA 264654 2014-04-18 16:53:06Z imp
588Set to build EISA kernel modules.
589.It Va WITHOUT_ELFCOPY_AS_OBJCOPY
590.\" from FreeBSD: head/tools/build/options/WITHOUT_ELFCOPY_AS_OBJCOPY 286030 2015-07-29 18:45:38Z emaste
591Set to build and install
592.Xr objcopy 1
593from GNU Binutils, instead of the one from ELF Tool Chain.
594.Pp
595It is a default setting on
596amd64/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.
597.It Va WITH_ELFCOPY_AS_OBJCOPY
598.\" from FreeBSD: head/tools/build/options/WITH_ELFCOPY_AS_OBJCOPY 286030 2015-07-29 18:45:38Z emaste
599Set to build and install ELF Tool Chain's elfcopy as
600.Xr objcopy 1 ,
601instead of the one from GNU Binutils.
602.Pp
603It is a default setting on
604arm64/aarch64.
605.It Va WITHOUT_EXAMPLES
606.\" from FreeBSD: head/tools/build/options/WITHOUT_EXAMPLES 156938 2006-03-21 09:06:24Z ru
607Set to avoid installing examples to
608.Pa /usr/share/examples/ .
609.It Va WITH_FAST_DEPEND
610.\" from FreeBSD: head/tools/build/options/WITH_FAST_DEPEND 290433 2015-11-06 04:45:29Z bdrewery
611Set to generate
612.Sy .depend
613files in the build during compilation instead of the
614historial
615.Xr mkdep 1
616call during the "make depend" phase.
617.It Va WITHOUT_FDT
618.\" from FreeBSD: head/tools/build/options/WITHOUT_FDT 221539 2011-05-06 19:10:27Z ru
619Set to not build Flattened Device Tree support as part of the base system.
620This includes the device tree compiler (dtc) and libfdt support library.
621.It Va WITHOUT_FILE
622.\" from FreeBSD: head/tools/build/options/WITHOUT_FILE 278193 2015-02-04 10:24:40Z ngie
623Set to not build
624.Xr file 1
625and related programs.
626.It Va WITHOUT_FINGER
627.\" from FreeBSD: head/tools/build/options/WITHOUT_FINGER 278192 2015-02-04 10:19:32Z ngie
628Set to not build or install
629.Xr finger 1
630and
631.Xr fingerd 8 .
632.It Va WITHOUT_FLOPPY
633.\" from FreeBSD: head/tools/build/options/WITHOUT_FLOPPY 221540 2011-05-06 19:13:03Z ru
634Set to not build or install programs
635for operating floppy disk driver.
636.It Va WITHOUT_FMTREE
637.\" from FreeBSD: head/tools/build/options/WITHOUT_FMTREE 261299 2014-01-30 21:37:43Z brooks
638Set to not build and install
639.Pa /usr/sbin/fmtree .
640.It Va WITHOUT_FORMAT_EXTENSIONS
641.\" from FreeBSD: head/tools/build/options/WITHOUT_FORMAT_EXTENSIONS 250658 2013-05-15 13:04:10Z brooks
642Set to not enable
643.Fl fformat-extensions
644when compiling the kernel.
645Also disables all format checking.
646.It Va WITHOUT_FORTH
647.\" from FreeBSD: head/tools/build/options/WITHOUT_FORTH 156932 2006-03-21 07:50:50Z ru
648Set to build bootloaders without Forth support.
649.It Va WITHOUT_FP_LIBC
650.\" from FreeBSD: head/tools/build/options/WITHOUT_FP_LIBC 156932 2006-03-21 07:50:50Z ru
651Set to build
652.Nm libc
653without floating-point support.
654.It Va WITHOUT_FREEBSD_UPDATE
655.\" from FreeBSD: head/tools/build/options/WITHOUT_FREEBSD_UPDATE 183242 2008-09-21 22:02:26Z sam
656Set to not build
657.Xr freebsd-update 8 .
658.It Va WITHOUT_FTP
659.\" from FreeBSD: head/tools/build/options/WITHOUT_FTP 278192 2015-02-04 10:19:32Z ngie
660Set to not build or install
661.Xr ftp 1
662and
663.Xr ftpd 8 .
664.It Va WITHOUT_GAMES
665.\" from FreeBSD: head/tools/build/options/WITHOUT_GAMES 156932 2006-03-21 07:50:50Z ru
666Set to not build games.
667.It Va WITHOUT_GCC
668.\" from FreeBSD: head/tools/build/options/WITHOUT_GCC 264660 2014-04-18 17:03:58Z imp
669Set to not build and install gcc and g++ as part of the normal build process.
670.Pp
671It is a default setting on
672amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
673.It Va WITH_GCC
674.\" from FreeBSD: head/tools/build/options/WITH_GCC 255326 2013-09-06 20:49:48Z zeising
675Set to build and install gcc and g++.
676.Pp
677It is a default setting on
678mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
679.It Va WITHOUT_GCC_BOOTSTRAP
680.\" from FreeBSD: head/tools/build/options/WITHOUT_GCC_BOOTSTRAP 273177 2014-10-16 18:28:11Z skreuzer
681Set to not build gcc and g++ as part of the bootstrap process.
682You must enable either gcc or clang bootstrap to be able to build the system,
683unless an alternative compiler is provided via
684XCC.
685.Pp
686It is a default setting on
687amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
688.It Va WITH_GCC_BOOTSTRAP
689.\" from FreeBSD: head/tools/build/options/WITH_GCC_BOOTSTRAP 264660 2014-04-18 17:03:58Z imp
690Set to build gcc and g++ as part of the bootstrap process.
691.Pp
692It is a default setting on
693mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
694.It Va WITHOUT_GCOV
695.\" from FreeBSD: head/tools/build/options/WITHOUT_GCOV 156932 2006-03-21 07:50:50Z ru
696Set to not build the
697.Xr gcov 1
698tool.
699.It Va WITHOUT_GDB
700.\" from FreeBSD: head/tools/build/options/WITHOUT_GDB 156932 2006-03-21 07:50:50Z ru
701Set to not build
702.Xr gdb 1 .
703.Pp
704It is a default setting on
705arm64/aarch64.
706.It Va WITHOUT_GNU
707.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU 174550 2007-12-12 16:43:17Z ru
708Set to not build contributed GNU software as a part of the base system.
709This option can be useful if the system built must not contain any code
710covered by the GNU Public License due to legal reasons.
711.Bf -symbolic
712The option has no effect yet.
713.Ef
714When set, it also enforces the following options:
715.Pp
716.Bl -item -compact
717.It
718.Va WITHOUT_GNU_SUPPORT
719.El
720.It Va WITHOUT_GNUCXX
721.\" from FreeBSD: head/tools/build/options/WITHOUT_GNUCXX 255321 2013-09-06 20:08:03Z theraven
722Do not build the GNU C++ stack (g++, libstdc++).
723This is the default on platforms where clang is the system compiler.
724.Pp
725It is a default setting on
726amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
727.It Va WITH_GNUCXX
728.\" from FreeBSD: head/tools/build/options/WITH_GNUCXX 255321 2013-09-06 20:08:03Z theraven
729Build the GNU C++ stack (g++, libstdc++).
730This is the default on platforms where gcc is the system compiler.
731.Pp
732It is a default setting on
733mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
734.It Va WITHOUT_GNU_GREP_COMPAT
735.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_GREP_COMPAT 273421 2014-10-21 20:44:33Z emaste
736Set this option to omit the gnu extensions to grep from being included in
737BSD grep.
738.It Va WITHOUT_GNU_SUPPORT
739.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_SUPPORT 156932 2006-03-21 07:50:50Z ru
740Set to build some programs without optional GNU support.
741.It Va WITHOUT_GPIO
742.\" from FreeBSD: head/tools/build/options/WITHOUT_GPIO 228081 2011-11-28 17:54:34Z dim
743Set to not build
744.Xr gpioctl 8
745as part of the base system.
746.It Va WITHOUT_GPL_DTC
747.\" from FreeBSD: head/tools/build/options/WITHOUT_GPL_DTC 264515 2014-04-15 20:41:55Z imp
748Set to build the BSD licensed version of the device tree compiler, instead of the
749GPL'd one from elinux.org.
750.It Va WITHOUT_GROFF
751.\" from FreeBSD: head/tools/build/options/WITHOUT_GROFF 218941 2011-02-22 08:13:49Z uqs
752Set to not build
753.Xr groff 1
754and
755.Xr vgrind 1 .
756You should consider installing the textproc/groff port to not break
757.Xr man 1 .
758.It Va WITHOUT_GSSAPI
759.\" from FreeBSD: head/tools/build/options/WITHOUT_GSSAPI 174548 2007-12-12 16:39:32Z ru
760Set to not build libgssapi.
761.It Va WITHOUT_HAST
762.\" from FreeBSD: head/tools/build/options/WITHOUT_HAST 277725 2015-01-26 06:27:07Z ngie
763Set to not build
764.Xr hastd 8
765and related utilities.
766.It Va WITH_HESIOD
767.\" from FreeBSD: head/tools/build/options/WITH_HESIOD 156932 2006-03-21 07:50:50Z ru
768Set to build Hesiod support.
769.It Va WITHOUT_HTML
770.\" from FreeBSD: head/tools/build/options/WITHOUT_HTML 156932 2006-03-21 07:50:50Z ru
771Set to not build HTML docs.
772.It Va WITHOUT_HYPERV
773.\" from FreeBSD: head/tools/build/options/WITHOUT_HYPERV 271493 2014-09-13 02:15:31Z delphij
774Set to not build or install HyperV utilities.
775.It Va WITHOUT_ICONV
776.\" from FreeBSD: head/tools/build/options/WITHOUT_ICONV 254919 2013-08-26 17:15:56Z antoine
777Set to not build iconv as part of libc.
778.It Va WITHOUT_INCLUDES
779.\" from FreeBSD: head/tools/build/options/WITHOUT_INCLUDES 275138 2014-11-26 20:43:09Z gjb
780Set to not install header files.
781This option used to be spelled
782.Va NO_INCS .
783.Bf -symbolic
784The option does not work for build targets.
785.Ef
786.It Va WITHOUT_INET
787.\" from FreeBSD: head/tools/build/options/WITHOUT_INET 221266 2011-04-30 17:58:28Z bz
788Set to not build programs and libraries related to IPv4 networking.
789When set, it also enforces the following options:
790.Pp
791.Bl -item -compact
792.It
793.Va WITHOUT_INET_SUPPORT
794.El
795.It Va WITHOUT_INET6
796.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6 156932 2006-03-21 07:50:50Z ru
797Set to not build
798programs and libraries related to IPv6 networking.
799When set, it also enforces the following options:
800.Pp
801.Bl -item -compact
802.It
803.Va WITHOUT_INET6_SUPPORT
804.El
805.It Va WITHOUT_INET6_SUPPORT
806.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6_SUPPORT 156932 2006-03-21 07:50:50Z ru
807Set to build libraries, programs, and kernel modules without IPv6 support.
808.It Va WITHOUT_INETD
809.\" from FreeBSD: head/tools/build/options/WITHOUT_INETD 278192 2015-02-04 10:19:32Z ngie
810Set to not build
811.Xr inetd 8 .
812.It Va WITHOUT_INET_SUPPORT
813.\" from FreeBSD: head/tools/build/options/WITHOUT_INET_SUPPORT 221266 2011-04-30 17:58:28Z bz
814Set to build libraries, programs, and kernel modules without IPv4 support.
815.It Va WITHOUT_INSTALLLIB
816.\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 174497 2007-12-09 21:56:21Z dougb
817Set this if you do not want to install optional libraries.
818For example when creating a
819.Xr nanobsd 8
820image.
821.It Va WITH_INSTALL_AS_USER
822.\" from FreeBSD: head/tools/build/options/WITH_INSTALL_AS_USER 238021 2012-07-02 20:24:01Z marcel
823Set to make install targets succeed for non-root users by installing
824files with owner and group attributes set to that of the user running
825the
826.Xr make 1
827command.
828The user still has to set the
829.Va DESTDIR
830variable to point to a directory where the user has write permissions.
831.It Va WITHOUT_IPFILTER
832.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFILTER 156932 2006-03-21 07:50:50Z ru
833Set to not build IP Filter package.
834.It Va WITHOUT_IPFW
835.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFW 183242 2008-09-21 22:02:26Z sam
836Set to not build IPFW tools.
837.It Va WITHOUT_ISCSI
838.\" from FreeBSD: head/tools/build/options/WITHOUT_ISCSI 277675 2015-01-25 04:20:11Z ngie
839Set to not build
840.Xr iscid 8
841and related utilities.
842.It Va WITHOUT_JAIL
843.\" from FreeBSD: head/tools/build/options/WITHOUT_JAIL 249966 2013-04-27 04:09:09Z eadler
844Set to not build tools for the support of jails; e.g.,
845.Xr jail 8 .
846.It Va WITHOUT_KDUMP
847.\" from FreeBSD: head/tools/build/options/WITHOUT_KDUMP 240690 2012-09-19 11:38:37Z zeising
848Set to not build
849.Xr kdump 1
850and
851.Xr truss 1 .
852.It Va WITHOUT_KERBEROS
853.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 174549 2007-12-12 16:42:03Z ru
854Set this if you do not want to build Kerberos 5 (KTH Heimdal).
855When set, it also enforces the following options:
856.Pp
857.Bl -item -compact
858.It
859.Va WITHOUT_KERBEROS_SUPPORT
860.El
861.Pp
862When set, the following options are also in effect:
863.Pp
864.Bl -inset -compact
865.It Va WITHOUT_GSSAPI
866(unless
867.Va WITH_GSSAPI
868is set explicitly)
869.El
870.It Va WITHOUT_KERBEROS_SUPPORT
871.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 251794 2013-06-15 20:29:07Z eadler
872Set to build some programs without Kerberos support, like
873.Xr ssh 1 ,
874.Xr telnet 1 ,
875.Xr sshd 8 ,
876and
877.Xr telnetd 8 .
878.It Va WITHOUT_KERNEL_SYMBOLS
879.\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
880Set to not install kernel symbol files.
881.Bf -symbolic
882This option is recommended for those people who have small root partitions.
883.Ef
884.It Va WITHOUT_KVM
885.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
886Set to not build the
887.Nm libkvm
888library as a part of the base system.
889.Bf -symbolic
890The option has no effect yet.
891.Ef
892When set, it also enforces the following options:
893.Pp
894.Bl -item -compact
895.It
896.Va WITHOUT_KVM_SUPPORT
897.El
898.It Va WITHOUT_KVM_SUPPORT
899.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
900Set to build some programs without optional
901.Nm libkvm
902support.
903.It Va WITHOUT_LDNS
904.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS 255591 2013-09-15 13:11:13Z des
905Setting this variable will prevent the LDNS library from being built.
906When set, it also enforces the following options:
907.Pp
908.Bl -item -compact
909.It
910.Va WITHOUT_LDNS_UTILS
911.It
912.Va WITHOUT_UNBOUND
913.El
914.It Va WITHOUT_LDNS_UTILS
915.\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS_UTILS 255850 2013-09-24 14:33:31Z des
916Setting this variable will prevent building the LDNS utilities
917.Xr drill 1
918and
919.Xr host 1 .
920.It Va WITHOUT_LEGACY_CONSOLE
921.\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 249966 2013-04-27 04:09:09Z eadler
922Set to not build programs that support a legacy PC console; e.g.,
923.Xr kbdcontrol 8
924and
925.Xr vidcontrol 8 .
926.It Va WITHOUT_LIB32
927.\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 274664 2014-11-18 17:06:48Z imp
928On 64-bit platforms, set to not build 32-bit library set and a
929.Nm ld-elf32.so.1
930runtime linker.
931.It Va WITHOUT_LIBCPLUSPLUS
932.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBCPLUSPLUS 246262 2013-02-02 22:42:46Z dim
933Set to avoid building libcxxrt and libc++.
934.It Va WITHOUT_LIBPTHREAD
935.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
936Set to not build the
937.Nm libpthread
938providing library,
939.Nm libthr .
940When set, it also enforces the following options:
941.Pp
942.Bl -item -compact
943.It
944.Va WITHOUT_LIBTHR
945.El
946.It Va WITHOUT_LIBTHR
947.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
948Set to not build the
949.Nm libthr
950(1:1 threading)
951library.
952.It Va WITH_LLDB
953.\" from FreeBSD: head/tools/build/options/WITH_LLDB 255722 2013-09-20 01:52:02Z emaste
954Set to build the LLDB debugger.
955.It Va WITHOUT_LOCALES
956.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
957Set to not build localization files; see
958.Xr locale 1 .
959.It Va WITHOUT_LOCATE
960.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
961Set to not build
962.Xr locate 1
963and related programs.
964.It Va WITHOUT_LPR
965.\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
966Set to not build
967.Xr lpr 1
968and related programs.
969.It Va WITHOUT_LS_COLORS
970.\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
971Set to build
972.Xr ls 1
973without support for colors to distinguish file types.
974.It Va WITHOUT_LZMA_SUPPORT
975.\" from FreeBSD: head/tools/build/options/WITHOUT_LZMA_SUPPORT 245171 2013-01-08 18:37:12Z obrien
976Set to build some programs without optional lzma compression support.
977.It Va WITHOUT_MAIL
978.\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
979Set to not build any mail support (MUA or MTA).
980When set, it also enforces the following options:
981.Pp
982.Bl -item -compact
983.It
984.Va WITHOUT_DMAGENT
985.It
986.Va WITHOUT_MAILWRAPPER
987.It
988.Va WITHOUT_SENDMAIL
989.El
990.It Va WITHOUT_MAILWRAPPER
991.\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
992Set to not build the
993.Xr mailwrapper 8
994MTA selector.
995.It Va WITHOUT_MAKE
996.\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
997Set to not install
998.Xr make 1
999and related support files.
1000.It Va WITHOUT_MAN
1001.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
1002Set to not build manual pages.
1003When set, the following options are also in effect:
1004.Pp
1005.Bl -inset -compact
1006.It Va WITHOUT_MAN_UTILS
1007(unless
1008.Va WITH_MAN_UTILS
1009is set explicitly)
1010.El
1011.It Va WITHOUT_MANCOMPRESS
1012.\" from FreeBSD: head/tools/build/options/WITHOUT_MANCOMPRESS 266752 2014-05-27 15:52:27Z gjb
1013Set to not to install compressed man pages.
1014Only the uncompressed versions will be installed.
1015.It Va WITHOUT_MANDOCDB
1016.\" from FreeBSD: head/tools/build/options/WITHOUT_MANDOCDB 283777 2015-05-30 17:41:37Z bapt
1017Use the
1018.Xr mandoc 1
1019version of
1020.Xr makewhatis 8
1021database and utilities.
1022.It Va WITHOUT_MAN_UTILS
1023.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
1024Set to not build utilities for manual pages,
1025.Xr apropos 1 ,
1026.Xr catman 1 ,
1027.Xr makewhatis 1 ,
1028.Xr man 1 ,
1029.Xr whatis 1 ,
1030.Xr manctl 8 ,
1031and related support files.
1032.It Va WITH_META_MODE
1033.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 290816 2015-11-14 03:24:48Z sjg
1034Create meta files when not doing DIRDEPS_BUILD.
1035The meta files can be useful for debugging.
1036.Pp
1037This must be set in the environment, make command line, or
1038.Pa /etc/src-env.conf ,
1039not
1040.Pa /etc/src.conf .
1041.It Va WITH_NAND
1042.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
1043Set to build the NAND Flash components.
1044.It Va WITHOUT_NDIS
1045.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
1046Set to not build programs and libraries
1047related to NDIS emulation support.
1048.It Va WITHOUT_NETCAT
1049.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
1050Set to not build
1051.Xr nc 1
1052utility.
1053.It Va WITHOUT_NETGRAPH
1054.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
1055Set to not build applications to support
1056.Xr netgraph 4 .
1057When set, it also enforces the following options:
1058.Pp
1059.Bl -item -compact
1060.It
1061.Va WITHOUT_ATM
1062.It
1063.Va WITHOUT_BLUETOOTH
1064.It
1065.Va WITHOUT_NETGRAPH_SUPPORT
1066.El
1067.It Va WITHOUT_NETGRAPH_SUPPORT
1068.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
1069Set to build libraries, programs, and kernel modules without netgraph support.
1070.It Va WITHOUT_NIS
1071.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
1072Set to not build
1073.Xr NIS 8
1074support and related programs.
1075If set, you might need to adopt your
1076.Xr nsswitch.conf 5
1077and remove
1078.Sq nis
1079entries.
1080.It Va WITHOUT_NLS
1081.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
1082Set to not build NLS catalogs.
1083.It Va WITHOUT_NLS_CATALOGS
1084.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
1085Set to not build NLS catalog support for
1086.Xr csh 1 .
1087.It Va WITHOUT_NS_CACHING
1088.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
1089Set to disable name caching in the
1090.Pa nsswitch
1091subsystem.
1092The generic caching daemon,
1093.Xr nscd 8 ,
1094will not be built either if this option is set.
1095.It Va WITHOUT_NTP
1096.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
1097Set to not build
1098.Xr ntpd 8
1099and related programs.
1100.It Va WITH_OFED
1101.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
1102Set to build the
1103.Dq "OpenFabrics Enterprise Distribution"
1104Infiniband software stack.
1105.It Va WITH_OPENLDAP
1106.\" from FreeBSD: head/tools/build/options/WITH_OPENLDAP 264902 2014-04-24 23:17:31Z imp
1107Enable building openldap support for kerberos.
1108.It Va WITHOUT_OPENSSH
1109.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
1110Set to not build OpenSSH.
1111.It Va WITHOUT_OPENSSL
1112.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
1113Set to not build OpenSSL.
1114When set, it also enforces the following options:
1115.Pp
1116.Bl -item -compact
1117.It
1118.Va WITHOUT_KERBEROS
1119.It
1120.Va WITHOUT_KERBEROS_SUPPORT
1121.It
1122.Va WITHOUT_OPENSSH
1123.El
1124.Pp
1125When set, the following options are also in effect:
1126.Pp
1127.Bl -inset -compact
1128.It Va WITHOUT_GSSAPI
1129(unless
1130.Va WITH_GSSAPI
1131is set explicitly)
1132.El
1133.It Va WITHOUT_PAM
1134.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
1135Set to not build PAM library and modules.
1136.Bf -symbolic
1137This option is deprecated and does nothing.
1138.Ef
1139When set, it also enforces the following options:
1140.Pp
1141.Bl -item -compact
1142.It
1143.Va WITHOUT_PAM_SUPPORT
1144.El
1145.It Va WITHOUT_PAM_SUPPORT
1146.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
1147Set to build some programs without PAM support, particularly
1148.Xr ftpd 8
1149and
1150.Xr ppp 8 .
1151.It Va WITHOUT_PC_SYSINSTALL
1152.\" from FreeBSD: head/tools/build/options/WITHOUT_PC_SYSINSTALL 245606 2013-01-18 15:57:09Z eadler
1153Set to not build
1154.Xr pc-sysinstall 8
1155and related programs.
1156.It Va WITHOUT_PF
1157.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
1158Set to not build PF firewall package.
1159When set, it also enforces the following options:
1160.Pp
1161.Bl -item -compact
1162.It
1163.Va WITHOUT_AUTHPF
1164.El
1165.It Va WITHOUT_PKGBOOTSTRAP
1166.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 258924 2013-12-04 15:58:42Z bdrewery
1167Set to not build
1168.Xr pkg 7
1169bootstrap tool.
1170.It Va WITHOUT_PMC
1171.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
1172Set to not build
1173.Xr pmccontrol 8
1174and related programs.
1175.It Va WITHOUT_PORTSNAP
1176.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
1177Set to not build or install
1178.Xr portsnap 8
1179and related files.
1180.It Va WITHOUT_PPP
1181.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
1182Set to not build
1183.Xr ppp 8
1184and related programs.
1185.It Va WITHOUT_PROFILE
1186.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
1187Set to avoid compiling profiled libraries.
1188.It Va WITHOUT_QUOTAS
1189.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 183242 2008-09-21 22:02:26Z sam
1190Set to not build
1191.Xr quota 8
1192and related programs.
1193.It Va WITHOUT_RADIUS_SUPPORT
1194.\" from FreeBSD: head/tools/build/options/WITHOUT_RADIUS_SUPPORT 278182 2015-02-04 06:53:45Z ngie
1195Set to not build radius support into various applications, like
1196.Xr pam_radius 8
1197and
1198.Xr ppp 8 .
1199.It Va WITHOUT_RBOOTD
1200.\" from FreeBSD: head/tools/build/options/WITHOUT_RBOOTD 278192 2015-02-04 10:19:32Z ngie
1201Set to not build or install
1202.Xr rbootd 8 .
1203.It Va WITHOUT_RCMDS
1204.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
1205Disable building of the
1206.Bx
1207r-commands.
1208This includes
1209.Xr rlogin 1 ,
1210.Xr rsh 1 ,
1211etc.
1212.It Va WITHOUT_RCS
1213.\" from FreeBSD: head/tools/build/options/WITHOUT_RCS 275138 2014-11-26 20:43:09Z gjb
1214Set to not build
1215.Xr rcs 1 ,
1216.Xr etcupdate 8 ,
1217and related utilities.
1218.It Va WITHOUT_RESCUE
1219.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
1220Set to not build
1221.Xr rescue 8 .
1222.It Va WITHOUT_ROUTED
1223.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
1224Set to not build
1225.Xr routed 8
1226utility.
1227.It Va WITHOUT_SENDMAIL
1228.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
1229Set to not build
1230.Xr sendmail 8
1231and related programs.
1232.It Va WITHOUT_SETUID_LOGIN
1233.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
1234Set this to disable the installation of
1235.Xr login 1
1236as a set-user-ID root program.
1237.It Va WITHOUT_SHAREDOCS
1238.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
1239Set to not build the
1240.Bx 4.4
1241legacy docs.
1242.It Va WITH_SHARED_TOOLCHAIN
1243.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
1244Set to build the toolchain binaries shared.
1245The set includes
1246.Xr cc 1 ,
1247.Xr make 1
1248and necessary utilities like assembler, linker and library archive manager.
1249.It Va WITH_SORT_THREADS
1250.\" from FreeBSD: head/tools/build/options/WITH_SORT_THREADS 264158 2014-04-05 18:00:45Z imp
1251Set to enable threads in
1252.Xr sort 1 .
1253.It Va WITHOUT_SOURCELESS
1254.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
1255Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1256When set, it also enforces the following options:
1257.Pp
1258.Bl -item -compact
1259.It
1260.Va WITHOUT_SOURCELESS_HOST
1261.It
1262.Va WITHOUT_SOURCELESS_UCODE
1263.El
1264.It Va WITHOUT_SOURCELESS_HOST
1265.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
1266Set to not build kernel modules that include sourceless native code for host CPU.
1267.It Va WITHOUT_SOURCELESS_UCODE
1268.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
1269Set to not build kernel modules that include sourceless microcode.
1270.It Va WITHOUT_SSP
1271.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
1272Set to not build world with propolice stack smashing protection.
1273.It Va WITH_STAGING
1274.\" from FreeBSD: head/tools/build/options/WITH_STAGING 290816 2015-11-14 03:24:48Z sjg
1275Enable staging of files to a stage tree.
1276This can be best thought of as auto-install to
1277.Va DESTDIR
1278with some extra meta data to ensure dependencies can be tracked.
1279Depends on
1280.Va WITH_DIRDEPS_BUILD .
1281When set, the following options are also in effect:
1282.Pp
1283.Bl -inset -compact
1284.It Va WITH_STAGING_MAN
1285(unless
1286.Va WITHOUT_STAGING_MAN
1287is set explicitly)
1288.It Va WITH_STAGING_PROG
1289(unless
1290.Va WITHOUT_STAGING_PROG
1291is set explicitly)
1292.El
1293.Pp
1294This must be set in the environment, make command line, or
1295.Pa /etc/src-env.conf ,
1296not
1297.Pa /etc/src.conf .
1298.It Va WITH_STAGING_MAN
1299.\" from FreeBSD: head/tools/build/options/WITH_STAGING_MAN 284708 2015-06-22 20:21:57Z sjg
1300Enable staging of MAN pages to stage tree.
1301.It Va WITH_STAGING_PROG
1302.\" from FreeBSD: head/tools/build/options/WITH_STAGING_PROG 284708 2015-06-22 20:21:57Z sjg
1303Enable staging of PROGs to stage tree.
1304.It Va WITH_STALE_STAGED
1305.\" from FreeBSD: head/tools/build/options/WITH_STALE_STAGED 284708 2015-06-22 20:21:57Z sjg
1306Check staged files are not stale.
1307.It Va WITH_SVN
1308.\" from FreeBSD: head/tools/build/options/WITH_SVN 252561 2013-07-03 12:36:47Z zeising
1309Set to install
1310.Xr svnlite 1
1311as
1312.Xr svn 1 .
1313.It Va WITHOUT_SVNLITE
1314.\" from FreeBSD: head/tools/build/options/WITHOUT_SVNLITE 252561 2013-07-03 12:36:47Z zeising
1315Set to not build
1316.Xr svnlite 1
1317and related programs.
1318.It Va WITHOUT_SYMVER
1319.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
1320Set to disable symbol versioning when building shared libraries.
1321.It Va WITHOUT_SYSCONS
1322.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
1323Set to not build
1324.Xr syscons 4
1325support files such as keyboard maps, fonts, and screen output maps.
1326.It Va WITH_SYSROOT
1327.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 290816 2015-11-14 03:24:48Z sjg
1328Enable use of sysroot during build.
1329Depends on
1330.Va WITH_DIRDEPS_BUILD .
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 WITHOUT_TALK
1337.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie
1338Set to not build or install
1339.Xr talk 1
1340and
1341.Xr talkd 8 .
1342.It Va WITHOUT_TCP_WRAPPERS
1343.\" from FreeBSD: head/tools/build/options/WITHOUT_TCP_WRAPPERS 278192 2015-02-04 10:19:32Z ngie
1344Set to not build or install
1345.Xr tcpd 8 ,
1346and related utilities.
1347.It Va WITHOUT_TCSH
1348.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
1349Set to not build and install
1350.Pa /bin/csh
1351(which is
1352.Xr tcsh 1 ) .
1353.It Va WITHOUT_TELNET
1354.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 183242 2008-09-21 22:02:26Z sam
1355Set to not build
1356.Xr telnet 8
1357and related programs.
1358.It Va WITHOUT_TESTS
1359.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS 268778 2014-07-16 21:40:11Z jmmv
1360Set to not build nor install the
1361.Fx
1362Test Suite in
1363.Pa /usr/tests/ .
1364See
1365.Xr tests 7
1366for more details.
1367This also disables the build of all test-related dependencies, including ATF.
1368When set, it also enforces the following options:
1369.Pp
1370.Bl -item -compact
1371.It
1372.Va WITHOUT_DTRACE_TESTS
1373.It
1374.Va WITHOUT_TESTS_SUPPORT
1375.El
1376.It Va WITHOUT_TESTS_SUPPORT
1377.\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS_SUPPORT 274665 2014-11-18 17:06:50Z imp
1378Set to disables the build of all test-related dependencies, including ATF.
1379.It Va WITHOUT_TEXTPROC
1380.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
1381Set to not build
1382programs used for text processing.
1383When set, it also enforces the following options:
1384.Pp
1385.Bl -item -compact
1386.It
1387.Va WITHOUT_GROFF
1388.El
1389.It Va WITHOUT_TFTP
1390.\" from FreeBSD: head/tools/build/options/WITHOUT_TFTP 278192 2015-02-04 10:19:32Z ngie
1391Set to not build or install
1392.Xr tftp 1
1393and
1394.Xr tftpd 8 .
1395.It Va WITHOUT_TIMED
1396.\" from FreeBSD: head/tools/build/options/WITHOUT_TIMED 278192 2015-02-04 10:19:32Z ngie
1397Set to not build or install
1398.Xr timed 8 .
1399.It Va WITHOUT_TOOLCHAIN
1400.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 273172 2014-10-16 15:55:13Z brooks
1401Set to not install header or
1402programs used for program development,
1403compilers, debuggers etc.
1404.Bf -symbolic
1405The option does not work for build targets.
1406.Ef
1407When set, it also enforces the following options:
1408.Pp
1409.Bl -item -compact
1410.It
1411.Va WITHOUT_BINUTILS
1412.It
1413.Va WITHOUT_CLANG
1414.It
1415.Va WITHOUT_CLANG_EXTRAS
1416.It
1417.Va WITHOUT_CLANG_FULL
1418.It
1419.Va WITHOUT_GCC
1420.It
1421.Va WITHOUT_GDB
1422.It
1423.Va WITHOUT_INCLUDES
1424.El
1425.It Va WITHOUT_UNBOUND
1426.\" from FreeBSD: head/tools/build/options/WITHOUT_UNBOUND 255597 2013-09-15 14:51:23Z des
1427Set to not build
1428.Xr unbound 8
1429and related programs.
1430.It Va WITHOUT_USB
1431.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1432Set to not build USB-related programs and libraries.
1433.It Va WITHOUT_USB_GADGET_EXAMPLES
1434.\" from FreeBSD: head/tools/build/options/WITHOUT_USB_GADGET_EXAMPLES 274665 2014-11-18 17:06:50Z imp
1435Set to build USB gadget kernel modules.
1436.It Va WITHOUT_UTMPX
1437.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1438Set to not build user accounting tools such as
1439.Xr last 1 ,
1440.Xr users 1 ,
1441.Xr who 1 ,
1442.Xr ac 8 ,
1443.Xr lastlogin 8
1444and
1445.Xr utx 8 .
1446.It Va WITHOUT_VI
1447.\" from FreeBSD: head/tools/build/options/WITHOUT_VI 264903 2014-04-24 23:17:40Z imp
1448Set to not build and install vi, view, ex and related programs.
1449.It Va WITHOUT_VT
1450.\" from FreeBSD: head/tools/build/options/WITHOUT_VT 268022 2014-06-30 00:20:12Z emaste
1451Set to not build
1452.Xr vt 4
1453support files (fonts and keymaps).
1454.It Va WITHOUT_WARNS
1455.\" from FreeBSD: head/tools/build/options/WITHOUT_WARNS 276559 2015-01-02 18:57:58Z bapt
1456Set this to not add warning flags to the compiler invocations.
1457Useful as a temporary workaround when code enters the tree
1458which triggers warnings in environments that differ from the
1459original developer.
1460.It Va WITHOUT_WIRELESS
1461.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1462Set to not build programs used for 802.11 wireless networks; especially
1463.Xr wpa_supplicant 8
1464and
1465.Xr hostapd 8 .
1466When set, it also enforces the following options:
1467.Pp
1468.Bl -item -compact
1469.It
1470.Va WITHOUT_WIRELESS_SUPPORT
1471.El
1472.It Va WITHOUT_WIRELESS_SUPPORT
1473.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1474Set to build libraries, programs, and kernel modules without
1475802.11 wireless support.
1476.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1477.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1478Build
1479.Xr wpa_supplicant 8
1480without support for the IEEE 802.1X protocol and without
1481support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1482protocols (usable only via 802.1X).
1483.It Va WITHOUT_ZFS
1484.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1485Set to not build ZFS file system.
1486.It Va WITHOUT_ZONEINFO
1487.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1488Set to not build the timezone database.
1489.El
1490.Sh FILES
1491.Bl -tag -compact -width Pa
1492.It Pa /etc/src.conf
1493.It Pa /etc/src-env.conf
1494.It Pa /usr/share/mk/bsd.own.mk
1495.El
1496.Sh SEE ALSO
1497.Xr make 1 ,
1498.Xr make.conf 5 ,
1499.Xr build 7 ,
1500.Xr ports 7
1501.Sh HISTORY
1502The
1503.Nm
1504file appeared in
1505.Fx 7.0 .
1506.Sh AUTHORS
1507This manual page was autogenerated.
1508