Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
BUILDFLAGS.MK(1)	     General Commands Manual		BUILDFLAGS.MK(1)

NAME
     buildflags.mk -- import buildflags.conf(5)

SYNOPSIS
     buildflags.mk

DESCRIPTION
     The  primary  function  of  the  buildflags.mk  script is to use the build-
     flags.conf(5) 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).

	   .sinclude "/usr/local/share/bsdadminscripts2/buildflags.mk"

   Options
     The  following options to control the internals of buildflags.mk are avail-
     able:

     BUILDFLAGS_CCACHE
	     The ccache binary.

	     Default: /usr/local/bin/ccache

     BUILDFLAGS_CONF
	     The configuration file.

	     Default: /usr/local/etc/buildflags.conf

     BUILDFLAGS_DISTCC
	     The distcc binary.

	     Default: /usr/local/bin/distcc

     BUILDFLAGS_PARSER
	     The program that parses the configuration file.

	     Default: /usr/local/share/bsdadminscripts2/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.

SEE ALSO
     buildflags.awk(1), buildflags.conf(5)

HISTORY
     The  buildflags.mk script first appeared in the bsdadminscripts-2.0 collec-
     tion.

AUTHORS
     Dominic Fandrey <freebsd@k4m1.org>

FreeBSD ports 15.quarterly	18 November, 2023		BUILDFLAGS.MK(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=buildflags.mk&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help