DragonFly On-Line Manual Pages

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