from FreeBSD: src/tools/build/options/makeman,v 1.2 2006/03/21 09:08:45 ru Exp
$FreeBSD: head/share/man/man5/src.conf.5 157718 2006-04-13 10:38:43Z ru $
.Dd April 13, 2006 .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 maybe 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 sources, which are usually found 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; the variable being set at all (even to .Dq Li FALSE or .Dq Li NO ) causes it to be treated as if it was set with no value.
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 from FreeBSD: src/tools/build/options/WITHOUT_ACPI,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr acpiconf 8 ,
.Xr acpidump 8
and related programs.
t Va WITHOUT_ATM from FreeBSD: src/tools/build/options/WITHOUT_ATM,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
programs and libraries related to ATM networking.
t Va WITHOUT_AUDIT from FreeBSD: src/tools/build/options/WITHOUT_AUDIT,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build audit support into system programs.
t Va WITHOUT_AUTHPF from FreeBSD: src/tools/build/options/WITHOUT_AUTHPF,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr authpf 8 .
t Va WITHOUT_BIND from FreeBSD: src/tools/build/options/WITHOUT_BIND,v 1.1 2006/03/21 07:50:49 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_BIND_DNSSEC,v 1.1 2006/03/21 07:50:49 ru Exp
Set to avoid building or installing the DNSSEC related binaries,
.Xr dnssec-keygen 8
and
.Xr dnssec-signzone 8 .
t Va WITHOUT_BIND_ETC from FreeBSD: src/tools/build/options/WITHOUT_BIND_ETC,v 1.1 2006/03/21 07:50:49 ru Exp
Set to avoid installing the default files to
a /var/named/etc/namedb .
t Va WITH_BIND_LIBS from FreeBSD: src/tools/build/options/WITH_BIND_LIBS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to install BIND libraries and include files.
t Va WITHOUT_BIND_LIBS_LWRES from FreeBSD: src/tools/build/options/WITHOUT_BIND_LIBS_LWRES,v 1.1 2006/03/21 07:50:49 ru Exp
Set to avoid installing the lightweight resolver library in
a /usr/lib .
t Va WITHOUT_BIND_MTREE from FreeBSD: src/tools/build/options/WITHOUT_BIND_MTREE,v 1.3 2006/04/13 10:37:29 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_BIND_NAMED,v 1.1 2006/03/21 07:50:49 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_BIND_UTILS,v 1.1 2006/03/21 07:50:49 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_BLUETOOTH,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build Bluetooth related kernel modules, programs and libraries.
t Va WITHOUT_BOOT from FreeBSD: src/tools/build/options/WITHOUT_BOOT,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build the boot blocks and loader.
t Va WITHOUT_CALENDAR from FreeBSD: src/tools/build/options/WITHOUT_CALENDAR,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr calendar 1 .
t Va WITHOUT_CPP from FreeBSD: src/tools/build/options/WITHOUT_CPP,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr cpp 1 .
t Va WITHOUT_CRYPT from FreeBSD: src/tools/build/options/WITHOUT_CRYPT,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build any crypto code.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_KERBEROS
t .Va WITHOUT_KERBEROS_SUPPORT
t .Va WITHOUT_OPENSSH
t .Va WITHOUT_OPENSSL
.El
t Va WITHOUT_CVS from FreeBSD: src/tools/build/options/WITHOUT_CVS,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build CVS.
t Va WITHOUT_CXX from FreeBSD: src/tools/build/options/WITHOUT_CXX,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr g++ 1
and related libraries.
t Va WITHOUT_DICT from FreeBSD: src/tools/build/options/WITHOUT_DICT,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build the Webster dictionary files.
t Va WITHOUT_DYNAMICROOT from FreeBSD: src/tools/build/options/WITHOUT_DYNAMICROOT,v 1.1 2006/03/21 07:50:49 ru Exp
Set this if you do not want to link
a /bin and
a /sbin
dynamically.
t Va WITHOUT_EXAMPLES from FreeBSD: src/tools/build/options/WITHOUT_EXAMPLES,v 1.2 2006/03/21 09:06:24 ru Exp
Set to avoid installing examples to
a /usr/share/examples/ .
t Va WITHOUT_FORTH from FreeBSD: src/tools/build/options/WITHOUT_FORTH,v 1.1 2006/03/21 07:50:49 ru Exp
Set to build bootloaders without Forth support.
t Va WITHOUT_FORTRAN from FreeBSD: src/tools/build/options/WITHOUT_FORTRAN,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr g77 1
and related libraries.
t Va WITHOUT_FP_LIBC from FreeBSD: src/tools/build/options/WITHOUT_FP_LIBC,v 1.1 2006/03/21 07:50:49 ru Exp
Set to build
.Nm libc
without floating-point support.
t Va WITHOUT_GAMES from FreeBSD: src/tools/build/options/WITHOUT_GAMES,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build games.
t Va WITHOUT_GCOV from FreeBSD: src/tools/build/options/WITHOUT_GCOV,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build the
.Xr gcov 1
tool.
t Va WITHOUT_GDB from FreeBSD: src/tools/build/options/WITHOUT_GDB,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr gdb 1 .
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GNU_SUPPORT
.El
t Va WITHOUT_GNU_SUPPORT from FreeBSD: src/tools/build/options/WITHOUT_GNU_SUPPORT,v 1.1 2006/03/21 07:50:49 ru Exp
Set to build some programs without optional GNU support.
t Va WITHOUT_GPIB from FreeBSD: src/tools/build/options/WITHOUT_GPIB,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build GPIB bus support.
t Va WITHOUT_GROFF from FreeBSD: src/tools/build/options/WITHOUT_GROFF,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build
.Xr groff 1 .
t Va WITH_HESIOD from FreeBSD: src/tools/build/options/WITH_HESIOD,v 1.1 2006/03/21 07:50:50 ru Exp
Set to build Hesiod support.
t Va WITHOUT_HTML from FreeBSD: src/tools/build/options/WITHOUT_HTML,v 1.1 2006/03/21 07:50:49 ru Exp
Set to not build HTML docs.
t Va WITHOUT_I4B from FreeBSD: src/tools/build/options/WITHOUT_I4B,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build isdn4bsd package.
t Va WITH_IDEA from FreeBSD: src/tools/build/options/WITH_IDEA,v 1.1 2006/03/21 07:50:50 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_INET6,v 1.1 2006/03/21 07:50:50 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_INET6_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
Set to build libraries, programs, and kernel modules without IPv6 support.
t Va WITHOUT_INFO from FreeBSD: src/tools/build/options/WITHOUT_INFO,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not make or install
.Xr info 5
files.
t Va WITHOUT_IPFILTER from FreeBSD: src/tools/build/options/WITHOUT_IPFILTER,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build IP Filter package.
t Va WITHOUT_IPX from FreeBSD: src/tools/build/options/WITHOUT_IPX,v 1.1 2006/03/21 07:50:50 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_IPX_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
Set to build some programs without IPX support.
t Va WITHOUT_KERBEROS from FreeBSD: src/tools/build/options/WITHOUT_KERBEROS,v 1.1 2006/03/21 07:50:50 ru Exp
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_KERBEROS_SUPPORT
.El
t Va WITHOUT_KERBEROS_SUPPORT from FreeBSD: src/tools/build/options/WITHOUT_KERBEROS_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
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_LIB32 from FreeBSD: src/tools/build/options/WITHOUT_LIB32,v 1.1 2006/03/21 07:50:50 ru Exp
On amd64, set to not build 32-bit library set and a
.Nm ld-elf32.so.1
runtime linker.
t Va WITHOUT_LIBC_R from FreeBSD: src/tools/build/options/WITHOUT_LIBC_R,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Nm libc_r
(reentrant version of
.Nm libc ) .
t Va WITHOUT_LIBPTHREAD from FreeBSD: src/tools/build/options/WITHOUT_LIBPTHREAD,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build the
.Nm libpthread
(M:N threading)
library.
t Va WITHOUT_LIBTHR from FreeBSD: src/tools/build/options/WITHOUT_LIBTHR,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build the
.Nm libthr
(1:1 threading)
library.
t Va WITHOUT_LOCALES from FreeBSD: src/tools/build/options/WITHOUT_LOCALES,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build localization files; see
.Xr locale 1 .
t Va WITHOUT_LPR from FreeBSD: src/tools/build/options/WITHOUT_LPR,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr lpr 1
and related programs.
t Va WITHOUT_MAILWRAPPER from FreeBSD: src/tools/build/options/WITHOUT_MAILWRAPPER,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build the
.Xr mailwrapper 8
MTA selector.
t Va WITHOUT_MAN from FreeBSD: src/tools/build/options/WITHOUT_MAN,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build manual pages.
t Va WITHOUT_NCP from FreeBSD: src/tools/build/options/WITHOUT_NCP,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build programs, libraries, and kernel modules
related to NetWare Core protocol.
t Va WITHOUT_NETCAT from FreeBSD: src/tools/build/options/WITHOUT_NETCAT,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr nc 1
utility.
t Va WITHOUT_NIS from FreeBSD: src/tools/build/options/WITHOUT_NIS,v 1.1 2006/03/21 07:50:50 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_NLS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build NLS catalogs.
t Va WITHOUT_NLS_CATALOGS from FreeBSD: src/tools/build/options/WITHOUT_NLS_CATALOGS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build NLS catalog support for
.Xr csh 1 .
t Va WITHOUT_OBJC from FreeBSD: src/tools/build/options/WITHOUT_OBJC,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build Objective C support.
t Va WITHOUT_OPENSSH from FreeBSD: src/tools/build/options/WITHOUT_OPENSSH,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build OpenSSH.
t Va WITHOUT_OPENSSL from FreeBSD: src/tools/build/options/WITHOUT_OPENSSL,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build OpenSSL.
When set, it also enforces the following options:
p l -item -compact t .Va WITHOUT_KERBEROS t .Va WITHOUT_KERBEROS_SUPPORT t .Va WITHOUT_OPENSSH .El When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_PAM_SUPPORT
.El
t Va WITHOUT_PAM_SUPPORT from FreeBSD: src/tools/build/options/WITHOUT_PAM_SUPPORT,v 1.1 2006/03/21 07:50:50 ru Exp
Set to build some programs without PAM support, particularly
.Xr ftpd 8
and
.Xr ppp 8 .
t Va WITHOUT_PCVT from FreeBSD: src/tools/build/options/WITHOUT_PCVT,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr pcvt 4
system console utilities.
t Va WITHOUT_PF from FreeBSD: src/tools/build/options/WITHOUT_PF,v 1.1 2006/03/21 07:50:50 ru Exp
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 from FreeBSD: src/tools/build/options/WITHOUT_PROFILE,v 1.1 2006/03/21 07:50:50 ru Exp
Set to avoid compiling profiled libraries.
t Va WITHOUT_RCMDS from FreeBSD: src/tools/build/options/WITHOUT_RCMDS,v 1.1 2006/03/21 07:50:50 ru Exp
Disable building of the
x r-commands.
This includes
.Xr rlogin 1 ,
.Xr rsh 1 ,
etc.
t Va WITHOUT_RCS from FreeBSD: src/tools/build/options/WITHOUT_RCS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr rcs 1
and related utilities.
t Va WITHOUT_RESCUE from FreeBSD: src/tools/build/options/WITHOUT_RESCUE,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr rescue 8 .
t Va WITHOUT_SENDMAIL from FreeBSD: src/tools/build/options/WITHOUT_SENDMAIL,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr sendmail 8
and related programs.
t Va WITHOUT_SETUID_LOGIN from FreeBSD: src/tools/build/options/WITHOUT_SETUID_LOGIN,v 1.1 2006/03/21 07:50:50 ru Exp
Set this to disable the installation of
.Xr login 1
as a set-user-ID root program.
t Va WITHOUT_SHAREDOCS from FreeBSD: src/tools/build/options/WITHOUT_SHAREDOCS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build the
x 4.4 legacy docs.
t Va WITHOUT_SYSCONS from FreeBSD: src/tools/build/options/WITHOUT_SYSCONS,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
.Xr syscons 4
support files such as keyboard maps, fonts, and screen output maps.
t Va WITHOUT_TCSH from FreeBSD: src/tools/build/options/WITHOUT_TCSH,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build and install
a /bin/csh
(which is
.Xr tcsh 1 ) .
t Va WITHOUT_TOOLCHAIN from FreeBSD: src/tools/build/options/WITHOUT_TOOLCHAIN,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build
programs used for program development,
compilers, debuggers etc.
When set, it also enforces the following options:
p
l -item -compact t .Va WITHOUT_GDB
.El
t Va WITHOUT_USB from FreeBSD: src/tools/build/options/WITHOUT_USB,v 1.1 2006/03/21 07:50:50 ru Exp
Set to not build USB-related programs and libraries.
t Va WITHOUT_WPA_SUPPLICANT_EAPOL from FreeBSD: src/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL,v 1.1 2006/03/21 07:50:50 ru Exp
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).
.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.