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