DragonFly On-Line Manual Pages

COMPILERS.CONF(5)	 DragonFly File Formats Manual	     COMPILERS.CONF(5)

NAME
     compilers.conf -- configuration file for external compilers

SYNOPSIS
     /etc/compilers.conf

DESCRIPTION
     The compilers.conf file allows to configure ``external'' compilers for
     usage with the DragonFly build(7) system.

     The /etc/defaults/compilers.conf file specifies the default settings for
     all variables, the /etc/compilers.conf file specifies override settings.

     The following variables are available:

     <version>_CC	 The pathname of the cc program of the compiler.

     <version>_CFLAGS	 Any additional flags to pass to <version>_CC.

     <version>_CPP	 The pathname of the cpp program of the compiler.

     <version>_CPPFLAGS  Any additional flags to pass to <version>_CPP.

     <version>_CXX	 The pathname of the c++ program of the compiler.

     <version>_CXXFLAGS  Any additional flags to pass to <version>_CXX.

     Currently, defaults are provided for clang (installed from pkgsrc(7)'s
     lang/clang), clangsvn (installed from SVN trunk as described in
     http://clang.llvm.org/get_started.html), gcc46 (installed from
     pkgsrc(7)'s lang/gnat-aux), and pcc (installed from pkgsrc(7)'s
     lang/pcc-current).

IMPLEMENTATION NOTES
     In DragonFly, compilers are selected by setting the CCVER variable.  The
     cpp, cc, etc. programs in /usr/bin are actually links to the objformat(1)
     deflector program which is responsible for executing the correct programs
     (located in /usr/libexec/$CCVER).

     Traditionally, DragonFly has 2 compilers in base, one of which is the
     default compiler and the other is either a newer or older version.  In
     order to allow additional non-base compilers into DragonFly's build
     process, objformat(1) deflects to /usr/libexec/custom when CCVER's set-
     ting is not one of the compilers in base.	This directory contains a cc
     wrapper script (and some links to it).  The wrapper script then takes
     care of making the compiler look and behave like a compiler in base.

     The settings in compilers.conf specify paths and flags for the
     /usr/libexec/custom/cc script.

FILES
     /etc/compilers.conf  external compiler configuration file

EXAMPLES
     Once configured the compiler can be used like this:

	   env CCVER=clang make

     To try building world and kernel, use:

	   cd /usr/src
	   env WORLD_CCVER=<version> make -DNO_GCC47 buildworld
	   env WORLD_CCVER=<version> make buildkernel KERNCONF=MYCONF

SEE ALSO
     objformat(1), build(7)

HISTORY
     The compilers.conf file first appeared in DragonFly 2.3.

DragonFly 3.5		       October 14, 2012 		 DragonFly 3.5