from FreeBSD$
$FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
.Dd June 26, 2008 .Dt SRC.CONF 5 .Os .Sh NAME .Nm src.conf .Nd "source build options" .Sh DESCRIPTION The .Nm file contains settings that will apply to every build involving the .Fx source tree; see .Xr build 7 .
p The .Nm file uses the standard makefile syntax. However, .Nm should not specify any dependencies to .Xr make 1 . Instead, .Nm is to set .Xr make 1 variables that control the aspects of how the system builds.
p The default location of .Nm is
a /etc/src.conf , though an alternative location can be specified in the .Xr make 1 variable .Va SRCCONF . Overriding the location of .Nm may be necessary if the system-wide settings are not suitable for a particular build. For instance, setting .Va SRCCONF to
a /dev/null effectively resets all build controls to their defaults.
p The only purpose of .Nm is to control the compilation of the .Fx source code, which is usually located in
a /usr/src . As a rule, the system administrator creates .Nm when the values of certain control variables need to be changed from their defaults.
p In addition, control variables can be specified for a particular build via the .Fl D option of .Xr make 1 or in environment; see .Xr environ 7 .
p The values of variables are ignored regardless of their setting; even if they would be set to .Dq Li FALSE or .Dq Li NO . Just the existence of an option will cause it to be honoured by .Xr make 1 .
p
The following list provides a name and short description for variables
that can be used for source builds.
l -tag -width indent t Va WITHOUT_ACPI $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr acpiconf 8 ,
.Xr acpidump 8
and related programs.
t Va WITHOUT_ASSERT_DEBUG $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to compile programs and libraries without the
.Xr assert 3
checks.
t Va WITHOUT_ATM $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
programs and libraries related to ATM networking.
t Va WITHOUT_AUDIT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build audit support into system programs.
t Va WITHOUT_AUTHPF $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr authpf 8 .
t Va WITHOUT_BIND $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Setting this variable will prevent any part of BIND from being built.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_BIND_DNSSEC
t .Va WITHOUT_BIND_ETC
t .Va WITHOUT_BIND_LIBS_LWRES
t .Va WITHOUT_BIND_MTREE
t .Va WITHOUT_BIND_NAMED
t .Va WITHOUT_BIND_UTILS
.El
t Va WITHOUT_BIND_DNSSEC $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid building or installing the DNSSEC related binaries,
.Xr dnssec-keygen 8
and
.Xr dnssec-signzone 8 .
t Va WITHOUT_BIND_ETC $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid installing the default files to
a /var/named/etc/namedb .
t Va WITH_BIND_LIBS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to install BIND libraries and include files.
t Va WITHOUT_BIND_LIBS_LWRES $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid installing the lightweight resolver library in
a /usr/lib .
t Va WITHOUT_BIND_MTREE $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid running
.Xr mtree 8
to create the chroot directory structure under
a /var/named , and avoid creating an
a /etc/namedb symlink to the chroot directory. When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_BIND_ETC
.El
t Va WITHOUT_BIND_NAMED $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid building or installing
.Xr named 8 ,
.Xr named.reload 8 ,
.Xr named-checkconf 8 ,
.Xr named-checkzone 8 ,
.Xr rndc 8 ,
and
.Xr rndc-confgen 8 .
t Va WITHOUT_BIND_UTILS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid building or installing the BIND userland utilities,
.Xr dig 1 ,
.Xr host 1 ,
.Xr nslookup 1 ,
and
.Xr nsupdate 8 .
t Va WITHOUT_BLUETOOTH $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build Bluetooth related kernel modules, programs and libraries.
t Va WITHOUT_BOOT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the boot blocks and loader.
t Va WITHOUT_BSD_CPIO from FreeBSD: head/tools/build/options/WITHOUT_BSD_CPIO 179813 2008-06-16 05:48:15Z dougb
Set to not build the BSD licensed version of cpio based on
.Xr libarchive 3 .
t Va WITHOUT_BZIP2 $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build contributed bzip2 software as a part of the base system.
f -symbolic The option has no effect yet.
.Ef
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_BZIP2_SUPPORT
.El
t Va WITHOUT_BZIP2_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without optional bzip2 support.
t Va WITHOUT_CALENDAR $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr calendar 1 .
t Va WITHOUT_CDDL $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build code licensed under Sun's CDDL.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_ZFS
.El
t Va WITHOUT_CPP $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr cpp 1 .
t Va WITHOUT_CRYPT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build any crypto code.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GSSAPI
(can be overridden with
.Va WITH_GSSAPI )
t .Va WITHOUT_KERBEROS
t .Va WITHOUT_KERBEROS_SUPPORT
t .Va WITHOUT_OPENSSH
t .Va WITHOUT_OPENSSL
.El
t Va WITHOUT_CVS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build CVS.
t Va WITHOUT_CXX $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr g++ 1
and related libraries.
t Va WITHOUT_DICT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the Webster dictionary files.
t Va WITHOUT_DYNAMICROOT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set this if you do not want to link
a /bin and
a /sbin
dynamically.
t Va WITHOUT_EXAMPLES $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid installing examples to
a /usr/share/examples/ .
t Va WITHOUT_FORTH $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build bootloaders without Forth support.
t Va WITHOUT_FP_LIBC $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build
.Nm libc
without floating-point support.
t Va WITHOUT_GAMES $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build games.
t Va WITHOUT_GCOV $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the
.Xr gcov 1
tool.
t Va WITHOUT_GDB $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr gdb 1 .
t Va WITHOUT_GNU $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
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.
f -symbolic The option has no effect yet.
.Ef
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GNU_SUPPORT
.El
t Va WITH_GNU_CPIO from FreeBSD: head/tools/build/options/WITH_GNU_CPIO 179813 2008-06-16 05:48:15Z dougb
Set to build GNU cpio as a part of the base system,
and symlink
a /usr/bin/cpio
to this version.
(This will override the symlink to the BSD version.)
t Va WITHOUT_GNU_GREP from FreeBSD: head/tools/build/options/WITHOUT_GNU_GREP 179813 2008-06-16 05:48:15Z dougb
Set to not build GNU grep as a part of the base system.
t Va WITHOUT_GNU_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without optional GNU support.
t Va WITHOUT_GPIB $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build GPIB bus support.
t Va WITHOUT_GROFF $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr groff 1 .
t Va WITHOUT_GSSAPI $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build libgssapi.
t Va WITH_HESIOD $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build Hesiod support.
t Va WITHOUT_HTML $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build HTML docs.
t Va WITH_IDEA $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build the IDEA encryption code.
This code is patented in the USA and many European countries.
It is
.Em "YOUR RESPONSIBILITY"
to determine if you can legally use IDEA.
t Va WITHOUT_INET6 $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
programs and libraries related to IPv6 networking.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_INET6_SUPPORT
.El
t Va WITHOUT_INET6_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build libraries, programs, and kernel modules without IPv6 support.
t Va WITHOUT_INFO $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not make or install
.Xr info 5
files.
t Va WITHOUT_INSTALLLIB $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set this if you do not want to install optional libraries.
For example when creating a
.Xr nanobsd 8
image.
t Va WITHOUT_IPFILTER $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build IP Filter package.
t Va WITHOUT_IPX $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build programs and libraries related to IPX networking.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_IPX_SUPPORT
t .Va WITHOUT_NCP
.El
t Va WITHOUT_IPX_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without IPX support.
t Va WITHOUT_KERBEROS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set this if you do not want to build Kerberos 5 (KTH Heimdal).
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GSSAPI
(can be overridden with
.Va WITH_GSSAPI )
t .Va WITHOUT_KERBEROS_SUPPORT
.El
t Va WITHOUT_KERBEROS_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without Kerberos support, like
.Xr cvs 1 ,
.Xr ssh 1 ,
.Xr telnet 1 ,
.Xr sshd 8 ,
and
.Xr telnetd 8 .
t Va WITHOUT_KVM $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the
.Nm libkvm
library as a part of the base system.
f -symbolic The option has no effect yet.
.Ef
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_KVM_SUPPORT
.El
t Va WITHOUT_KVM_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without optional
.Nm libkvm
support.
t Va WITHOUT_LIB32 $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
On amd64, set to not build 32-bit library set and a
.Nm ld-elf32.so.1
runtime linker.
t Va WITHOUT_LIBPTHREAD $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build either of the
.Nm libpthread
providing libraries
.Nm ( libthr
(1:1) &
.Nm libkse
(M:N)).
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_BIND
t .Va WITHOUT_BIND_DNSSEC
t .Va WITHOUT_BIND_ETC
t .Va WITHOUT_BIND_LIBS_LWRES
t .Va WITHOUT_BIND_MTREE
t .Va WITHOUT_BIND_NAMED
t .Va WITHOUT_BIND_UTILS
t .Va WITHOUT_LIBTHR
.El
t Va WITHOUT_LIBTHR $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the
.Nm libthr
(1:1 threading)
library.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_BIND
t .Va WITHOUT_BIND_DNSSEC
t .Va WITHOUT_BIND_ETC
t .Va WITHOUT_BIND_LIBS_LWRES
t .Va WITHOUT_BIND_MTREE
t .Va WITHOUT_BIND_NAMED
t .Va WITHOUT_BIND_UTILS
.El
t Va WITHOUT_LOCALES $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build localization files; see
.Xr locale 1 .
t Va WITHOUT_LPR $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr lpr 1
and related programs.
t Va WITHOUT_MAILWRAPPER $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the
.Xr mailwrapper 8
MTA selector.
t Va WITHOUT_MAN $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build manual pages.
t Va WITHOUT_NCP $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build programs, libraries, and kernel modules
related to NetWare Core protocol.
t Va WITHOUT_NETCAT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr nc 1
utility.
t Va WITHOUT_NIS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr NIS 8
support and related programs.
If set, you might need to adopt your
.Xr nsswitch.conf 5
and remove
.Sq nis
entries.
t Va WITHOUT_NLS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build NLS catalogs.
t Va WITHOUT_NLS_CATALOGS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build NLS catalog support for
.Xr csh 1 .
t Va WITHOUT_NS_CACHING $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to disable name caching in the
a nsswitch
subsystem.
The generic caching daemon,
.Xr nscd 8 ,
will not be built either if this option is set.
t Va WITHOUT_OBJC $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build Objective C support.
t Va WITHOUT_OPENSSH $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build OpenSSH.
t Va WITHOUT_OPENSSL $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build OpenSSL.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GSSAPI
(can be overridden with
.Va WITH_GSSAPI )
t .Va WITHOUT_KERBEROS
t .Va WITHOUT_KERBEROS_SUPPORT
t .Va WITHOUT_OPENSSH
.El
t Va WITHOUT_PAM $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build PAM library and modules.
f -symbolic This option is deprecated and does nothing.
.Ef
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_PAM_SUPPORT
.El
t Va WITHOUT_PAM_SUPPORT $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to build some programs without PAM support, particularly
.Xr ftpd 8
and
.Xr ppp 8 .
t Va WITHOUT_PF $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build PF firewall package.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_AUTHPF
.El
t Va WITHOUT_PROFILE $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to avoid compiling profiled libraries.
t Va WITHOUT_RCMDS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Disable building of the
x r-commands.
This includes
.Xr rlogin 1 ,
.Xr rsh 1 ,
etc.
t Va WITHOUT_RCS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr rcs 1
and related utilities.
t Va WITHOUT_RESCUE $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr rescue 8 .
t Va WITHOUT_SENDMAIL $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr sendmail 8
and related programs.
t Va WITHOUT_SETUID_LOGIN $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set this to disable the installation of
.Xr login 1
as a set-user-ID root program.
t Va WITHOUT_SHAREDOCS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the
x 4.4 legacy docs.
t Va WITHOUT_SSP from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
Set to not build world with propolice stack smashing protection.
t Va WITHOUT_SYMVER $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to disable symbol versioning when building shared libraries.
t Va WITHOUT_SYSCONS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build
.Xr syscons 4
support files such as keyboard maps, fonts, and screen output maps.
t Va WITHOUT_TCSH $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build and install
a /bin/csh
(which is
.Xr tcsh 1 ) .
t Va WITHOUT_TOOLCHAIN $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not install
programs used for program development,
compilers, debuggers etc.
f -symbolic The option does not work for build targets.
.Ef
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GDB
.El
t Va WITHOUT_USB $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build USB-related programs and libraries.
t Va WITHOUT_WPA_SUPPLICANT_EAPOL $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Build
.Xr wpa_supplicant 8
without support for the IEEE 802.1X protocol and without
support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
protocols (usable only via 802.1X).
t Va WITHOUT_ZFS $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build ZFS file system.
t Va WITHOUT_ZONEINFO $FreeBSD: head/share/man/man5/src.conf.5 180013 2008-06-25 21:36:25Z ru $
Set to not build the timezone database
.El
.Sh FILES
l -tag -compact t Pa /etc/src.conf t Pa /usr/share/mk/bsd.own.mk .El
.Sh SEE ALSO
.Xr make 1 ,
.Xr make.conf 5 ,
.Xr build 7 ,
.Xr ports 7
.Sh HISTORY
The
.Nm
file appeared in
.Fx 7.0 .
.Sh AUTHORS
This manual page was autogenerated.