home | help
SRC.CONF(5)		       File Formats Manual		     SRC.CONF(5)

NAME
     src.conf -- source build options

DESCRIPTION
     The  src.conf file contains settings that will apply to every build involv-
     ing the FreeBSD source tree; see build(7).

     The src.conf file uses the standard  makefile  syntax.   However,	src.conf
     should  not  specify  any dependencies to make(1).  Instead, src.conf is to
     set make(1) variables that control the aspects of how the system builds.

     The default location of src.conf is /etc/src.conf,  though  an  alternative
     location  can be specified in the make(1) variable SRCCONF.  Overriding the
     location of src.conf may be necessary if the system-wide settings	are  not
     suitable  for  a  particular  build.   For  instance,  setting  SRCCONF  to
     /dev/null effectively resets all build controls to their defaults.

     The only purpose of src.conf is to control the compilation of  the  FreeBSD
     source  code,  which is usually located in /usr/src.  As a rule, the system
     administrator creates src.conf when the values of certain control variables
     need to be changed from their defaults.

     In addition, control variables can be specified for a particular build  via
     the -D option of make(1) or in environment; see environ(7).

     The  values  of  variables are ignored regardless of their setting; even if
     they would be set to "FALSE" or "NO".  Just the existence of an option will
     cause it to be honoured by make(1).

     The following list provides a name and short description for variables that
     can be used for source builds.

     WITHOUT_ACPI
	     Set to not build acpiconf(8), acpidump(8) and related programs.

     WITHOUT_ASSERT_DEBUG
	     Set to compile programs and libraries without the assert(3) checks.

     WITHOUT_ATM
	     Set to not build programs and libraries related to ATM networking.

     WITHOUT_AUDIT
	     Set to not build audit support into system programs.

     WITHOUT_AUTHPF
	     Set to not build authpf(8).

     WITHOUT_BIND
	     Setting this variable will prevent any  part  of  BIND  from  being
	     built.  When set, it also enforces the following options:

	     WITHOUT_BIND_DNSSEC
	     WITHOUT_BIND_ETC
	     WITHOUT_BIND_LIBS_LWRES
	     WITHOUT_BIND_MTREE
	     WITHOUT_BIND_NAMED
	     WITHOUT_BIND_UTILS

     WITHOUT_BIND_DNSSEC
	     Set  to  avoid  building or installing the DNSSEC related binaries,
	     dnssec-keygen(8) and dnssec-signzone(8).

     WITHOUT_BIND_ETC
	     Set to avoid installing the default files to /var/named/etc/namedb.

     WITH_BIND_LIBS
	     Set to install BIND libraries and include files.

     WITHOUT_BIND_LIBS_LWRES
	     Set  to  avoid  installing  the  lightweight  resolver  library  in
	     /usr/lib.

     WITHOUT_BIND_MTREE
	     Set to avoid running mtree(8) to create the chroot directory struc-
	     ture under /var/named, and avoid creating an /etc/namedb symlink to
	     the chroot directory.  When set, it also enforces the following op-
	     tions:

	     WITHOUT_BIND_ETC

     WITHOUT_BIND_NAMED
	     Set  to  avoid  building  or  installing named(8), named.reload(8),
	     named-checkconf(8),  named-checkzone(8),  rndc(8),  and  rndc-conf-
	     gen(8).

     WITHOUT_BIND_UTILS
	     Set  to  avoid  building or installing the BIND userland utilities,
	     dig(1), host(1), nslookup(1), and nsupdate(8).

     WITHOUT_BLUETOOTH
	     Set to not build Bluetooth related kernel modules, programs and li-
	     braries.

     WITHOUT_BOOT
	     Set to not build the boot blocks and loader.

     WITHOUT_BZIP2
	     Set to not build contributed bzip2 software as a part of  the  base
	     system.   The  option has no effect yet. When set, it also enforces
	     the following options:

	     WITHOUT_BZIP2_SUPPORT

     WITHOUT_BZIP2_SUPPORT
	     Set to build some programs without optional bzip2 support.

     WITHOUT_CALENDAR
	     Set to not build calendar(1).

     WITHOUT_CDDL
	     Set to not build code licensed under Sun's CDDL.  When set, it also
	     enforces the following options:

	     WITHOUT_ZFS

     WITHOUT_CPP
	     Set to not build cpp(1).

     WITHOUT_CRYPT
	     Set to not build any crypto code.	When set, it also  enforces  the
	     following options:

	     WITHOUT_GSSAPI (can be overridden with WITH_GSSAPI)
	     WITHOUT_KERBEROS
	     WITHOUT_KERBEROS_SUPPORT
	     WITHOUT_OPENSSH
	     WITHOUT_OPENSSL

     WITHOUT_CVS
	     Set to not build CVS.

     WITHOUT_CXX
	     Set to not build g++(1) and related libraries.

     WITHOUT_DICT
	     Set to not build the Webster dictionary files.

     WITHOUT_DYNAMICROOT
	     Set this if you do not want to link /bin and /sbin dynamically.

     WITHOUT_EXAMPLES
	     Set to avoid installing examples to /usr/share/examples/.

     WITHOUT_FORTH
	     Set to build bootloaders without Forth support.

     WITHOUT_FP_LIBC
	     Set to build libc without floating-point support.

     WITHOUT_GAMES
	     Set to not build games.

     WITHOUT_GCOV
	     Set to not build the gcov(1) tool.

     WITHOUT_GDB
	     Set to not build gdb(1).

     WITHOUT_GNU
	     Set  to  not  build  contributed GNU software as a part of the base
	     system.  This option can be useful if the	system	built  must  not
	     contain  any  code  covered  by the GNU Public License due to legal
	     reasons.  The option has no effect yet. When set, it also	enforces
	     the following options:

	     WITHOUT_GNU_SUPPORT

     WITHOUT_GNU_SUPPORT
	     Set to build some programs without optional GNU support.

     WITHOUT_GPIB
	     Set to not build GPIB bus support.

     WITHOUT_GROFF
	     Set to not build groff(1).

     WITHOUT_GSSAPI
	     Set to not build libgssapi.

     WITH_HESIOD
	     Set to build Hesiod support.

     WITHOUT_HTML
	     Set to not build HTML docs.

     WITHOUT_I4B
	     Set to not build isdn4bsd package.

     WITH_IDEA
	     Set  to  build  the IDEA encryption code.	This code is patented in
	     the USA and many European countries.  It is YOUR RESPONSIBILITY  to
	     determine if you can legally use IDEA.

     WITHOUT_INET6
	     Set to not build programs and libraries related to IPv6 networking.
	     When set, it also enforces the following options:

	     WITHOUT_INET6_SUPPORT

     WITHOUT_INET6_SUPPORT
	     Set  to  build libraries, programs, and kernel modules without IPv6
	     support.

     WITHOUT_INFO
	     Set to not make or install info(5) files.

     WITHOUT_IPFILTER
	     Set to not build IP Filter package.

     WITHOUT_IPX
	     Set to not build programs and libraries related to IPX  networking.
	     When set, it also enforces the following options:

	     WITHOUT_IPX_SUPPORT
	     WITHOUT_NCP

     WITHOUT_IPX_SUPPORT
	     Set to build some programs without IPX support.

     WITHOUT_KERBEROS
	     Set  this	if  you  do  not want to build Kerberos 5 (KTH Heimdal).
	     When set, it also enforces the following options:

	     WITHOUT_GSSAPI (can be overridden with WITH_GSSAPI)
	     WITHOUT_KERBEROS_SUPPORT

     WITHOUT_KERBEROS_SUPPORT
	     Set to build some programs without Kerberos support,  like  cvs(1),
	     ssh(1), telnet(1), sshd(8), and telnetd(8).

     WITHOUT_KVM
	     Set  to  not build the libkvm library as a part of the base system.
	     The option has no effect yet. When set, it also enforces  the  fol-
	     lowing options:

	     WITHOUT_KVM_SUPPORT

     WITHOUT_KVM_SUPPORT
	     Set to build some programs without optional libkvm support.

     WITHOUT_LIB32
	     On  amd64,  set to not build 32-bit library set and a ld-elf32.so.1
	     runtime linker.

     WITHOUT_LIBKSE
	     Set to not build the libkse (M:N threading) library.

     WITHOUT_LIBPTHREAD
	     Set to not build  either  of  the	libpthread  providing  libraries
	     (libthr (1:1) & libkse (M:N)).  When set, it also enforces the fol-
	     lowing options:

	     WITHOUT_BIND
	     WITHOUT_BIND_DNSSEC
	     WITHOUT_BIND_ETC
	     WITHOUT_BIND_LIBS_LWRES
	     WITHOUT_BIND_MTREE
	     WITHOUT_BIND_NAMED
	     WITHOUT_BIND_UTILS
	     WITHOUT_LIBKSE
	     WITHOUT_LIBTHR

     WITHOUT_LIBTHR
	     Set to not build the libthr (1:1 threading) library.

     WITHOUT_LOCALES
	     Set to not build localization files; see locale(1).

     WITHOUT_LPR
	     Set to not build lpr(1) and related programs.

     WITHOUT_MAILWRAPPER
	     Set to not build the mailwrapper(8) MTA selector.

     WITHOUT_MAN
	     Set to not build manual pages.

     WITHOUT_NCP
	     Set to not build programs, libraries, and kernel modules related to
	     NetWare Core protocol.

     WITHOUT_NETCAT
	     Set to not build nc(1) utility.

     WITHOUT_NIS
	     Set  to not build NIS(8) support and related programs.  If set, you
	     might need to adopt your nsswitch.conf(5) and remove `nis' entries.

     WITHOUT_NLS
	     Set to not build NLS catalogs.

     WITHOUT_NLS_CATALOGS
	     Set to not build NLS catalog support for csh(1).

     WITHOUT_NS_CACHING
	     Set to disable name caching in the nsswitch subsystem.  The generic
	     caching daemon, nscd(8), will not be built either if this option is
	     set.

     WITHOUT_OBJC
	     Set to not build Objective C support.

     WITHOUT_OPENSSH
	     Set to not build OpenSSH.

     WITHOUT_OPENSSL
	     Set to not build OpenSSL.	When set, it also enforces the following
	     options:

	     WITHOUT_GSSAPI (can be overridden with WITH_GSSAPI)
	     WITHOUT_KERBEROS
	     WITHOUT_KERBEROS_SUPPORT
	     WITHOUT_OPENSSH

     WITHOUT_PAM
	     Set to not build PAM library and modules.	This  option  is  depre-
	     cated  and  does  nothing. When set, it also enforces the following
	     options:

	     WITHOUT_PAM_SUPPORT

     WITHOUT_PAM_SUPPORT
	     Set to  build  some  programs  without  PAM  support,  particularly
	     ftpd(8) and ppp(8).

     WITHOUT_PF
	     Set  to  not build PF firewall package.  When set, it also enforces
	     the following options:

	     WITHOUT_AUTHPF

     WITHOUT_PROFILE
	     Set to avoid compiling profiled libraries.

     WITHOUT_RCMDS
	     Disable building of the BSD r-commands.  This  includes  rlogin(1),
	     rsh(1), etc.

     WITHOUT_RCS
	     Set to not build rcs(1) and related utilities.

     WITHOUT_RESCUE
	     Set to not build rescue(8).

     WITHOUT_SENDMAIL
	     Set to not build sendmail(8) and related programs.

     WITHOUT_SETUID_LOGIN
	     Set  this	to disable the installation of login(1) as a set-user-ID
	     root program.

     WITHOUT_SHAREDOCS
	     Set to not build the 4.4BSD legacy docs.

     WITHOUT_SSP
	     Set to not build propolice stack smashing protection library.

     WITHOUT_SYMVER
	     Set to disable symbol versioning when building shared libraries.

     WITHOUT_SYSCONS
	     Set to not build syscons(4) support files such  as  keyboard  maps,
	     fonts, and screen output maps.

     WITHOUT_TCSH
	     Set to not build and install /bin/csh (which is tcsh(1)).

     WITHOUT_TOOLCHAIN
	     Set  to  not install programs used for program development, compil-
	     ers, debuggers etc.  The option does not work  for  build	targets.
	     When set, it also enforces the following options:

	     WITHOUT_GDB

     WITHOUT_USB
	     Set to not build USB-related programs and libraries.

     WITHOUT_WPA_SUPPLICANT_EAPOL
	     Build  wpa_supplicant(8) without support for the IEEE 802.1X proto-
	     col and without support for EAP-PEAP, EAP-TLS, EAP-LEAP,  and  EAP-
	     TTLS protocols (usable only via 802.1X).

     WITHOUT_ZFS
	     Set to not build ZFS file system.

     WITHOUT_ZONEINFO
	     Set to not build the timezone database

FILES
     /etc/src.conf
     /usr/share/mk/bsd.own.mk

SEE ALSO
     make(1), make.conf(5), build(7), ports(7)

HISTORY
     The src.conf file appeared in FreeBSD 7.0.

AUTHORS
     This manual page was autogenerated.

FreeBSD 7.0			January 28, 2008		     SRC.CONF(5)

home | help