NAME
src.conf
—
source build options
DESCRIPTION
Thesrc.conf
file contains settings that will apply to
every build involving 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 its environment; see
environ(7).
The environment of make(1) for the build can be controlled via the SRC_ENV_CONF variable, which defaults to /etc/src-env.conf. Some examples that may only be set in this file are WITH_DIRDEPS_BUILD, and WITH_META_MODE as they are environment-only variables. Note that MAKEOBJDIRPREFIX may be set here only when using WITH_DIRDEPS_BUILD.
The values of variables are ignored regardless of their setting;
even if they would be set to “FALSE
”
or “NO
”. The presence of an option
causes it to be honored by
make(1).
This list provides a name and short description for variables that can be used for source builds.
- WITHOUT_ACCT
- Set to not build process accounting tools such as accton(8) and sa(8).
- WITHOUT_ACPI
- Set to not build acpiconf(8), acpidump(8) and related programs.
- WITHOUT_AMD
- Set to not build amd(8), and related programs.
- WITHOUT_APM
- Set to not build apm(8), apmd(8) and related programs.
- WITHOUT_ASSERT_DEBUG
- Set to compile programs and libraries without the assert(3) checks.
- WITHOUT_AT
- Set to not build at(1) and related utilities.
- 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_AUTOFS
- Set to not build autofs(5) related programs, libraries, and kernel modules.
- WITH_AUTO_OBJ
- Enable automatic creation of objdirs.
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITHOUT_BHYVE
- Set to not build or install
bhyve(8), associated utilities, and examples.
This option only affects amd64/amd64.
- WITHOUT_BINUTILS
- Set to not build or install binutils (as, ld, objcopy, and objdump ) as
part of the normal system build. The resulting system cannot build
programs from source.
This is a default setting on arm64/aarch64.
- WITH_BINUTILS
- Set to build and install binutils (as, ld, objcopy, and objdump) as part
of the normal system build.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_BINUTILS_BOOTSTRAP
- Set to not build binutils (as, ld, objcopy and objdump) as part of the
bootstrap process.
The option does not work for build targets unless some alternative toolchain is provided.
This is a default setting on arm64/aarch64.
- WITH_BINUTILS_BOOTSTRAP
- Set build binutils (as, ld, objcopy and objdump) as part of the bootstrap
process.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_BLACKLIST
- Set this if you do not want to build
blacklistd(8) and
blacklistctl(8). When set, it enforces these options:
- WITHOUT_BLACKLIST_SUPPORT
- WITHOUT_BLACKLIST_SUPPORT
- Set to build some programs without libblacklist(3) support, like fingerd(8), ftpd(8), rlogind(8), rshd(8), and sshd(8).
- WITHOUT_BLUETOOTH
- Set to not build Bluetooth related kernel modules, programs and libraries.
- WITHOUT_BOOT
- Set to not build the boot blocks and loader.
- WITHOUT_BOOTPARAMD
- Set to not build or install bootparamd(8).
- WITHOUT_BOOTPD
- Set to not build or install bootpd(8).
- WITHOUT_BSDINSTALL
- Set to not build bsdinstall(8), sade(8), and related programs.
- WITHOUT_BSD_CPIO
- Set to not build the BSD licensed version of cpio based on libarchive(3).
- WITH_BSD_GREP
- Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
- WITHOUT_BSNMP
- Set to not build or install bsnmpd(1) and related libraries and data files.
- 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 enforces these 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_CAPSICUM
- Set to not build Capsicum support into system programs. When set, it
enforces these options:
- WITHOUT_CASPER
- WITHOUT_CASPER
- Set to not build Casper program and related libraries.
- WITH_CCACHE_BUILD
- Set to use ccache(1) for the build. No configuration is required
except to install the
devel/ccache
package. When using with
distcc(1), set
CCACHE_PREFIX=/usr/local/bin/distcc.
The default cache directory of $HOME/.ccache will
be used, which can be overridden by setting
CCACHE_DIR.
The
CCACHE_COMPILERCHECK
option defaults to
content
when using the in-tree bootstrap compiler, and
mtime
when using an external compiler. The
CCACHE_CPP2
option is used for Clang but not GCC.
Sharing a cache between multiple work directories requires using a layout similar to /some/prefix/src /some/prefix/obj and an environment such as:
CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
See ccache(1) for more configuration options.
- WITHOUT_CCD
- Set to not build geom_ccd(4) and related utilities.
- WITHOUT_CDDL
- Set to not build code licensed under Sun's CDDL. When set, it enforces
these options:
- WITHOUT_CTF
- WITHOUT_ZFS
- WITHOUT_CLANG
- Set to not build the Clang C/C++ compiler during the regular phase of the
build.
This is a default setting on sparc64/sparc64. When set, it enforces these options:
- WITHOUT_CLANG_EXTRAS
- WITHOUT_CLANG_FULL
- WITH_CLANG
- Set to build the Clang C/C++ compiler during the normal phase of the
build.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc and powerpc/powerpc64.
- WITHOUT_CLANG_BOOTSTRAP
- Set to not build the Clang C/C++ compiler during the bootstrap phase of
the build. To be able to build the system, either gcc or clang bootstrap
must be enabled unless an alternate compiler is provided via XCC.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_CLANG_BOOTSTRAP
- Set to build the Clang C/C++ compiler during the bootstrap phase of the
build.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITH_CLANG_EXTRAS
- Set to build additional clang and llvm tools, such as bugpoint.
- WITHOUT_CLANG_FULL
- Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer
components of the Clang C/C++ compiler.
This is a default setting on sparc64/sparc64.
- WITH_CLANG_FULL
- Set to build the ARCMigrate, Rewriter and StaticAnalyzer components of the
Clang C/C++ compiler.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc and powerpc/powerpc64.
- WITHOUT_CLANG_IS_CC
- Set to install the GCC compiler as /usr/bin/cc,
/usr/bin/c++ and
/usr/bin/cpp.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_CLANG_IS_CC
- Set to install the Clang C/C++ compiler as
/usr/bin/cc, /usr/bin/c++
and /usr/bin/cpp.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITHOUT_CPP
- Set to not build cpp(1).
- WITHOUT_CROSS_COMPILER
- Set to not build any cross compiler in the cross-tools stage of
buildworld. When compiling a different version of
FreeBSD than what is installed on the system,
provide an alternate compiler with XCC to ensure success. When compiling
with an identical version of FreeBSD to the host,
this option may be safely used. This option may also be safe when the host
version of FreeBSD is close to the sources being
built, but all bets are off if there have been any changes to the
toolchain between the versions. When set, it enforces these options:
- WITHOUT_BINUTILS_BOOTSTRAP
- WITHOUT_CLANG_BOOTSTRAP
- WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
- WITHOUT_GCC_BOOTSTRAP
- WITHOUT_CRYPT
- Set to not build any crypto code. When set, it enforces these options:
- WITHOUT_KERBEROS
- WITHOUT_KERBEROS_SUPPORT
- WITHOUT_OPENSSH
- WITHOUT_OPENSSL
When set, these options are also in effect:
- WITHOUT_GSSAPI
- (unless WITH_GSSAPI is set explicitly)
- WITH_CTF
- Set to compile with CTF (Compact C Type Format) data. CTF data encapsulates a reduced form of debugging information similar to DWARF and the venerable stabs and is required for DTrace.
- WITHOUT_CTM
- Set to not build ctm(1) and related utilities.
- WITHOUT_CUSE
- Set to not build CUSE-related programs and libraries.
- WITHOUT_CXGBETOOL
- Set to not build
cxgbetool(8)
This is a default setting on arm/arm, arm/armeb, arm/armv6, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32 and powerpc/powerpc.
- WITH_CXGBETOOL
- Set to build
cxgbetool(8)
This is a default setting on amd64/amd64, arm64/aarch64, i386/i386, pc98/i386, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_CXX
- Set to not build c++(1) and related libraries. It will also prevent building
of gperf(1) and
devd(8). When set, it enforces these options:
- WITHOUT_CLANG
- WITHOUT_CLANG_EXTRAS
- WITHOUT_CLANG_FULL
- WITHOUT_GNUCXX
- WITHOUT_GROFF
- WITHOUT_DEBUG_FILES
- Set to avoid building or installing standalone debug files for each executable binary and shared library.
- WITHOUT_DIALOG
- Set to not build
dialog(1),
dialog(3),
dpv(1), and
dpv(3). When set, it enforces these options:
- WITHOUT_BSDINSTALL
- WITHOUT_DICT
- Set to not build the Webster dictionary files.
- WITH_DIRDEPS_BUILD
- This is an experimental build system. For details see
http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm. Build commands can
be seen from the top-level with:
The build is driven by dirdeps.mk using DIRDEPS stored in Makefile.depend files found in each directory.
make show-valid-targets
The build can be started from anywhere, and behaves the same. The initial instance of make(1) recursively reads DIRDEPS from Makefile.depend, computing a graph of tree dependencies from the current origin. Setting NO_DIRDEPS skips checking dirdep dependencies and will only build in the current and child directories. NO_DIRDEPS_BELOW skips building any dirdeps and only build the current directory.
This also utilizes the WITH_META_MODE logic for incremental builds.
The build hides commands executed unless NO_SILENT is defined.
Note that there is currently no mass install feature for this.
When set, it enforces these options:
- WITH_INSTALL_AS_USER
When set, these options are also in effect:
- WITHOUT_SYSTEM_COMPILER
- (unless WITH_SYSTEM_COMPILER is set explicitly)
- WITH_AUTO_OBJ
- (unless WITHOUT_AUTO_OBJ is set explicitly)
- WITH_META_MODE
- (unless WITHOUT_META_MODE is set explicitly)
- WITH_STAGING
- (unless WITHOUT_STAGING is set explicitly)
- WITH_STAGING_MAN
- (unless WITHOUT_STAGING_MAN is set explicitly)
- WITH_STAGING_PROG
- (unless WITHOUT_STAGING_PROG is set explicitly)
- WITH_SYSROOT
- (unless WITHOUT_SYSROOT is set explicitly)
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITH_DIRDEPS_CACHE
- Cache result of dirdeps.mk which can save significant time for subsequent
builds. Depends on WITH_DIRDEPS_BUILD.
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITHOUT_DMAGENT
- Set to not build dma Mail Transport Agent.
- WITHOUT_DOCCOMPRESS
- Set to not install compressed system documentation. Only the uncompressed version will be installed.
- WITH_DTRACE_TESTS
- Set to build and install the DTrace test suite in /usr/tests/cddl/usr.sbin/dtrace. This test suite is considered experimental on architectures other than amd64/amd64 and running it may cause system instability.
- WITHOUT_DYNAMICROOT
- Set this if you do not want to link /bin and /sbin dynamically.
- WITHOUT_ED_CRYPTO
- Set to build ed(1) without support for encryption/decryption.
- WITHOUT_EE
- Set to not build and install edit(1), ee(1), and related programs.
- WITHOUT_EFI
- Set not to build
efivar(3) and
efivar(8).
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_EFI
- Set to build
efivar(3) and
efivar(8).
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITH_EISA
- Set to build EISA kernel modules.
- WITHOUT_ELFCOPY_AS_OBJCOPY
- Set to build and install objcopy(1) from GNU Binutils, instead of the one from ELF Tool Chain. This option is provided as a transition aid and will be removed in due time.
- WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
- Set to not build ELF Tool Chain tools (addr2line, nm, size, strings and
strip) as part of the bootstrap process.
An alternate bootstrap tool chain must be provided.
- WITHOUT_EXAMPLES
- Set to avoid installing examples to /usr/share/examples/.
- WITH_EXTRA_TCP_STACKS
- Set to build extra TCP stack modules.
- WITHOUT_FDT
- Set to not build Flattened Device Tree support as part of the base system. This includes the device tree compiler (dtc) and libfdt support library.
- WITHOUT_FILE
- Set to not build file(1) and related programs.
- WITHOUT_FINGER
- Set to not build or install finger(1) and fingerd(8).
- WITHOUT_FLOPPY
- Set to not build or install programs for operating floppy disk driver.
- WITHOUT_FMTREE
- Set to not build and install /usr/sbin/fmtree.
- WITHOUT_FORMAT_EXTENSIONS
- Set to not enable
-fformat-extensions
when compiling the kernel. Also disables all format checking. - WITHOUT_FORTH
- Set to build bootloaders without Forth support.
- WITHOUT_FP_LIBC
- Set to build
libc
without floating-point support. - WITHOUT_FREEBSD_UPDATE
- Set to not build freebsd-update(8).
- WITHOUT_FTP
- Set to not build or install ftp(1) and ftpd(8).
- WITHOUT_GAMES
- Set to not build games.
- WITHOUT_GCC
- Set to not build and install gcc and g++ as part of the normal build
process.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITH_GCC
- Set to build and install gcc and g++.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_GCC_BOOTSTRAP
- Set to not build gcc and g++ as part of the bootstrap process. You must
enable either gcc or clang bootstrap to be able to build the system,
unless an alternative compiler is provided via XCC.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITH_GCC_BOOTSTRAP
- Set to build gcc and g++ as part of the bootstrap process.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_GCOV
- Set to not build the gcov(1) tool.
- WITHOUT_GDB
- Set to not build gdb(1).
This is a default setting on arm64/aarch64.
- WITH_GDB
- Set to build gdb(1).
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- 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 enforces these options:
- WITHOUT_GNU_SUPPORT
- WITHOUT_GNUCXX
- Do not build the GNU C++ stack (g++, libstdc++). This is the default on
platforms where clang is the system compiler.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITH_GNUCXX
- Build the GNU C++ stack (g++, libstdc++). This is the default on platforms
where gcc is the system compiler.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITHOUT_GNU_GREP_COMPAT
- Set this option to omit the gnu extensions to grep from being included in BSD grep.
- WITHOUT_GNU_SUPPORT
- Set to build some programs without optional GNU support.
- WITHOUT_GPIO
- Set to not build gpioctl(8) as part of the base system.
- WITHOUT_GPL_DTC
- Set to build the BSD licensed version of the device tree compiler rather than the GPLed one from elinux.org.
- WITHOUT_GROFF
- Set to not build groff(1) and vgrind(1). You should consider installing the textproc/groff port to not break man(1).
- WITHOUT_GSSAPI
- Set to not build libgssapi.
- WITHOUT_HAST
- Set to not build hastd(8) and related utilities.
- WITH_HESIOD
- Set to build Hesiod support.
- WITHOUT_HTML
- Set to not build HTML docs.
- WITHOUT_HYPERV
- Set to not build or install HyperV utilities.
- WITHOUT_ICONV
- Set to not build iconv as part of libc.
- WITHOUT_INCLUDES
- Set to not install header files. This option used to be spelled
NO_INCS.
The option does not work for build targets.
- WITHOUT_INET
- Set to not build programs and libraries related to IPv4 networking. When
set, it enforces these options:
- WITHOUT_INET_SUPPORT
- WITHOUT_INET6
- Set to not build programs and libraries related to IPv6 networking. When
set, it enforces these options:
- WITHOUT_INET6_SUPPORT
- WITHOUT_INET6_SUPPORT
- Set to build libraries, programs, and kernel modules without IPv6 support.
- WITHOUT_INETD
- Set to not build inetd(8).
- WITHOUT_INET_SUPPORT
- Set to build libraries, programs, and kernel modules without IPv4 support.
- WITHOUT_INSTALLLIB
- Set this if to not install optional libraries. For example, when creating
a nanobsd(8) image.
The option does not work for build targets.
- WITH_INSTALL_AS_USER
- Set to make install targets succeed for non-root users by installing files with owner and group attributes set to that of the user running the make(1) command. The user still must set the DESTDIR variable to point to a directory where the user has write permissions.
- WITHOUT_IPFILTER
- Set to not build IP Filter package.
- WITHOUT_IPFW
- Set to not build IPFW tools.
- WITHOUT_IPSEC_SUPPORT
- Set to not build the kernel with ipsec(4) support. This option is needed for ipsec(4) and tcpmd5(4).
- WITHOUT_ISCSI
- Set to not build iscid(8) and related utilities.
- WITHOUT_JAIL
- Set to not build tools for the support of jails; e.g., jail(8).
- WITHOUT_KDUMP
- Set to not build kdump(1) and truss(1).
- WITHOUT_KERBEROS
- Set this to not build Kerberos 5 (KTH Heimdal). When set, it enforces
these options:
- WITHOUT_KERBEROS_SUPPORT
When set, these options are also in effect:
- WITHOUT_GSSAPI
- (unless WITH_GSSAPI is set explicitly)
- WITHOUT_KERBEROS_SUPPORT
- Set to build some programs without Kerberos support, like ssh(1), telnet(1), sshd(8), and telnetd(8).
- WITHOUT_KERNEL_SYMBOLS
- Set to not install kernel symbol files.
This option is recommended for those people who have small root partitions.
- 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 enforces these options:- WITHOUT_KVM_SUPPORT
- WITHOUT_KVM_SUPPORT
- Set to build some programs without optional
libkvm
support. - WITHOUT_LDNS
- Setting this variable will prevent the LDNS library from being built. When
set, it enforces these options:
- WITHOUT_LDNS_UTILS
- WITHOUT_UNBOUND
- WITHOUT_LDNS_UTILS
- Setting this variable will prevent building the LDNS utilities drill(1) and host(1).
- WITHOUT_LEGACY_CONSOLE
- Set to not build programs that support a legacy PC console; e.g., kbdcontrol(1) and vidcontrol(1).
- WITHOUT_LIB32
- On 64-bit platforms, set to not build 32-bit library set and a
ld-elf32.so.1
runtime linker. - WITHOUT_LIBCPLUSPLUS
- Set to avoid building libcxxrt and libc++.
- WITHOUT_LIBPTHREAD
- Set to not build the
libpthread
providing library,libthr
. When set, it enforces these options:- WITHOUT_LIBTHR
- WITH_LIBSOFT
- On armv6 only, set to enable soft float ABI compatibility libraries. This option is for transitioning to the new hard float ABI.
- WITHOUT_LIBTHR
- Set to not build the
libthr
(1:1 threading) library. - WITHOUT_LLD
- Set to not build LLVM's lld linker.
This is a default setting on mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_LLD
- Set to build LLVM's lld linker.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm64/aarch64, i386/i386 and pc98/i386.
- WITHOUT_LLDB
- Set to not build the LLDB debugger.
This is a default setting on arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_LLDB
- Set to build the LLDB debugger.
This is a default setting on amd64/amd64 and arm64/aarch64.
- WITHOUT_LLD_BOOTSTRAP
- Set to not build the LLD linker during the bootstrap phase of the build.
To be able to build the system, either Binutils or LLD bootstrap must be
enabled unless an alternate linker is provided via XLD.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_LLD_BOOTSTRAP
- Set to build the LLD linker during the bootstrap phase of the build.
This is a default setting on arm64/aarch64.
- WITHOUT_LLD_IS_LD
- Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_LLD_IS_LD
- Set to use LLVM's LLD as the system linker, instead of GNU binutils ld.
This is a default setting on arm64/aarch64.
- WITHOUT_LLVM_LIBUNWIND
- Set to use GCC's stack unwinder (instead of LLVM's libunwind).
This is a default setting on amd64/amd64, arm/arm, arm/armeb, arm/armv6, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
- WITH_LLVM_LIBUNWIND
- Set to use LLVM's libunwind stack unwinder (instead of GCC's unwinder).
This is a default setting on arm64/aarch64.
- WITHOUT_LOCALES
- Set to not build localization files; see locale(1).
- WITHOUT_LOCATE
- Set to not build locate(1) and related programs.
- WITHOUT_LPR
- Set to not build lpr(1) and related programs.
- WITHOUT_LS_COLORS
- Set to build ls(1) without support for colors to distinguish file types.
- WITHOUT_LZMA_SUPPORT
- Set to build some programs without optional lzma compression support.
- WITHOUT_MAIL
- Set to not build any mail support (MUA or MTA). When set, it enforces
these options:
- WITHOUT_DMAGENT
- WITHOUT_MAILWRAPPER
- WITHOUT_SENDMAIL
- WITHOUT_MAILWRAPPER
- Set to not build the mailwrapper(8) MTA selector.
- WITHOUT_MAKE
- Set to not install make(1) and related support files.
- WITHOUT_MAN
- Set to not build manual pages. When set, these options are also in effect:
- WITHOUT_MAN_UTILS
- (unless WITH_MAN_UTILS is set explicitly)
- WITHOUT_MANCOMPRESS
- Set to not to install compressed man pages. Only the uncompressed versions will be installed.
- WITHOUT_MANDOCDB
- Use the version of makewhatis(1) introduced in FreeBSD 2.1, instead of the makewhatis(8) database and utilities from mandoc(1).
- WITHOUT_MAN_UTILS
- Set to not build utilities for manual pages, apropos(1), catman(1), makewhatis(1), man(1), whatis(1), manctl(8), and related support files.
- WITH_META_MODE
- Create make(1) meta files when building, which can provide a reliable
incremental build when using
filemon(4). The meta file is created in OBJDIR as
target.meta. These meta files track the command
that was executed, its output, and the current directory. The
filemon(4) module is required unless
NO_FILEMON is defined. When the module is loaded,
any files used by the commands executed are tracked as dependencies for
the target in its meta file. The target is considered out-of-date and
rebuilt if any of these conditions are true compared to the last build:
- The command to execute changes.
- The current working directory changes.
- The target's meta file is missing.
- The target's meta file is missing filemon data when filemon is loaded and a previous run did not have it loaded.
- [requires filemon(4)] Files read, executed or linked to are newer than the target.
- [requires filemon(4)] Files read, written, executed or linked are missing.
The build hides commands that are executed unless NO_SILENT is defined. Errors cause make(1) to show some of its environment for further debugging.
The build operates as it normally would otherwise. This option originally invoked a different build system but that was renamed to WITH_DIRDEPS_BUILD.
Currently this also enforces WITHOUT_SYSTEM_COMPILER. When set, these options are also in effect:
- WITHOUT_SYSTEM_COMPILER
- (unless WITH_SYSTEM_COMPILER is set explicitly)
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITH_NAND
- Set to build the NAND Flash components.
- WITHOUT_NDIS
- Set to not build programs and libraries related to NDIS emulation support.
- WITHOUT_NETCAT
- Set to not build nc(1) utility.
- WITHOUT_NETGRAPH
- Set to not build applications to support
netgraph(4). When set, it enforces these options:
- WITHOUT_ATM
- WITHOUT_BLUETOOTH
- WITHOUT_NETGRAPH_SUPPORT
- WITHOUT_NETGRAPH_SUPPORT
- Set to build libraries, programs, and kernel modules without netgraph support.
- 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_NTP
- Set to not build ntpd(8) and related programs.
- WITH_OFED
- Set to build the “OpenFabrics Enterprise Distribution” Infiniband software stack.
- WITH_OPENLDAP
- Enable building openldap support for kerberos.
- WITHOUT_OPENSSH
- Set to not build OpenSSH.
- WITHOUT_OPENSSL
- Set to not build OpenSSL. When set, it enforces these options:
- WITHOUT_KERBEROS
- WITHOUT_KERBEROS_SUPPORT
- WITHOUT_OPENSSH
When set, these options are also in effect:
- WITHOUT_GSSAPI
- (unless WITH_GSSAPI is set explicitly)
- WITHOUT_PAM
- Set to not build PAM library and modules.
This option is deprecated and does nothing.When set, it enforces these options:
- WITHOUT_PAM_SUPPORT
- WITHOUT_PAM_SUPPORT
- Set to build some programs without PAM support, particularly ftpd(8) and ppp(8).
- WITHOUT_PC_SYSINSTALL
- Set to not build pc-sysinstall(8) and related programs.
- WITHOUT_PF
- Set to not build PF firewall package. When set, it enforces these options:
- WITHOUT_AUTHPF
- WITHOUT_PKGBOOTSTRAP
- Set to not build pkg(7) bootstrap tool.
- WITHOUT_PMC
- Set to not build pmccontrol(8) and related programs.
- WITHOUT_PORTSNAP
- Set to not build or install portsnap(8) and related files.
- WITHOUT_PPP
- Set to not build ppp(8) and related programs.
- WITHOUT_PROFILE
- Set to avoid compiling profiled libraries.
- WITHOUT_QUOTAS
- Set to not build quota(1) and related programs.
- WITHOUT_RADIUS_SUPPORT
- Set to not build radius support into various applications, like pam_radius(8) and ppp(8).
- WITHOUT_RBOOTD
- Set to not build or install rbootd(8).
- WITHOUT_RCMDS
- Disable building of the BSD r-commands. This includes rlogin(1), rsh(1), etc.
- WITHOUT_RCS
- Set to not build rcs(1), etcupdate(8), and related utilities.
- WITH_REPRODUCIBLE_BUILD
- Set to exclude build metadata (such as the build time, user, or host) from the kernel, boot loaders, and uname output, so that builds produce bit-for-bit identical output.
- WITHOUT_RESCUE
- Set to not build rescue(8).
- WITHOUT_ROUTED
- Set to not build routed(8) utility.
- WITH_RPCBIND_WARMSTART_SUPPORT
- Set to build rpcbind(8) with warmstart support.
- 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.
- WITH_SHARED_TOOLCHAIN
- Set to build the toolchain binaries shared. The set includes cc(1), make(1) and necessary utilities like assembler, linker and library archive manager.
- WITH_SORT_THREADS
- Set to enable threads in sort(1).
- WITHOUT_SOURCELESS
- Set to not build kernel modules that include sourceless code (either
microcode or native code for host CPU). When set, it enforces these
options:
- WITHOUT_SOURCELESS_HOST
- WITHOUT_SOURCELESS_UCODE
- WITHOUT_SOURCELESS_HOST
- Set to not build kernel modules that include sourceless native code for host CPU.
- WITHOUT_SOURCELESS_UCODE
- Set to not build kernel modules that include sourceless microcode.
- WITHOUT_SSP
- Set to not build world with propolice stack smashing protection.
- WITH_STAGING
- Enable staging of files to a stage tree. This can be best thought of as
auto-install to DESTDIR with some extra meta data to
ensure dependencies can be tracked. Depends on
WITH_DIRDEPS_BUILD. When set, these options are also
in effect:
- WITH_STAGING_MAN
- (unless WITHOUT_STAGING_MAN is set explicitly)
- WITH_STAGING_PROG
- (unless WITHOUT_STAGING_PROG is set explicitly)
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITH_STAGING_MAN
- Enable staging of man pages to stage tree.
- WITH_STAGING_PROG
- Enable staging of PROGs to stage tree.
- WITH_STALE_STAGED
- Check staged files are not stale.
- WITH_SVN
- Set to install svnlite(1) as svn(1).
- WITHOUT_SVNLITE
- Set to not build svnlite(1) and related programs.
- 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.
- WITH_SYSROOT
- Enable use of sysroot during build. Depends on
WITH_DIRDEPS_BUILD.
This must be set in the environment, make command line, or /etc/src-env.conf, not /etc/src.conf.
- WITHOUT_SYSTEM_COMPILER
- Set to not opportunistically skip building a cross-compiler during the bootstrap phase of the build. Normally, if the currently installed compiler matches the planned bootstrap compiler type and revision, then it will not be built. This does not prevent a compiler from being built for installation though, only for building one for the build itself. The WITHOUT_CLANG and WITHOUT_GCC options control those.
- WITHOUT_TALK
- Set to not build or install talk(1) and talkd(8).
- WITHOUT_TCP_WRAPPERS
- Set to not build or install tcpd(8), and related utilities.
- WITHOUT_TCSH
- Set to not build and install /bin/csh (which is tcsh(1)).
- WITHOUT_TELNET
- Set to not build telnet(1) and related programs.
- WITHOUT_TESTS
- Set to not build nor install the FreeBSD Test
Suite in /usr/tests/. See
tests(7) for more details. This also disables the build of all
test-related dependencies, including ATF. When set, it enforces these
options:
- WITHOUT_DTRACE_TESTS
- WITHOUT_TESTS_SUPPORT
- WITHOUT_TESTS_SUPPORT
- Set to disables the build of all test-related dependencies, including ATF.
- WITHOUT_TEXTPROC
- Set to not build programs used for text processing. When set, it enforces
these options:
- WITHOUT_GROFF
- WITHOUT_TFTP
- Set to not build or install tftp(1) and tftpd(8).
- WITHOUT_TIMED
- Set to not build or install timed(8).
- WITHOUT_TOOLCHAIN
- Set to not install header or programs used for program development,
compilers, debuggers etc. When set, it enforces these options:
- WITHOUT_BINUTILS
- WITHOUT_CLANG
- WITHOUT_CLANG_EXTRAS
- WITHOUT_CLANG_FULL
- WITHOUT_GCC
- WITHOUT_GDB
- WITHOUT_INCLUDES
- WITHOUT_LLD
- WITHOUT_LLDB
- WITHOUT_UNBOUND
- Set to not build unbound(8) and related programs.
- WITHOUT_USB
- Set to not build USB-related programs and libraries.
- WITHOUT_USB_GADGET_EXAMPLES
- Set to not build USB gadget kernel modules.
- WITHOUT_UTMPX
- Set to not build user accounting tools such as last(1), users(1), who(1), ac(8), lastlogin(8) and utx(8).
- WITHOUT_VI
- Set to not build and install vi, view, ex and related programs.
- WITHOUT_VT
- Set to not build vt(4) support files (fonts and keymaps).
- WITHOUT_WARNS
- Set this to not add warning flags to the compiler invocations. Useful as a temporary workaround when code enters the tree which triggers warnings in environments that differ from the original developer.
- WITHOUT_WIRELESS
- Set to not build programs used for 802.11 wireless networks; especially
wpa_supplicant(8) and
hostapd(8). When set, it enforces these options:
- WITHOUT_WIRELESS_SUPPORT
- WITHOUT_WIRELESS_SUPPORT
- Set to build libraries, programs, and kernel modules without 802.11 wireless support.
- WITHOUT_WPA_SUPPLICANT_EAPOL
- Build 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).
- WITHOUT_ZFS
- Set to not build ZFS file system.
- WITHOUT_ZONEINFO
- Set to not build the timezone database.
FILES
- /etc/src.conf
- /etc/src-env.conf
- /usr/share/mk/bsd.own.mk
SEE ALSO
HISTORY
The src.conf
file appeared in
FreeBSD 7.0.
AUTHORS
This manual page was autogenerated by tools/build/options/makeman.