DragonFly On-Line Manual Pages

Search: Section:  


BUILDFLAGS.MK(1)       DragonFly General Commands Manual      BUILDFLAGS.MK(1)

NAME

buildflags.mk - import buildflags.conf(1)

SYNOPSIS

buildflags.mk

DESCRIPTION

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' seperately. 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 BUILDFLAGS_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 ALSO

buildflags.awk(1), buildflags.conf(1), bsdadminscripts(1)

HISTORY

The buildflags.mk script first appeared in the bsdadminscripts-2.0 collection.

AUTHOR

Dominic Fandrey <kamikaze@bsdforen.de> DragonFly 6.5-DEVELOPMENT April 21, 2009 DragonFly 6.5-DEVELOPMENT

Search: Section: