xref: /freebsd/share/man/man5/src.conf.5 (revision 89498fdf4174b08bb67d684d14886539aff698b4)
1.\" DO NOT EDIT-- this file is automatically generated.
2.\" from FreeBSD: head/tools/build/options/makeman 236279 2012-05-30 02:37:20Z gjb
3.\" $FreeBSD$
4.Dd September 19, 2012
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 values of variables are ignored regardless of their setting;
69even if they would be set to
70.Dq Li FALSE
71or
72.Dq Li NO .
73Just the existence of an option will cause
74it to be honoured by
75.Xr make 1 .
76.Pp
77The following list provides a name and short description for variables
78that can be used for source builds.
79.Bl -tag -width indent
80.It Va WITHOUT_ACCT
81.\" from FreeBSD: head/tools/build/options/WITHOUT_ACCT 223201 2011-06-17 20:47:44Z ed
82Set to not build process accounting tools such as
83.Xr accton 8
84and
85.Xr sa 8 .
86.It Va WITHOUT_ACPI
87.\" from FreeBSD: head/tools/build/options/WITHOUT_ACPI 156932 2006-03-21 07:50:50Z ru
88Set to not build
89.Xr acpiconf 8 ,
90.Xr acpidump 8
91and related programs.
92.It Va WITHOUT_AMD
93.\" from FreeBSD: head/tools/build/options/WITHOUT_AMD 183242 2008-09-21 22:02:26Z sam
94Set to not build
95.Xr amd 8 ,
96and related programs.
97.It Va WITHOUT_APM
98.\" from FreeBSD: head/tools/build/options/WITHOUT_APM 183242 2008-09-21 22:02:26Z sam
99Set to not build
100.Xr apm 8 ,
101.Xr apmd 8
102and related programs.
103.It Va WITHOUT_ASSERT_DEBUG
104.\" from FreeBSD: head/tools/build/options/WITHOUT_ASSERT_DEBUG 162215 2006-09-11 13:55:27Z ru
105Set to compile programs and libraries without the
106.Xr assert 3
107checks.
108.It Va WITHOUT_AT
109.\" from FreeBSD: head/tools/build/options/WITHOUT_AT 183242 2008-09-21 22:02:26Z sam
110Set to not build
111.Xr at 1
112and related utilities.
113.It Va WITHOUT_ATM
114.\" from FreeBSD: head/tools/build/options/WITHOUT_ATM 156932 2006-03-21 07:50:50Z ru
115Set to not build
116programs and libraries related to ATM networking.
117.It Va WITHOUT_AUDIT
118.\" from FreeBSD: head/tools/build/options/WITHOUT_AUDIT 156932 2006-03-21 07:50:50Z ru
119Set to not build audit support into system programs.
120.It Va WITHOUT_AUTHPF
121.\" from FreeBSD: head/tools/build/options/WITHOUT_AUTHPF 156932 2006-03-21 07:50:50Z ru
122Set to not build
123.Xr authpf 8 .
124.It Va WITHOUT_BIND
125.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND 156932 2006-03-21 07:50:50Z ru
126Setting this variable will prevent any part of BIND from being built.
127When set, it also enforces the following options:
128.Pp
129.Bl -item -compact
130.It
131.Va WITHOUT_BIND_DNSSEC
132.It
133.Va WITHOUT_BIND_ETC
134.It
135.Va WITHOUT_BIND_LIBS
136.It
137.Va WITHOUT_BIND_LIBS_LWRES
138.It
139.Va WITHOUT_BIND_MTREE
140.It
141.Va WITHOUT_BIND_NAMED
142.It
143.Va WITHOUT_BIND_UTILS
144.El
145.It Va WITHOUT_BIND_DNSSEC
146.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_DNSSEC 156932 2006-03-21 07:50:50Z ru
147Set to avoid building or installing the DNSSEC related binaries,
148.Xr dnssec-keygen 8
149and
150.Xr dnssec-signzone 8 .
151.It Va WITHOUT_BIND_ETC
152.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_ETC 156932 2006-03-21 07:50:50Z ru
153Set to avoid installing the default files to
154.Pa /var/named/etc/namedb .
155.It Va WITH_BIND_IDN
156.\" from FreeBSD: head/tools/build/options/WITH_BIND_IDN 193280 2009-06-01 21:58:59Z dougb
157Set to enable IDN support for dig, host, and nslookup.
158This requires ports/dns/idnkit to be installed in /usr/local.
159.It Va WITH_BIND_LARGE_FILE
160.\" from FreeBSD: head/tools/build/options/WITH_BIND_LARGE_FILE 193280 2009-06-01 21:58:59Z dougb
161Set to enable 64-bit file support.
162.It Va WITH_BIND_LIBS
163.\" from FreeBSD: head/tools/build/options/WITH_BIND_LIBS 193280 2009-06-01 21:58:59Z dougb
164Set to install BIND libraries and include files.
165.It Va WITHOUT_BIND_LIBS_LWRES
166.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_LIBS_LWRES 156932 2006-03-21 07:50:50Z ru
167Set to avoid installing the lightweight resolver library in
168.Pa /usr/lib .
169.It Va WITHOUT_BIND_MTREE
170.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_MTREE 157717 2006-04-13 10:37:29Z ru
171Set to avoid running
172.Xr mtree 8
173to create the chroot directory structure under
174.Pa /var/named ,
175and avoid creating an
176.Pa /etc/namedb
177symlink to the chroot directory.
178When set, it also enforces the following options:
179.Pp
180.Bl -item -compact
181.It
182.Va WITHOUT_BIND_ETC
183.El
184.It Va WITHOUT_BIND_NAMED
185.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_NAMED 156932 2006-03-21 07:50:50Z ru
186Set to avoid building or installing
187.Xr named 8 ,
188.Xr named.reload 8 ,
189.Xr named-checkconf 8 ,
190.Xr named-checkzone 8 ,
191.Xr rndc 8 ,
192and
193.Xr rndc-confgen 8 .
194.It Va WITH_BIND_SIGCHASE
195.\" from FreeBSD: head/tools/build/options/WITH_BIND_SIGCHASE 193280 2009-06-01 21:58:59Z dougb
196Set to enable DNSSEC validation support for dig, host, and nslookup.
197.It Va WITHOUT_BIND_UTILS
198.\" from FreeBSD: head/tools/build/options/WITHOUT_BIND_UTILS 156932 2006-03-21 07:50:50Z ru
199Set to avoid building or installing the BIND userland utilities,
200.Xr dig 1 ,
201.Xr host 1 ,
202.Xr nslookup 1 ,
203and
204.Xr nsupdate 8 .
205.It Va WITH_BIND_XML
206.\" from FreeBSD: head/tools/build/options/WITH_BIND_XML 193280 2009-06-01 21:58:59Z dougb
207Set to enable the http statistics interface for named.
208This requires ports/textproc/libxml2 to be installed in /usr/local.
209.It Va WITHOUT_BINUTILS
210.\" from FreeBSD: head/tools/build/options/WITHOUT_BINUTILS 235342 2012-05-12 16:12:36Z gjb
211Set to not install binutils (as, c++-filt, gconv, gnu-ar, gnu-randlib,
212ld, nm, objcopy, objdump, readelf, size and strip).
213.Bf -symbolic
214The option does not generally work for build targets, unless some alternative
215toolchain is enabled.
216.Ef
217.It Va WITHOUT_BLUETOOTH
218.\" from FreeBSD: head/tools/build/options/WITHOUT_BLUETOOTH 156932 2006-03-21 07:50:50Z ru
219Set to not build Bluetooth related kernel modules, programs and libraries.
220.It Va WITHOUT_BOOT
221.\" from FreeBSD: head/tools/build/options/WITHOUT_BOOT 156932 2006-03-21 07:50:50Z ru
222Set to not build the boot blocks and loader.
223.It Va WITH_BSDCONFIG
224.\" from FreeBSD: head/tools/build/options/WITH_BSDCONFIG 238448 2012-07-14 10:17:47Z zeising
225Set to install bsdconfig(8), a BSD-licensed configuration/management utility.
226.It Va WITHOUT_BSD_CPIO
227.\" from FreeBSD: head/tools/build/options/WITHOUT_BSD_CPIO 179813 2008-06-16 05:48:15Z dougb
228Set to not build the BSD licensed version of cpio based on
229.Xr libarchive 3 .
230.It Va WITH_BSD_GREP
231.\" from FreeBSD: head/tools/build/options/WITH_BSD_GREP 222273 2011-05-25 01:04:12Z obrien
232Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
233.It Va WITHOUT_BSNMP
234.\" from FreeBSD: head/tools/build/options/WITHOUT_BSNMP 183306 2008-09-23 16:15:42Z sam
235Set to not build or install
236.Xr bsnmpd 1
237and related libraries and data files.
238.It Va WITHOUT_BZIP2
239.\" from FreeBSD: head/tools/build/options/WITHOUT_BZIP2 174550 2007-12-12 16:43:17Z ru
240Set to not build contributed bzip2 software as a part of the base system.
241.Bf -symbolic
242The option has no effect yet.
243.Ef
244When set, it also enforces the following options:
245.Pp
246.Bl -item -compact
247.It
248.Va WITHOUT_BZIP2_SUPPORT
249.El
250.It Va WITHOUT_BZIP2_SUPPORT
251.\" from FreeBSD: head/tools/build/options/WITHOUT_BZIP2_SUPPORT 166255 2007-01-26 10:19:08Z delphij
252Set to build some programs without optional bzip2 support.
253.It Va WITHOUT_CALENDAR
254.\" from FreeBSD: head/tools/build/options/WITHOUT_CALENDAR 156932 2006-03-21 07:50:50Z ru
255Set to not build
256.Xr calendar 1 .
257.It Va WITHOUT_CAPSICUM
258.\" from FreeBSD: head/tools/build/options/WITHOUT_CAPSICUM 229319 2012-01-02 21:57:58Z rwatson
259Set to not build Capsicum support into system programs.
260.It Va WITHOUT_CDDL
261.\" from FreeBSD: head/tools/build/options/WITHOUT_CDDL 163861 2006-11-01 09:02:11Z jb
262Set to not build code licensed under Sun's CDDL.
263When set, it also enforces the following options:
264.Pp
265.Bl -item -compact
266.It
267.Va WITHOUT_CTF
268.It
269.Va WITHOUT_ZFS
270.El
271.It Va WITHOUT_CLANG
272.\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG 208971 2010-06-10 06:20:26Z ed
273Set to not build the Clang C/C++ compiler.
274.Pp
275It is a default setting on
276arm/arm, arm/armeb, arm/armv6, arm/armv6eb, ia64/ia64, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32 and sparc64/sparc64.
277When set, it also enforces the following options:
278.Pp
279.Bl -item -compact
280.It
281.Va WITHOUT_CLANG_EXTRAS
282.It
283.Va WITHOUT_CLANG_IS_CC
284.El
285.It Va WITH_CLANG
286.\" from FreeBSD: head/tools/build/options/WITH_CLANG 221730 2011-05-10 11:14:40Z ru
287Set to build the Clang C/C++ compiler.
288.Pp
289It is a default setting on
290amd64/amd64, i386/i386, pc98/i386, powerpc/powerpc and powerpc/powerpc64.
291.It Va WITH_CLANG_EXTRAS
292.\" from FreeBSD: head/tools/build/options/WITH_CLANG_EXTRAS 231057 2012-02-05 23:56:22Z dim
293Set to build additional clang and llvm tools, such as bugpoint.
294.It Va WITH_CLANG_IS_CC
295.\" from FreeBSD: head/tools/build/options/WITH_CLANG_IS_CC 235342 2012-05-12 16:12:36Z gjb
296Set to install the Clang C/C++ compiler as
297.Pa /usr/bin/cc ,
298.Pa /usr/bin/c++
299and
300.Pa /usr/bin/cpp .
301.It Va WITHOUT_CPP
302.\" from FreeBSD: head/tools/build/options/WITHOUT_CPP 156932 2006-03-21 07:50:50Z ru
303Set to not build
304.Xr cpp 1 .
305.It Va WITHOUT_CRYPT
306.\" from FreeBSD: head/tools/build/options/WITHOUT_CRYPT 156932 2006-03-21 07:50:50Z ru
307Set to not build any crypto code.
308When set, it also enforces the following options:
309.Pp
310.Bl -item -compact
311.It
312.Va WITHOUT_KERBEROS
313.It
314.Va WITHOUT_KERBEROS_SUPPORT
315.It
316.Va WITHOUT_OPENSSH
317.It
318.Va WITHOUT_OPENSSL
319.El
320.Pp
321When set, the following options are also in effect:
322.Pp
323.Bl -inset -compact
324.It Va WITHOUT_GSSAPI
325(unless
326.Va WITH_GSSAPI
327is set explicitly)
328.El
329.It Va WITH_CTF
330.\" from FreeBSD: head/tools/build/options/WITH_CTF 228159 2011-11-30 18:22:44Z fjoe
331Set to compile with CTF (Compact C Type Format) data.
332CTF data encapsulates a reduced form of debugging information
333similar to DWARF and the venerable stabs and is required for DTrace.
334.It Va WITHOUT_CTM
335.\" from FreeBSD: head/tools/build/options/WITHOUT_CTM 183242 2008-09-21 22:02:26Z sam
336Set to not build
337.Xr ctm 1
338and related utilities.
339.It Va WITHOUT_CVS
340.\" from FreeBSD: head/tools/build/options/WITHOUT_CVS 156932 2006-03-21 07:50:50Z ru
341Set to not build CVS.
342.It Va WITHOUT_CXX
343.\" from FreeBSD: head/tools/build/options/WITHOUT_CXX 220402 2011-04-06 20:19:07Z uqs
344Set to not build
345.Xr g++ 1
346and related libraries.
347It will also prevent building of
348.Xr gperf 1
349and
350.Xr devd 8 .
351When set, it also enforces the following options:
352.Pp
353.Bl -item -compact
354.It
355.Va WITHOUT_CLANG
356.It
357.Va WITHOUT_CLANG_IS_CC
358.It
359.Va WITHOUT_GROFF
360.El
361.It Va WITHOUT_DICT
362.\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru
363Set to not build the Webster dictionary files.
364.It Va WITHOUT_DYNAMICROOT
365.\" from FreeBSD: head/tools/build/options/WITHOUT_DYNAMICROOT 156932 2006-03-21 07:50:50Z ru
366Set this if you do not want to link
367.Pa /bin
368and
369.Pa /sbin
370dynamically.
371.It Va WITHOUT_ED_CRYPTO
372.\" from FreeBSD: head/tools/build/options/WITHOUT_ED_CRYPTO 235660 2012-05-19 20:05:27Z marcel
373Set to build
374.Xr ed 1
375without support for encryption/decryption.
376.It Va WITHOUT_EXAMPLES
377.\" from FreeBSD: head/tools/build/options/WITHOUT_EXAMPLES 156938 2006-03-21 09:06:24Z ru
378Set to avoid installing examples to
379.Pa /usr/share/examples/ .
380.It Va WITHOUT_FDT
381.\" from FreeBSD: head/tools/build/options/WITHOUT_FDT 221539 2011-05-06 19:10:27Z ru
382Set to not build Flattened Device Tree support as part of the base system.
383This includes the device tree compiler (dtc) and libfdt support library.
384.Pp
385It is a default setting on
386amd64/amd64, i386/i386, ia64/ia64, pc98/i386 and sparc64/sparc64.
387.It Va WITH_FDT
388.\" from FreeBSD: head/tools/build/options/WITH_FDT 221730 2011-05-10 11:14:40Z ru
389Set to build Flattened Device Tree support as part of the base system.
390This includes the device tree compiler (dtc) and libfdt support library.
391.Pp
392It is a default setting on
393arm/arm, arm/armeb, arm/armv6, arm/armv6eb, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc and powerpc/powerpc64.
394.It Va WITHOUT_FLOPPY
395.\" from FreeBSD: head/tools/build/options/WITHOUT_FLOPPY 221540 2011-05-06 19:13:03Z ru
396Set to not build or install programs
397for operating floppy disk driver.
398.It Va WITHOUT_FORTH
399.\" from FreeBSD: head/tools/build/options/WITHOUT_FORTH 156932 2006-03-21 07:50:50Z ru
400Set to build bootloaders without Forth support.
401.It Va WITHOUT_FP_LIBC
402.\" from FreeBSD: head/tools/build/options/WITHOUT_FP_LIBC 156932 2006-03-21 07:50:50Z ru
403Set to build
404.Nm libc
405without floating-point support.
406.It Va WITHOUT_FREEBSD_UPDATE
407.\" from FreeBSD: head/tools/build/options/WITHOUT_FREEBSD_UPDATE 183242 2008-09-21 22:02:26Z sam
408Set to not build
409.Xr freebsd-update 8 .
410.It Va WITHOUT_GAMES
411.\" from FreeBSD: head/tools/build/options/WITHOUT_GAMES 156932 2006-03-21 07:50:50Z ru
412Set to not build games.
413.It Va WITHOUT_GCC
414.\" from FreeBSD: head/tools/build/options/WITHOUT_GCC 222090 2011-05-19 05:13:25Z imp
415Set to not install gcc and g++.
416.Bf -symbolic
417The option does not generally work for build targets, unless some alternative
418toolchain is enabled.
419.Ef
420.It Va WITHOUT_GCOV
421.\" from FreeBSD: head/tools/build/options/WITHOUT_GCOV 156932 2006-03-21 07:50:50Z ru
422Set to not build the
423.Xr gcov 1
424tool.
425.It Va WITHOUT_GDB
426.\" from FreeBSD: head/tools/build/options/WITHOUT_GDB 156932 2006-03-21 07:50:50Z ru
427Set to not build
428.Xr gdb 1 .
429.It Va WITHOUT_GNU
430.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU 174550 2007-12-12 16:43:17Z ru
431Set to not build contributed GNU software as a part of the base system.
432This option can be useful if the system built must not contain any code
433covered by the GNU Public License due to legal reasons.
434.Bf -symbolic
435The option has no effect yet.
436.Ef
437When set, it also enforces the following options:
438.Pp
439.Bl -item -compact
440.It
441.Va WITHOUT_GNU_SUPPORT
442.El
443.It Va WITH_GNU_SORT
444.\" from FreeBSD: head/tools/build/options/WITH_GNU_SORT 237629 2012-06-27 05:59:01Z gabor
445Install GNU-licensed sort as 'sort' instead of BSD sort.
446.It Va WITHOUT_GNU_SUPPORT
447.\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_SUPPORT 156932 2006-03-21 07:50:50Z ru
448Set to build some programs without optional GNU support.
449.It Va WITHOUT_GPIB
450.\" from FreeBSD: head/tools/build/options/WITHOUT_GPIB 156932 2006-03-21 07:50:50Z ru
451Set to not build GPIB bus support.
452.It Va WITHOUT_GPIO
453.\" from FreeBSD: head/tools/build/options/WITHOUT_GPIO 228081 2011-11-28 17:54:34Z dim
454Set to not build
455.Xr gpioctl 8
456as part of the base system.
457.It Va WITHOUT_GROFF
458.\" from FreeBSD: head/tools/build/options/WITHOUT_GROFF 218941 2011-02-22 08:13:49Z uqs
459Set to not build
460.Xr groff 1
461and
462.Xr vgrind 1 .
463You should consider installing the textproc/groff port to not break
464.Xr man 1 .
465.It Va WITHOUT_GSSAPI
466.\" from FreeBSD: head/tools/build/options/WITHOUT_GSSAPI 174548 2007-12-12 16:39:32Z ru
467Set to not build libgssapi.
468.It Va WITH_HESIOD
469.\" from FreeBSD: head/tools/build/options/WITH_HESIOD 156932 2006-03-21 07:50:50Z ru
470Set to build Hesiod support.
471.It Va WITHOUT_HTML
472.\" from FreeBSD: head/tools/build/options/WITHOUT_HTML 156932 2006-03-21 07:50:50Z ru
473Set to not build HTML docs.
474.It Va WITH_ICONV
475.\" from FreeBSD: head/tools/build/options/WITH_ICONV 219020 2011-02-25 00:10:26Z gabor
476Set to build iconv as part of libc.
477.It Va WITH_IDEA
478.\" from FreeBSD: head/tools/build/options/WITH_IDEA 156932 2006-03-21 07:50:50Z ru
479Set to build the IDEA encryption code.
480This code is patented in the USA and many European countries.
481It is
482.Em "YOUR RESPONSIBILITY"
483to determine if you can legally use IDEA.
484.It Va WITHOUT_INET
485.\" from FreeBSD: head/tools/build/options/WITHOUT_INET 221266 2011-04-30 17:58:28Z bz
486Set to not build programs and libraries related to IPv4 networking.
487When set, it also enforces the following options:
488.Pp
489.Bl -item -compact
490.It
491.Va WITHOUT_INET_SUPPORT
492.El
493.It Va WITHOUT_INET6
494.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6 156932 2006-03-21 07:50:50Z ru
495Set to not build
496programs and libraries related to IPv6 networking.
497When set, it also enforces the following options:
498.Pp
499.Bl -item -compact
500.It
501.Va WITHOUT_INET6_SUPPORT
502.El
503.It Va WITHOUT_INET6_SUPPORT
504.\" from FreeBSD: head/tools/build/options/WITHOUT_INET6_SUPPORT 156932 2006-03-21 07:50:50Z ru
505Set to build libraries, programs, and kernel modules without IPv6 support.
506.It Va WITHOUT_INET_SUPPORT
507.\" from FreeBSD: head/tools/build/options/WITHOUT_INET_SUPPORT 221266 2011-04-30 17:58:28Z bz
508Set to build libraries, programs, and kernel modules without IPv4 support.
509.It Va WITHOUT_INFO
510.\" from FreeBSD: head/tools/build/options/WITHOUT_INFO 156932 2006-03-21 07:50:50Z ru
511Set to not make or install
512.Xr info 5
513files.
514.It Va WITHOUT_INSTALLLIB
515.\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 174497 2007-12-09 21:56:21Z dougb
516Set this if you do not want to install optional libraries.
517For example when creating a
518.Xr nanobsd 8
519image.
520.It Va WITH_INSTALL_AS_USER
521.\" from FreeBSD: head/tools/build/options/WITH_INSTALL_AS_USER 238021 2012-07-02 20:24:01Z marcel
522Set to make install targets succeed for non-root users by installing
523files with owner and group attributes set to that of the user running
524the
525.Xr make 1
526command.
527The user still has to set the
528.Va DESTDIR
529variable to point to a directory where the user has write permissions.
530.It Va WITHOUT_IPFILTER
531.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFILTER 156932 2006-03-21 07:50:50Z ru
532Set to not build IP Filter package.
533.It Va WITHOUT_IPFW
534.\" from FreeBSD: head/tools/build/options/WITHOUT_IPFW 183242 2008-09-21 22:02:26Z sam
535Set to not build IPFW tools.
536.It Va WITHOUT_IPX
537.\" from FreeBSD: head/tools/build/options/WITHOUT_IPX 156932 2006-03-21 07:50:50Z ru
538Set to not build programs and libraries related to IPX networking.
539When set, it also enforces the following options:
540.Pp
541.Bl -item -compact
542.It
543.Va WITHOUT_IPX_SUPPORT
544.It
545.Va WITHOUT_NCP
546.El
547.It Va WITHOUT_IPX_SUPPORT
548.\" from FreeBSD: head/tools/build/options/WITHOUT_IPX_SUPPORT 156932 2006-03-21 07:50:50Z ru
549Set to build some programs without IPX support.
550.It Va WITHOUT_JAIL
551.\" from FreeBSD: head/tools/build/options/WITHOUT_JAIL 183242 2008-09-21 22:02:26Z sam
552Set to not build tools for the support of jails; e.g.
553.Xr jail 8 .
554.It Va WITHOUT_KDUMP
555.\" $FreeBSD$
556Set to not build
557.Xr kdump 1
558and
559.Xr truss 1 .
560.It Va WITHOUT_KERBEROS
561.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 174549 2007-12-12 16:42:03Z ru
562Set this if you do not want to build Kerberos 5 (KTH Heimdal).
563When set, it also enforces the following options:
564.Pp
565.Bl -item -compact
566.It
567.Va WITHOUT_KERBEROS_SUPPORT
568.El
569.Pp
570When set, the following options are also in effect:
571.Pp
572.Bl -inset -compact
573.It Va WITHOUT_GSSAPI
574(unless
575.Va WITH_GSSAPI
576is set explicitly)
577.El
578.It Va WITHOUT_KERBEROS_SUPPORT
579.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 156932 2006-03-21 07:50:50Z ru
580Set to build some programs without Kerberos support, like
581.Xr cvs 1 ,
582.Xr ssh 1 ,
583.Xr telnet 1 ,
584.Xr sshd 8 ,
585and
586.Xr telnetd 8 .
587.It Va WITHOUT_KERNEL_SYMBOLS
588.\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
589Set to not install kernel symbol files.
590.Bf -symbolic
591This option is recommended for those people who have small root partitions.
592.Ef
593.It Va WITHOUT_KVM
594.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
595Set to not build the
596.Nm libkvm
597library as a part of the base system.
598.Bf -symbolic
599The option has no effect yet.
600.Ef
601When set, it also enforces the following options:
602.Pp
603.Bl -item -compact
604.It
605.Va WITHOUT_KVM_SUPPORT
606.El
607.It Va WITHOUT_KVM_SUPPORT
608.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
609Set to build some programs without optional
610.Nm libkvm
611support.
612.It Va WITHOUT_LEGACY_CONSOLE
613.\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 183242 2008-09-21 22:02:26Z sam
614Set to not build programs that support a legacy PC console; e.g.
615.Xr kbdcontrol 8
616and
617.Xr vidcontrol 8 .
618.It Va WITHOUT_LIB32
619.\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 156932 2006-03-21 07:50:50Z ru
620On amd64, set to not build 32-bit library set and a
621.Nm ld-elf32.so.1
622runtime linker.
623.It Va WITH_LIBCPLUSPLUS
624.\" from FreeBSD: head/tools/build/options/WITH_LIBCPLUSPLUS 228082 2011-11-28 17:56:46Z dim
625Set to build libcxxrt and libc++.
626.It Va WITHOUT_LIBPTHREAD
627.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
628Set to not build the
629.Nm libpthread
630providing library,
631.Nm libthr .
632When set, it also enforces the following options:
633.Pp
634.Bl -item -compact
635.It
636.Va WITHOUT_BIND
637.It
638.Va WITHOUT_BIND_DNSSEC
639.It
640.Va WITHOUT_BIND_ETC
641.It
642.Va WITHOUT_BIND_LIBS
643.It
644.Va WITHOUT_BIND_LIBS_LWRES
645.It
646.Va WITHOUT_BIND_MTREE
647.It
648.Va WITHOUT_BIND_NAMED
649.It
650.Va WITHOUT_BIND_UTILS
651.It
652.Va WITHOUT_LIBTHR
653.El
654.It Va WITHOUT_LIBTHR
655.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
656Set to not build the
657.Nm libthr
658(1:1 threading)
659library.
660When set, it also enforces the following options:
661.Pp
662.Bl -item -compact
663.It
664.Va WITHOUT_BIND
665.It
666.Va WITHOUT_BIND_DNSSEC
667.It
668.Va WITHOUT_BIND_ETC
669.It
670.Va WITHOUT_BIND_LIBS
671.It
672.Va WITHOUT_BIND_LIBS_LWRES
673.It
674.Va WITHOUT_BIND_MTREE
675.It
676.Va WITHOUT_BIND_NAMED
677.It
678.Va WITHOUT_BIND_UTILS
679.El
680.It Va WITHOUT_LOCALES
681.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
682Set to not build localization files; see
683.Xr locale 1 .
684.It Va WITHOUT_LOCATE
685.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
686Set to not build
687.Xr locate 1
688and related programs.
689.It Va WITHOUT_LPR
690.\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
691Set to not build
692.Xr lpr 1
693and related programs.
694.It Va WITHOUT_LS_COLORS
695.\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
696Set to build
697.Xr ls 1
698without support for colors to distinguish file types.
699.It Va WITHOUT_MAIL
700.\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
701Set to not build any mail support (MUA or MTA).
702When set, it also enforces the following options:
703.Pp
704.Bl -item -compact
705.It
706.Va WITHOUT_MAILWRAPPER
707.It
708.Va WITHOUT_SENDMAIL
709.El
710.It Va WITHOUT_MAILWRAPPER
711.\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
712Set to not build the
713.Xr mailwrapper 8
714MTA selector.
715.It Va WITHOUT_MAKE
716.\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
717Set to not install
718.Xr make 1
719and related support files.
720.It Va WITHOUT_MAN
721.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
722Set to not build manual pages.
723When set, the following options are also in effect:
724.Pp
725.Bl -inset -compact
726.It Va WITHOUT_MAN_UTILS
727(unless
728.Va WITH_MAN_UTILS
729is set explicitly)
730.El
731.It Va WITHOUT_MAN_UTILS
732.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
733Set to not build utilities for manual pages,
734.Xr apropos 1 ,
735.Xr catman 1 ,
736.Xr makewhatis 1 ,
737.Xr man 1 ,
738.Xr whatis 1 ,
739.Xr manctl 8 ,
740and related support files.
741.It Va WITH_NAND
742.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
743Set to build the NAND Flash components.
744.It Va WITHOUT_NCP
745.\" from FreeBSD: head/tools/build/options/WITHOUT_NCP 156932 2006-03-21 07:50:50Z ru
746Set to not build programs, libraries, and kernel modules
747related to NetWare Core protocol.
748.It Va WITHOUT_NDIS
749.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
750Set to not build programs and libraries
751related to NDIS emulation support.
752.It Va WITHOUT_NETCAT
753.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
754Set to not build
755.Xr nc 1
756utility.
757.It Va WITHOUT_NETGRAPH
758.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
759Set to not build applications to support
760.Xr netgraph 4 .
761When set, it also enforces the following options:
762.Pp
763.Bl -item -compact
764.It
765.Va WITHOUT_ATM
766.It
767.Va WITHOUT_BLUETOOTH
768.It
769.Va WITHOUT_NETGRAPH_SUPPORT
770.El
771.It Va WITHOUT_NETGRAPH_SUPPORT
772.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
773Set to build libraries, programs, and kernel modules without netgraph support.
774.It Va WITHOUT_NIS
775.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
776Set to not build
777.Xr NIS 8
778support and related programs.
779If set, you might need to adopt your
780.Xr nsswitch.conf 5
781and remove
782.Sq nis
783entries.
784.It Va WITHOUT_NLS
785.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
786Set to not build NLS catalogs.
787.It Va WITHOUT_NLS_CATALOGS
788.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
789Set to not build NLS catalog support for
790.Xr csh 1 .
791.It Va WITHOUT_NS_CACHING
792.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
793Set to disable name caching in the
794.Pa nsswitch
795subsystem.
796The generic caching daemon,
797.Xr nscd 8 ,
798will not be built either if this option is set.
799.It Va WITHOUT_NTP
800.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
801Set to not build
802.Xr ntpd 8
803and related programs.
804.It Va WITH_OFED
805.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
806Set to build the
807.Dq "OpenFabrics Enterprise Distribution"
808Infiniband software stack.
809.It Va WITHOUT_OPENSSH
810.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
811Set to not build OpenSSH.
812.It Va WITHOUT_OPENSSL
813.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
814Set to not build OpenSSL.
815When set, it also enforces the following options:
816.Pp
817.Bl -item -compact
818.It
819.Va WITHOUT_KERBEROS
820.It
821.Va WITHOUT_KERBEROS_SUPPORT
822.It
823.Va WITHOUT_OPENSSH
824.El
825.Pp
826When set, the following options are also in effect:
827.Pp
828.Bl -inset -compact
829.It Va WITHOUT_GSSAPI
830(unless
831.Va WITH_GSSAPI
832is set explicitly)
833.El
834.It Va WITHOUT_PAM
835.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
836Set to not build PAM library and modules.
837.Bf -symbolic
838This option is deprecated and does nothing.
839.Ef
840When set, it also enforces the following options:
841.Pp
842.Bl -item -compact
843.It
844.Va WITHOUT_PAM_SUPPORT
845.El
846.It Va WITHOUT_PAM_SUPPORT
847.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
848Set to build some programs without PAM support, particularly
849.Xr ftpd 8
850and
851.Xr ppp 8 .
852.It Va WITHOUT_PF
853.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
854Set to not build PF firewall package.
855When set, it also enforces the following options:
856.Pp
857.Bl -item -compact
858.It
859.Va WITHOUT_AUTHPF
860.El
861.It Va WITHOUT_PKGBOOTSTRAP
862.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 238023 2012-07-02 20:26:11Z marcel
863Set to not build
864.Xr pkg 1
865bootstrap tool
866.It Va WITHOUT_PKGTOOLS
867.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGTOOLS 183242 2008-09-21 22:02:26Z sam
868Set to not build
869.Xr pkg_add 8
870and related programs.
871.It Va WITHOUT_PMC
872.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
873Set to not build
874.Xr pmccontrol 8
875and related programs.
876.It Va WITHOUT_PORTSNAP
877.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
878Set to not build or install
879.Xr portsnap 8
880and related files.
881.It Va WITHOUT_PPP
882.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
883Set to not build
884.Xr ppp 8
885and related programs.
886.It Va WITHOUT_PROFILE
887.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
888Set to avoid compiling profiled libraries.
889.It Va WITHOUT_QUOTAS
890.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 183242 2008-09-21 22:02:26Z sam
891Set to not build
892.Xr quota 8
893and related programs.
894.It Va WITHOUT_RCMDS
895.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
896Disable building of the
897.Bx
898r-commands.
899This includes
900.Xr rlogin 1 ,
901.Xr rsh 1 ,
902etc.
903.It Va WITHOUT_RCS
904.\" from FreeBSD: head/tools/build/options/WITHOUT_RCS 156932 2006-03-21 07:50:50Z ru
905Set to not build
906.Xr rcs 1
907and related utilities.
908.It Va WITHOUT_RESCUE
909.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
910Set to not build
911.Xr rescue 8 .
912.It Va WITHOUT_ROUTED
913.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
914Set to not build
915.Xr routed 8
916utility.
917.It Va WITHOUT_SENDMAIL
918.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
919Set to not build
920.Xr sendmail 8
921and related programs.
922.It Va WITHOUT_SETUID_LOGIN
923.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
924Set this to disable the installation of
925.Xr login 1
926as a set-user-ID root program.
927.It Va WITHOUT_SHAREDOCS
928.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
929Set to not build the
930.Bx 4.4
931legacy docs.
932.It Va WITH_SHARED_TOOLCHAIN
933.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
934Set to build the toolchain binaries shared.
935The set includes
936.Xr cc 1 ,
937.Xr make 1
938and necessary utilities like assembler, linker and library archive manager.
939.It Va WITHOUT_SOURCELESS
940.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
941Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
942When set, it also enforces the following options:
943.Pp
944.Bl -item -compact
945.It
946.Va WITHOUT_SOURCELESS_HOST
947.It
948.Va WITHOUT_SOURCELESS_UCODE
949.El
950.It Va WITHOUT_SOURCELESS_HOST
951.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
952Set to not build kernel modules that include sourceless native code for host CPU.
953.It Va WITHOUT_SOURCELESS_UCODE
954.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
955Set to not build kernel modules that include sourceless microcode.
956.It Va WITHOUT_SSP
957.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
958Set to not build world with propolice stack smashing protection.
959.It Va WITHOUT_SYMVER
960.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
961Set to disable symbol versioning when building shared libraries.
962.It Va WITHOUT_SYSCONS
963.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
964Set to not build
965.Xr syscons 4
966support files such as keyboard maps, fonts, and screen output maps.
967.It Va WITHOUT_SYSINSTALL
968.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSINSTALL 183242 2008-09-21 22:02:26Z sam
969Set to not build
970.Xr sysinstall 8
971and related programs.
972.It Va WITHOUT_TCSH
973.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
974Set to not build and install
975.Pa /bin/csh
976(which is
977.Xr tcsh 1 ) .
978.It Va WITHOUT_TELNET
979.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 183242 2008-09-21 22:02:26Z sam
980Set to not build
981.Xr telnet 8
982and related programs.
983.It Va WITHOUT_TEXTPROC
984.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
985Set to not build
986programs used for text processing.
987When set, it also enforces the following options:
988.Pp
989.Bl -item -compact
990.It
991.Va WITHOUT_GROFF
992.El
993.It Va WITHOUT_TOOLCHAIN
994.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 174550 2007-12-12 16:43:17Z ru
995Set to not install
996programs used for program development,
997compilers, debuggers etc.
998.Bf -symbolic
999The option does not work for build targets.
1000.Ef
1001When set, it also enforces the following options:
1002.Pp
1003.Bl -item -compact
1004.It
1005.Va WITHOUT_BINUTILS
1006.It
1007.Va WITHOUT_CLANG
1008.It
1009.Va WITHOUT_CLANG_IS_CC
1010.It
1011.Va WITHOUT_GCC
1012.It
1013.Va WITHOUT_GDB
1014.El
1015.It Va WITHOUT_USB
1016.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1017Set to not build USB-related programs and libraries.
1018.It Va WITHOUT_UTMPX
1019.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1020Set to not build user accounting tools such as
1021.Xr last 1 ,
1022.Xr users 1 ,
1023.Xr who 1 ,
1024.Xr ac 8 ,
1025.Xr lastlogin 8
1026and
1027.Xr utx 8 .
1028.It Va WITHOUT_WIRELESS
1029.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1030Set to not build programs used for 802.11 wireless networks; especially
1031.Xr wpa_supplicant 8
1032and
1033.Xr hostapd 8 .
1034When set, it also enforces the following options:
1035.Pp
1036.Bl -item -compact
1037.It
1038.Va WITHOUT_WIRELESS_SUPPORT
1039.El
1040.It Va WITHOUT_WIRELESS_SUPPORT
1041.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1042Set to build libraries, programs, and kernel modules without
1043802.11 wireless support.
1044.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1045.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1046Build
1047.Xr wpa_supplicant 8
1048without support for the IEEE 802.1X protocol and without
1049support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1050protocols (usable only via 802.1X).
1051.It Va WITHOUT_ZFS
1052.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1053Set to not build ZFS file system.
1054.It Va WITHOUT_ZONEINFO
1055.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1056Set to not build the timezone database.
1057.El
1058.Sh FILES
1059.Bl -tag -compact -width Pa
1060.It Pa /etc/src.conf
1061.It Pa /usr/share/mk/bsd.own.mk
1062.El
1063.Sh SEE ALSO
1064.Xr make 1 ,
1065.Xr make.conf 5 ,
1066.Xr build 7 ,
1067.Xr ports 7
1068.Sh HISTORY
1069The
1070.Nm
1071file appeared in
1072.Fx 7.0 .
1073.Sh AUTHORS
1074This manual page was autogenerated.
1075