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