1 .\" DO NOT EDIT-- this file is automatically generated.
2 .\" from FreeBSD: src/tools/build/options/makeman,v 1.6.2.2 2008/01/28 08:42:15 dougb Exp
9 .Nd "source build options"
13 file contains settings that will apply to every build involving the
20 file uses the standard makefile syntax.
23 should not specify any dependencies to
29 variables that control the aspects of how the system builds.
31 The default location of
35 though an alternative location can be specified in the
39 Overriding the location of
41 may be necessary if the system-wide settings are not suitable
42 for a particular build.
47 effectively resets all build controls to their defaults.
51 is to control the compilation of the
53 source code, which is usually located in
55 As a rule, the system administrator creates
57 when the values of certain control variables need to be changed
60 In addition, control variables can be specified
61 for a particular build via the
65 or in environment; see
68 The values of variables are ignored regardless of their setting;
69 even if they would be set to
73 Just the existence of an option will cause
77 The following list provides a name and short description for variables
78 that can be used for source builds.
79 .Bl -tag -width indent
81 .\" from FreeBSD: src/tools/build/options/WITHOUT_ACPI,v 1.1 2006/03/21 07:50:49 ru Exp
86 .It Va WITHOUT_ASSERT_DEBUG
87 .\" from FreeBSD: src/tools/build/options/WITHOUT_ASSERT_DEBUG,v 1.1 2006/09/11 13:55:27 ru Exp
88 Set to compile programs and libraries without the
92 .\" from FreeBSD: src/tools/build/options/WITHOUT_ATM,v 1.1 2006/03/21 07:50:49 ru Exp
94 programs and libraries related to ATM networking.
96 .\" from FreeBSD: src/tools/build/options/WITHOUT_AUDIT,v 1.1 2006/03/21 07:50:49 ru Exp
97 Set to not build audit support into system programs.
99 .\" from FreeBSD: src/tools/build/options/WITHOUT_AUTHPF,v 1.1 2006/03/21 07:50:49 ru Exp
103 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND,v 1.1 2006/03/21 07:50:49 ru Exp
104 Setting this variable will prevent any part of BIND from being built.
105 When set, it also enforces the following options:
109 .Va WITHOUT_BIND_DNSSEC
113 .Va WITHOUT_BIND_LIBS_LWRES
115 .Va WITHOUT_BIND_MTREE
117 .Va WITHOUT_BIND_NAMED
119 .Va WITHOUT_BIND_UTILS
121 .It Va WITHOUT_BIND_DNSSEC
122 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_DNSSEC,v 1.1 2006/03/21 07:50:49 ru Exp
123 Set to avoid building or installing the DNSSEC related binaries,
126 .Xr dnssec-signzone 8 .
127 .It Va WITHOUT_BIND_ETC
128 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_ETC,v 1.1 2006/03/21 07:50:49 ru Exp
129 Set to avoid installing the default files to
130 .Pa /var/named/etc/namedb .
131 .It Va WITH_BIND_LIBS
132 .\" from FreeBSD: src/tools/build/options/WITH_BIND_LIBS,v 1.1 2006/03/21 07:50:50 ru Exp
133 Set to install BIND libraries and include files.
134 .It Va WITHOUT_BIND_LIBS_LWRES
135 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_LIBS_LWRES,v 1.1 2006/03/21 07:50:49 ru Exp
136 Set to avoid installing the lightweight resolver library in
138 .It Va WITHOUT_BIND_MTREE
139 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_MTREE,v 1.3 2006/04/13 10:37:29 ru Exp
142 to create the chroot directory structure under
144 and avoid creating an
146 symlink to the chroot directory.
147 When set, it also enforces the following options:
153 .It Va WITHOUT_BIND_NAMED
154 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_NAMED,v 1.1 2006/03/21 07:50:49 ru Exp
155 Set to avoid building or installing
158 .Xr named-checkconf 8 ,
159 .Xr named-checkzone 8 ,
163 .It Va WITHOUT_BIND_UTILS
164 .\" from FreeBSD: src/tools/build/options/WITHOUT_BIND_UTILS,v 1.1 2006/03/21 07:50:49 ru Exp
165 Set to avoid building or installing the BIND userland utilities,
171 .It Va WITHOUT_BLUETOOTH
172 .\" from FreeBSD: src/tools/build/options/WITHOUT_BLUETOOTH,v 1.1 2006/03/21 07:50:49 ru Exp
173 Set to not build Bluetooth related kernel modules, programs and libraries.
175 .\" from FreeBSD: src/tools/build/options/WITHOUT_BOOT,v 1.1 2006/03/21 07:50:49 ru Exp
176 Set to not build the boot blocks and loader.
178 .\" from FreeBSD: src/tools/build/options/WITHOUT_BZIP2,v 1.1.2.1 2008/01/30 15:03:37 ru Exp
179 Set to not build contributed bzip2 software as a part of the base system.
181 The option has no effect yet.
183 When set, it also enforces the following options:
187 .Va WITHOUT_BZIP2_SUPPORT
189 .It Va WITHOUT_BZIP2_SUPPORT
190 .\" from FreeBSD: src/tools/build/options/WITHOUT_BZIP2_SUPPORT,v 1.1 2007/01/26 10:19:08 delphij Exp
191 Set to build some programs without optional bzip2 support.
192 .It Va WITHOUT_CALENDAR
193 .\" from FreeBSD: src/tools/build/options/WITHOUT_CALENDAR,v 1.1 2006/03/21 07:50:49 ru Exp
197 .\" from FreeBSD: src/tools/build/options/WITHOUT_CDDL,v 1.1 2006/11/01 09:02:11 jb Exp
198 Set to not build code licensed under Sun's CDDL.
199 When set, it also enforces the following options:
206 .\" from FreeBSD: src/tools/build/options/WITHOUT_CPP,v 1.1 2006/03/21 07:50:49 ru Exp
210 .\" from FreeBSD: src/tools/build/options/WITHOUT_CRYPT,v 1.1 2006/03/21 07:50:49 ru Exp
211 Set to not build any crypto code.
212 When set, it also enforces the following options:
217 (can be overridden with
222 .Va WITHOUT_KERBEROS_SUPPORT
229 .\" from FreeBSD: src/tools/build/options/WITHOUT_CVS,v 1.1 2006/03/21 07:50:49 ru Exp
230 Set to not build CVS.
232 .\" from FreeBSD: src/tools/build/options/WITHOUT_CXX,v 1.1 2006/03/21 07:50:49 ru Exp
235 and related libraries.
237 .\" from FreeBSD: src/tools/build/options/WITHOUT_DICT,v 1.1 2006/03/21 07:50:49 ru Exp
238 Set to not build the Webster dictionary files.
239 .It Va WITHOUT_DYNAMICROOT
240 .\" from FreeBSD: src/tools/build/options/WITHOUT_DYNAMICROOT,v 1.1 2006/03/21 07:50:49 ru Exp
241 Set this if you do not want to link
246 .It Va WITHOUT_EXAMPLES
247 .\" from FreeBSD: src/tools/build/options/WITHOUT_EXAMPLES,v 1.2 2006/03/21 09:06:24 ru Exp
248 Set to avoid installing examples to
249 .Pa /usr/share/examples/ .
251 .\" from FreeBSD: src/tools/build/options/WITHOUT_FORTH,v 1.1 2006/03/21 07:50:49 ru Exp
252 Set to build bootloaders without Forth support.
253 .It Va WITHOUT_FP_LIBC
254 .\" from FreeBSD: src/tools/build/options/WITHOUT_FP_LIBC,v 1.1 2006/03/21 07:50:49 ru Exp
257 without floating-point support.
259 .\" from FreeBSD: src/tools/build/options/WITHOUT_GAMES,v 1.1 2006/03/21 07:50:49 ru Exp
260 Set to not build games.
262 .\" from FreeBSD: src/tools/build/options/WITHOUT_GCOV,v 1.1 2006/03/21 07:50:49 ru Exp
267 .\" from FreeBSD: src/tools/build/options/WITHOUT_GDB,v 1.1 2006/03/21 07:50:49 ru Exp
271 .\" from FreeBSD: src/tools/build/options/WITHOUT_GNU,v 1.2.2.1 2008/01/30 15:03:37 ru Exp
272 Set to not build contributed GNU software as a part of the base system.
273 This option can be useful if the system built must not contain any code
274 covered by the GNU Public License due to legal reasons.
276 The option has no effect yet.
278 When set, it also enforces the following options:
282 .Va WITHOUT_GNU_SUPPORT
284 .It Va WITHOUT_GNU_SUPPORT
285 .\" from FreeBSD: src/tools/build/options/WITHOUT_GNU_SUPPORT,v 1.1 2006/03/21 07:50:49 ru Exp
286 Set to build some programs without optional GNU support.
288 .\" from FreeBSD: src/tools/build/options/WITHOUT_GPIB,v 1.1 2006/03/21 07:50:49 ru Exp
289 Set to not build GPIB bus support.
291 .\" from FreeBSD: src/tools/build/options/WITHOUT_GROFF,v 1.1 2006/03/21 07:50:49 ru Exp
294 .It Va WITHOUT_GSSAPI
295 .\" from FreeBSD: src/tools/build/options/WITHOUT_GSSAPI,v 1.1.2.1 2008/01/28 08:42:15 dougb Exp
296 Set to not build libgssapi.
298 .\" from FreeBSD: src/tools/build/options/WITH_HESIOD,v 1.1 2006/03/21 07:50:50 ru Exp
299 Set to build Hesiod support.
301 .\" from FreeBSD: src/tools/build/options/WITHOUT_HTML,v 1.1 2006/03/21 07:50:49 ru Exp
302 Set to not build HTML docs.
304 .\" from FreeBSD: src/tools/build/options/WITHOUT_I4B,v 1.1 2006/03/21 07:50:50 ru Exp
305 Set to not build isdn4bsd package.
307 .\" from FreeBSD: src/tools/build/options/WITH_IDEA,v 1.1 2006/03/21 07:50:50 ru Exp
308 Set to build the IDEA encryption code.
309 This code is patented in the USA and many European countries.
311 .Em "YOUR RESPONSIBILITY"
312 to determine if you can legally use IDEA.
314 .\" from FreeBSD: src/tools/build/options/WITHOUT_INET6,v 1.1 2006/03/21 07:50:50 ru Exp
316 programs and libraries related to IPv6 networking.
317 When set, it also enforces the following options:
321 .Va WITHOUT_INET6_SUPPORT
323 .It Va WITHOUT_INET6_SUPPORT
324 .\" from FreeBSD: src/tools/build/options/WITHOUT_INET6_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
325 Set to build libraries, programs, and kernel modules without IPv6 support.
327 .\" from FreeBSD: src/tools/build/options/WITHOUT_INFO,v 1.1 2006/03/21 07:50:50 ru Exp
328 Set to not make or install
331 .It Va WITHOUT_INSTALLLIB
332 .\" from FreeBSD: src/tools/build/options/WITHOUT_INSTALLLIB,v 1.1.2.1 2008/01/30 15:05:41 ru Exp
333 Set this if you do not want to install optional libraries.
334 For example when creating a
337 .It Va WITHOUT_IPFILTER
338 .\" from FreeBSD: src/tools/build/options/WITHOUT_IPFILTER,v 1.1 2006/03/21 07:50:50 ru Exp
339 Set to not build IP Filter package.
341 .\" from FreeBSD: src/tools/build/options/WITHOUT_IPX,v 1.1 2006/03/21 07:50:50 ru Exp
342 Set to not build programs and libraries related to IPX networking.
343 When set, it also enforces the following options:
347 .Va WITHOUT_IPX_SUPPORT
351 .It Va WITHOUT_IPX_SUPPORT
352 .\" from FreeBSD: src/tools/build/options/WITHOUT_IPX_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
353 Set to build some programs without IPX support.
354 .It Va WITHOUT_KERBEROS
355 .\" from FreeBSD: src/tools/build/options/WITHOUT_KERBEROS,v 1.1 2006/03/21 07:50:50 ru Exp
356 Set this if you do not want to build Kerberos 5 (KTH Heimdal).
357 When set, it also enforces the following options:
362 (can be overridden with
365 .Va WITHOUT_KERBEROS_SUPPORT
367 .It Va WITHOUT_KERBEROS_SUPPORT
368 .\" from FreeBSD: src/tools/build/options/WITHOUT_KERBEROS_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
369 Set to build some programs without Kerberos support, like
377 .\" from FreeBSD: src/tools/build/options/WITHOUT_KVM,v 1.1.2.1 2008/01/30 15:03:37 ru Exp
380 library as a part of the base system.
382 The option has no effect yet.
384 When set, it also enforces the following options:
388 .Va WITHOUT_KVM_SUPPORT
390 .It Va WITHOUT_KVM_SUPPORT
391 .\" from FreeBSD: src/tools/build/options/WITHOUT_KVM_SUPPORT,v 1.1 2007/06/13 02:08:04 sepotvin Exp
392 Set to build some programs without optional
396 .\" from FreeBSD: src/tools/build/options/WITHOUT_LIB32,v 1.1 2006/03/21 07:50:50 ru Exp
397 On amd64, set to not build 32-bit library set and a
400 .It Va WITHOUT_LIBKSE
401 .\" from FreeBSD: src/tools/build/options/WITHOUT_LIBKSE,v 1.2 2007/10/09 17:22:00 obrien Exp
406 .It Va WITHOUT_LIBPTHREAD
407 .\" from FreeBSD: src/tools/build/options/WITHOUT_LIBPTHREAD,v 1.3 2007/10/09 17:53:33 obrien Exp
408 Set to not build either of the
415 When set, it also enforces the following options:
421 .Va WITHOUT_BIND_DNSSEC
425 .Va WITHOUT_BIND_LIBS_LWRES
427 .Va WITHOUT_BIND_MTREE
429 .Va WITHOUT_BIND_NAMED
431 .Va WITHOUT_BIND_UTILS
437 .It Va WITHOUT_LIBTHR
438 .\" from FreeBSD: src/tools/build/options/WITHOUT_LIBTHR,v 1.1 2006/03/21 07:50:50 ru Exp
443 .It Va WITHOUT_LOCALES
444 .\" from FreeBSD: src/tools/build/options/WITHOUT_LOCALES,v 1.1 2006/03/21 07:50:50 ru Exp
445 Set to not build localization files; see
448 .\" from FreeBSD: src/tools/build/options/WITHOUT_LPR,v 1.1 2006/03/21 07:50:50 ru Exp
451 and related programs.
452 .It Va WITHOUT_MAILWRAPPER
453 .\" from FreeBSD: src/tools/build/options/WITHOUT_MAILWRAPPER,v 1.1 2006/03/21 07:50:50 ru Exp
458 .\" from FreeBSD: src/tools/build/options/WITHOUT_MAN,v 1.1 2006/03/21 07:50:50 ru Exp
459 Set to not build manual pages.
461 .\" from FreeBSD: src/tools/build/options/WITHOUT_NCP,v 1.1 2006/03/21 07:50:50 ru Exp
462 Set to not build programs, libraries, and kernel modules
463 related to NetWare Core protocol.
464 .It Va WITHOUT_NETCAT
465 .\" from FreeBSD: src/tools/build/options/WITHOUT_NETCAT,v 1.1 2006/03/21 07:50:50 ru Exp
470 .\" from FreeBSD: src/tools/build/options/WITHOUT_NIS,v 1.1 2006/03/21 07:50:50 ru Exp
473 support and related programs.
474 If set, you might need to adopt your
480 .\" from FreeBSD: src/tools/build/options/WITHOUT_NLS,v 1.1 2006/03/21 07:50:50 ru Exp
481 Set to not build NLS catalogs.
482 .It Va WITHOUT_NLS_CATALOGS
483 .\" from FreeBSD: src/tools/build/options/WITHOUT_NLS_CATALOGS,v 1.1 2006/03/21 07:50:50 ru Exp
484 Set to not build NLS catalog support for
486 .It Va WITHOUT_NS_CACHING
487 .\" from FreeBSD: src/tools/build/options/WITHOUT_NS_CACHING,v 1.1.2.1 2007/10/26 08:14:08 bushman Exp
488 Set to disable name caching in the
491 The generic caching daemon,
493 will not be built either if this option is set.
495 .\" from FreeBSD: src/tools/build/options/WITHOUT_OBJC,v 1.1 2006/03/21 07:50:50 ru Exp
496 Set to not build Objective C support.
497 .It Va WITHOUT_OPENSSH
498 .\" from FreeBSD: src/tools/build/options/WITHOUT_OPENSSH,v 1.1 2006/03/21 07:50:50 ru Exp
499 Set to not build OpenSSH.
500 .It Va WITHOUT_OPENSSL
501 .\" from FreeBSD: src/tools/build/options/WITHOUT_OPENSSL,v 1.1 2006/03/21 07:50:50 ru Exp
502 Set to not build OpenSSL.
503 When set, it also enforces the following options:
508 (can be overridden with
513 .Va WITHOUT_KERBEROS_SUPPORT
518 .\" from FreeBSD: src/tools/build/options/WITHOUT_PAM,v 1.2.2.1 2008/01/30 15:03:37 ru Exp
519 Set to not build PAM library and modules.
521 This option is deprecated and does nothing.
523 When set, it also enforces the following options:
527 .Va WITHOUT_PAM_SUPPORT
529 .It Va WITHOUT_PAM_SUPPORT
530 .\" from FreeBSD: src/tools/build/options/WITHOUT_PAM_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
531 Set to build some programs without PAM support, particularly
536 .\" from FreeBSD: src/tools/build/options/WITHOUT_PF,v 1.1 2006/03/21 07:50:50 ru Exp
537 Set to not build PF firewall package.
538 When set, it also enforces the following options:
544 .It Va WITHOUT_PROFILE
545 .\" from FreeBSD: src/tools/build/options/WITHOUT_PROFILE,v 1.1 2006/03/21 07:50:50 ru Exp
546 Set to avoid compiling profiled libraries.
548 .\" from FreeBSD: src/tools/build/options/WITHOUT_RCMDS,v 1.1 2006/03/21 07:50:50 ru Exp
549 Disable building of the
557 .\" from FreeBSD: src/tools/build/options/WITHOUT_RCS,v 1.1 2006/03/21 07:50:50 ru Exp
560 and related utilities.
561 .It Va WITHOUT_RESCUE
562 .\" from FreeBSD: src/tools/build/options/WITHOUT_RESCUE,v 1.1 2006/03/21 07:50:50 ru Exp
565 .It Va WITHOUT_SENDMAIL
566 .\" from FreeBSD: src/tools/build/options/WITHOUT_SENDMAIL,v 1.1 2006/03/21 07:50:50 ru Exp
569 and related programs.
570 .It Va WITHOUT_SETUID_LOGIN
571 .\" from FreeBSD: src/tools/build/options/WITHOUT_SETUID_LOGIN,v 1.1 2006/03/21 07:50:50 ru Exp
572 Set this to disable the installation of
574 as a set-user-ID root program.
575 .It Va WITHOUT_SHAREDOCS
576 .\" from FreeBSD: src/tools/build/options/WITHOUT_SHAREDOCS,v 1.1 2006/03/21 07:50:50 ru Exp
581 .\" from FreeBSD: src/tools/build/options/WITHOUT_SSP,v 1.1 2007/05/19 04:42:58 kan Exp
582 Set to not build propolice stack smashing protection library.
583 .It Va WITHOUT_SYMVER
584 .\" from FreeBSD: src/tools/build/options/WITHOUT_SYMVER,v 1.1 2007/05/17 05:03:24 deischen Exp
585 Set to disable symbol versioning when building shared libraries.
586 .It Va WITHOUT_SYSCONS
587 .\" from FreeBSD: src/tools/build/options/WITHOUT_SYSCONS,v 1.1 2006/03/21 07:50:50 ru Exp
590 support files such as keyboard maps, fonts, and screen output maps.
592 .\" from FreeBSD: src/tools/build/options/WITHOUT_TCSH,v 1.1 2006/03/21 07:50:50 ru Exp
593 Set to not build and install
597 .It Va WITHOUT_TOOLCHAIN
598 .\" from FreeBSD: src/tools/build/options/WITHOUT_TOOLCHAIN,v 1.2.2.1 2008/01/30 15:03:37 ru Exp
600 programs used for program development,
601 compilers, debuggers etc.
603 The option does not work for build targets.
605 When set, it also enforces the following options:
612 .\" from FreeBSD: src/tools/build/options/WITHOUT_USB,v 1.1 2006/03/21 07:50:50 ru Exp
613 Set to not build USB-related programs and libraries.
614 .It Va WITHOUT_WPA_SUPPLICANT_EAPOL
615 .\" from FreeBSD: src/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL,v 1.1 2006/03/21 07:50:50 ru Exp
618 without support for the IEEE 802.1X protocol and without
619 support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
620 protocols (usable only via 802.1X).
622 .\" from FreeBSD: src/tools/build/options/WITHOUT_ZFS,v 1.1 2007/04/06 02:13:30 pjd Exp
623 Set to not build ZFS file system.
624 .It Va WITHOUT_ZONEINFO
625 .\" from FreeBSD: src/tools/build/options/WITHOUT_ZONEINFO,v 1.1 2007/08/27 20:01:08 remko Exp
626 Set to not build the timezone database
631 .It Pa /usr/share/mk/bsd.own.mk
644 This manual page was autogenerated.