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