BUILDFLAGS.MK(1) BSD General Commands Manual BUILDFLAGS.MK(1)NAMEbuildflags.mk — import buildflags.conf(1)SYNOPSISbuildflags.mkDESCRIPTION
The primary function of the buildflags.mk script is to use the
buildflags.conf(1) file, but it also offers knobs to easily use tools
such as distcc and ccache.
The intended way to use it is to add the following lines to make.conf(5).
BUILDFLAGS= %%DATADIR%%/buildflags.mk
.if exists(${BUILDFLAGS})
.include "${BUILDFLAGS}"
.endif
OPTIONS
The following options to control the internals of buildflags.mk are
available:
BUILDFLAGS_CCACHE
The ccache binary.
Default: %%PREFIX%%/bin/ccache
BUILDFLAGS_CONF
The configuration file.
Default: %%PREFIX%%/etc/buildflags.conf
BUILDFLAGS_DISTCC
The distcc binary.
Default: %%PREFIX%%/bin/distcc
BUILDFLAGS_GCC
The version string to append to a gcc binary. A sensible value
would be something like '43'.
Default: undefined
BUILDFLAGS_GCC_CC
The CC binary without a version string.
Default: %%PREFIX%%/bin/gcc
BUILDFLAGS_GCC_CPP
The CPP binary without a version string.
Default: %%PREFIX%%/bin/cpp
BUILDFLAGS_GCC_CXX
The CXX binary without a version string.
Default: %%PREFIX%%/bin/c++
BUILDFLAGS_PARSER
The program that parses the configuration file.
Default: %%DATADIR%%/buildflags.awk
BUILDFLAGS_TMP
A temporary file required to include the parsed configuration.
Default: %%TMP%%/buildflags.tmp.mk.${USER}
The following additional knobs are offered to manipulate make jobs:
SUBTHREADS
WARNING: This setting is deprecated in favour of the ports native
settings FORCE_MAKE_JOBS and MAKE_JOBS_NUMBER.
This knob does for ports what THREADS does everywhere else. It
does not have an effect if the target install is specified. Thus
it is recommended to run 'make build' and 'make install' seper‐
ately.
THREADS
This knob causes make to create parallel jobs. A sensible value
is twice the number of CPU cores available. This increases the
amount of memory used. If the system starts to swap often, the
number should be decreased to the number of available CPU cores.
Do not use THREADS with the ports system.
USE_DISTCC
Prepends the distcc binary to CC, CXX and CPP.
USE_CCACHE
Prepends the ccache binary to CC, CXX and CPP.
WITH_GCC
Triggers the use of the alternative gcc defined with BUILD‐
FLAGS_GCC. If BUILDFLAGS_GCC has not been definied it will be
set to whatever WITH_GCC was set.
COMPATIBILITY
The script has been tested on FreeBSD 7.2-PRERELEASE
SEE ALSObuildflags.awk(1), buildflags.conf(1), bsdadminscripts(1)HISTORY
The buildflags.mk script first appeared in the bsdadminscripts-2.0 col‐
lection.
AUTHOR
Dominic Fandrey <kamikaze@bsdforen.de>
BSD April 21, 2009 BSD
