xref: /freebsd/share/man/man5/src.conf.5 (revision ab2043b81eaba0d7d7769b4a58b2b6d17bc464a3)
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 8, 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_KERBEROS
555.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 174549 2007-12-12 16:42:03Z ru
556Set this if you do not want to build Kerberos 5 (KTH Heimdal).
557When set, it also enforces the following options:
558.Pp
559.Bl -item -compact
560.It
561.Va WITHOUT_KERBEROS_SUPPORT
562.El
563.Pp
564When set, the following options are also in effect:
565.Pp
566.Bl -inset -compact
567.It Va WITHOUT_GSSAPI
568(unless
569.Va WITH_GSSAPI
570is set explicitly)
571.El
572.It Va WITHOUT_KERBEROS_SUPPORT
573.\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 156932 2006-03-21 07:50:50Z ru
574Set to build some programs without Kerberos support, like
575.Xr cvs 1 ,
576.Xr ssh 1 ,
577.Xr telnet 1 ,
578.Xr sshd 8 ,
579and
580.Xr telnetd 8 .
581.It Va WITHOUT_KERNEL_SYMBOLS
582.\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
583Set to not install kernel symbol files.
584.Bf -symbolic
585This option is recommended for those people who have small root partitions.
586.Ef
587.It Va WITHOUT_KVM
588.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
589Set to not build the
590.Nm libkvm
591library as a part of the base system.
592.Bf -symbolic
593The option has no effect yet.
594.Ef
595When set, it also enforces the following options:
596.Pp
597.Bl -item -compact
598.It
599.Va WITHOUT_KVM_SUPPORT
600.El
601.It Va WITHOUT_KVM_SUPPORT
602.\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
603Set to build some programs without optional
604.Nm libkvm
605support.
606.It Va WITHOUT_LEGACY_CONSOLE
607.\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 183242 2008-09-21 22:02:26Z sam
608Set to not build programs that support a legacy PC console; e.g.
609.Xr kbdcontrol 8
610and
611.Xr vidcontrol 8 .
612.It Va WITHOUT_LIB32
613.\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 156932 2006-03-21 07:50:50Z ru
614On amd64, set to not build 32-bit library set and a
615.Nm ld-elf32.so.1
616runtime linker.
617.It Va WITH_LIBCPLUSPLUS
618.\" from FreeBSD: head/tools/build/options/WITH_LIBCPLUSPLUS 228082 2011-11-28 17:56:46Z dim
619Set to build libcxxrt and libc++.
620.It Va WITHOUT_LIBPTHREAD
621.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
622Set to not build the
623.Nm libpthread
624providing library,
625.Nm libthr .
626When set, it also enforces the following options:
627.Pp
628.Bl -item -compact
629.It
630.Va WITHOUT_BIND
631.It
632.Va WITHOUT_BIND_DNSSEC
633.It
634.Va WITHOUT_BIND_ETC
635.It
636.Va WITHOUT_BIND_LIBS
637.It
638.Va WITHOUT_BIND_LIBS_LWRES
639.It
640.Va WITHOUT_BIND_MTREE
641.It
642.Va WITHOUT_BIND_NAMED
643.It
644.Va WITHOUT_BIND_UTILS
645.It
646.Va WITHOUT_LIBTHR
647.El
648.It Va WITHOUT_LIBTHR
649.\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
650Set to not build the
651.Nm libthr
652(1:1 threading)
653library.
654When set, it also enforces the following options:
655.Pp
656.Bl -item -compact
657.It
658.Va WITHOUT_BIND
659.It
660.Va WITHOUT_BIND_DNSSEC
661.It
662.Va WITHOUT_BIND_ETC
663.It
664.Va WITHOUT_BIND_LIBS
665.It
666.Va WITHOUT_BIND_LIBS_LWRES
667.It
668.Va WITHOUT_BIND_MTREE
669.It
670.Va WITHOUT_BIND_NAMED
671.It
672.Va WITHOUT_BIND_UTILS
673.El
674.It Va WITHOUT_LOCALES
675.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
676Set to not build localization files; see
677.Xr locale 1 .
678.It Va WITHOUT_LOCATE
679.\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
680Set to not build
681.Xr locate 1
682and related programs.
683.It Va WITHOUT_LPR
684.\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
685Set to not build
686.Xr lpr 1
687and related programs.
688.It Va WITHOUT_LS_COLORS
689.\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
690Set to build
691.Xr ls 1
692without support for colors to distinguish file types.
693.It Va WITHOUT_MAIL
694.\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
695Set to not build any mail support (MUA or MTA).
696When set, it also enforces the following options:
697.Pp
698.Bl -item -compact
699.It
700.Va WITHOUT_MAILWRAPPER
701.It
702.Va WITHOUT_SENDMAIL
703.El
704.It Va WITHOUT_MAILWRAPPER
705.\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
706Set to not build the
707.Xr mailwrapper 8
708MTA selector.
709.It Va WITHOUT_MAKE
710.\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
711Set to not install
712.Xr make 1
713and related support files.
714.It Va WITHOUT_MAN
715.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
716Set to not build manual pages.
717When set, the following options are also in effect:
718.Pp
719.Bl -inset -compact
720.It Va WITHOUT_MAN_UTILS
721(unless
722.Va WITH_MAN_UTILS
723is set explicitly)
724.El
725.It Va WITHOUT_MAN_UTILS
726.\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
727Set to not build utilities for manual pages,
728.Xr apropos 1 ,
729.Xr catman 1 ,
730.Xr makewhatis 1 ,
731.Xr man 1 ,
732.Xr whatis 1 ,
733.Xr manctl 8 ,
734and related support files.
735.It Va WITH_NAND
736.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
737Set to build the NAND Flash components.
738.It Va WITHOUT_NCP
739.\" from FreeBSD: head/tools/build/options/WITHOUT_NCP 156932 2006-03-21 07:50:50Z ru
740Set to not build programs, libraries, and kernel modules
741related to NetWare Core protocol.
742.It Va WITHOUT_NDIS
743.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
744Set to not build programs and libraries
745related to NDIS emulation support.
746.It Va WITHOUT_NETCAT
747.\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
748Set to not build
749.Xr nc 1
750utility.
751.It Va WITHOUT_NETGRAPH
752.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
753Set to not build applications to support
754.Xr netgraph 4 .
755When set, it also enforces the following options:
756.Pp
757.Bl -item -compact
758.It
759.Va WITHOUT_ATM
760.It
761.Va WITHOUT_BLUETOOTH
762.It
763.Va WITHOUT_NETGRAPH_SUPPORT
764.El
765.It Va WITHOUT_NETGRAPH_SUPPORT
766.\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
767Set to build libraries, programs, and kernel modules without netgraph support.
768.It Va WITHOUT_NIS
769.\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
770Set to not build
771.Xr NIS 8
772support and related programs.
773If set, you might need to adopt your
774.Xr nsswitch.conf 5
775and remove
776.Sq nis
777entries.
778.It Va WITHOUT_NLS
779.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
780Set to not build NLS catalogs.
781.It Va WITHOUT_NLS_CATALOGS
782.\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
783Set to not build NLS catalog support for
784.Xr csh 1 .
785.It Va WITHOUT_NS_CACHING
786.\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
787Set to disable name caching in the
788.Pa nsswitch
789subsystem.
790The generic caching daemon,
791.Xr nscd 8 ,
792will not be built either if this option is set.
793.It Va WITHOUT_NTP
794.\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
795Set to not build
796.Xr ntpd 8
797and related programs.
798.It Va WITH_OFED
799.\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
800Set to build the
801.Dq "OpenFabrics Enterprise Distribution"
802Infiniband software stack.
803.It Va WITHOUT_OPENSSH
804.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
805Set to not build OpenSSH.
806.It Va WITHOUT_OPENSSL
807.\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
808Set to not build OpenSSL.
809When set, it also enforces the following options:
810.Pp
811.Bl -item -compact
812.It
813.Va WITHOUT_KERBEROS
814.It
815.Va WITHOUT_KERBEROS_SUPPORT
816.It
817.Va WITHOUT_OPENSSH
818.El
819.Pp
820When set, the following options are also in effect:
821.Pp
822.Bl -inset -compact
823.It Va WITHOUT_GSSAPI
824(unless
825.Va WITH_GSSAPI
826is set explicitly)
827.El
828.It Va WITHOUT_PAM
829.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
830Set to not build PAM library and modules.
831.Bf -symbolic
832This option is deprecated and does nothing.
833.Ef
834When set, it also enforces the following options:
835.Pp
836.Bl -item -compact
837.It
838.Va WITHOUT_PAM_SUPPORT
839.El
840.It Va WITHOUT_PAM_SUPPORT
841.\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
842Set to build some programs without PAM support, particularly
843.Xr ftpd 8
844and
845.Xr ppp 8 .
846.It Va WITHOUT_PF
847.\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
848Set to not build PF firewall package.
849When set, it also enforces the following options:
850.Pp
851.Bl -item -compact
852.It
853.Va WITHOUT_AUTHPF
854.El
855.It Va WITHOUT_PKGBOOTSTRAP
856.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 238023 2012-07-02 20:26:11Z marcel
857Set to not build
858.Xr pkg 1
859bootstrap tool
860.It Va WITHOUT_PKGTOOLS
861.\" from FreeBSD: head/tools/build/options/WITHOUT_PKGTOOLS 183242 2008-09-21 22:02:26Z sam
862Set to not build
863.Xr pkg_add 8
864and related programs.
865.It Va WITHOUT_PMC
866.\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
867Set to not build
868.Xr pmccontrol 8
869and related programs.
870.It Va WITHOUT_PORTSNAP
871.\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
872Set to not build or install
873.Xr portsnap 8
874and related files.
875.It Va WITHOUT_PPP
876.\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
877Set to not build
878.Xr ppp 8
879and related programs.
880.It Va WITHOUT_PROFILE
881.\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
882Set to avoid compiling profiled libraries.
883.It Va WITHOUT_QUOTAS
884.\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 183242 2008-09-21 22:02:26Z sam
885Set to not build
886.Xr quota 8
887and related programs.
888.It Va WITHOUT_RCMDS
889.\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
890Disable building of the
891.Bx
892r-commands.
893This includes
894.Xr rlogin 1 ,
895.Xr rsh 1 ,
896etc.
897.It Va WITHOUT_RCS
898.\" from FreeBSD: head/tools/build/options/WITHOUT_RCS 156932 2006-03-21 07:50:50Z ru
899Set to not build
900.Xr rcs 1
901and related utilities.
902.It Va WITHOUT_RESCUE
903.\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
904Set to not build
905.Xr rescue 8 .
906.It Va WITHOUT_ROUTED
907.\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
908Set to not build
909.Xr routed 8
910utility.
911.It Va WITHOUT_SENDMAIL
912.\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
913Set to not build
914.Xr sendmail 8
915and related programs.
916.It Va WITHOUT_SETUID_LOGIN
917.\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
918Set this to disable the installation of
919.Xr login 1
920as a set-user-ID root program.
921.It Va WITHOUT_SHAREDOCS
922.\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
923Set to not build the
924.Bx 4.4
925legacy docs.
926.It Va WITH_SHARED_TOOLCHAIN
927.\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
928Set to build the toolchain binaries shared.
929The set includes
930.Xr cc 1 ,
931.Xr make 1
932and necessary utilities like assembler, linker and library archive manager.
933.It Va WITHOUT_SOURCELESS
934.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
935Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
936When set, it also enforces the following options:
937.Pp
938.Bl -item -compact
939.It
940.Va WITHOUT_SOURCELESS_HOST
941.It
942.Va WITHOUT_SOURCELESS_UCODE
943.El
944.It Va WITHOUT_SOURCELESS_HOST
945.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
946Set to not build kernel modules that include sourceless native code for host CPU.
947.It Va WITHOUT_SOURCELESS_UCODE
948.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
949Set to not build kernel modules that include sourceless microcode.
950.It Va WITHOUT_SSP
951.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
952Set to not build world with propolice stack smashing protection.
953.It Va WITHOUT_SYMVER
954.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
955Set to disable symbol versioning when building shared libraries.
956.It Va WITHOUT_SYSCONS
957.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
958Set to not build
959.Xr syscons 4
960support files such as keyboard maps, fonts, and screen output maps.
961.It Va WITHOUT_SYSINSTALL
962.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSINSTALL 183242 2008-09-21 22:02:26Z sam
963Set to not build
964.Xr sysinstall 8
965and related programs.
966.It Va WITHOUT_TCSH
967.\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
968Set to not build and install
969.Pa /bin/csh
970(which is
971.Xr tcsh 1 ) .
972.It Va WITHOUT_TELNET
973.\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 183242 2008-09-21 22:02:26Z sam
974Set to not build
975.Xr telnet 8
976and related programs.
977.It Va WITHOUT_TEXTPROC
978.\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
979Set to not build
980programs used for text processing.
981When set, it also enforces the following options:
982.Pp
983.Bl -item -compact
984.It
985.Va WITHOUT_GROFF
986.El
987.It Va WITHOUT_TOOLCHAIN
988.\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 174550 2007-12-12 16:43:17Z ru
989Set to not install
990programs used for program development,
991compilers, debuggers etc.
992.Bf -symbolic
993The option does not work for build targets.
994.Ef
995When set, it also enforces the following options:
996.Pp
997.Bl -item -compact
998.It
999.Va WITHOUT_BINUTILS
1000.It
1001.Va WITHOUT_CLANG
1002.It
1003.Va WITHOUT_CLANG_IS_CC
1004.It
1005.Va WITHOUT_GCC
1006.It
1007.Va WITHOUT_GDB
1008.El
1009.It Va WITHOUT_USB
1010.\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1011Set to not build USB-related programs and libraries.
1012.It Va WITHOUT_UTMPX
1013.\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1014Set to not build user accounting tools such as
1015.Xr last 1 ,
1016.Xr users 1 ,
1017.Xr who 1 ,
1018.Xr ac 8 ,
1019.Xr lastlogin 8
1020and
1021.Xr utx 8 .
1022.It Va WITHOUT_WIRELESS
1023.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1024Set to not build programs used for 802.11 wireless networks; especially
1025.Xr wpa_supplicant 8
1026and
1027.Xr hostapd 8 .
1028When set, it also enforces the following options:
1029.Pp
1030.Bl -item -compact
1031.It
1032.Va WITHOUT_WIRELESS_SUPPORT
1033.El
1034.It Va WITHOUT_WIRELESS_SUPPORT
1035.\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1036Set to build libraries, programs, and kernel modules without
1037802.11 wireless support.
1038.It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1039.\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1040Build
1041.Xr wpa_supplicant 8
1042without support for the IEEE 802.1X protocol and without
1043support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1044protocols (usable only via 802.1X).
1045.It Va WITHOUT_ZFS
1046.\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1047Set to not build ZFS file system.
1048.It Va WITHOUT_ZONEINFO
1049.\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1050Set to not build the timezone database.
1051.El
1052.Sh FILES
1053.Bl -tag -compact -width Pa
1054.It Pa /etc/src.conf
1055.It Pa /usr/share/mk/bsd.own.mk
1056.El
1057.Sh SEE ALSO
1058.Xr make 1 ,
1059.Xr make.conf 5 ,
1060.Xr build 7 ,
1061.Xr ports 7
1062.Sh HISTORY
1063The
1064.Nm
1065file appeared in
1066.Fx 7.0 .
1067.Sh AUTHORS
1068This manual page was autogenerated.
1069