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

FreeBSD Manual Pages


home | help
MAKE.CONF(5)		  FreeBSD File Formats Manual		  MAKE.CONF(5)

     make.conf -- system build information

     The file make.conf	contains system-wide settings that will	apply to every
     build using make(1) and the standard file.	This is	achieved as
     follows: make(1) processes	the system makefile before any other
     file by default, and includes make.conf.

     The file make.conf	uses the standard makefile syntax.  However, make.conf
     should not	specify	any dependencies to make(1).  Instead, make.conf is to
     set make(1) variables that	control	the actions of other makefiles.

     The default location of make.conf is /etc/make.conf, though an alterna-
     tive location can be specified in the make(1) variable __MAKE_CONF.  You
     may need to override the location of make.conf if the system-wide set-
     tings are not suitable for	a particular build.  For instance, setting
     __MAKE_CONF to /dev/null effectively resets all build controls to their

     The primary purpose of make.conf is to control the	compilation of the
     FreeBSD sources, documentation, and ported	applications, which are	usu-
     ally found	in /usr/src, /usr/doc, and /usr/ports.	As a rule, the system
     administrator creates make.conf when the values of	certain	control	vari-
     ables need	to be changed from their defaults.

     The system	build procedures occur in four broad areas: the	world, the
     kernel, documentation and ports.  Variables set in	make.conf may be ap-
     plicable in one, two, or all four of these	areas.	In addition, control
     variables can be specified	for a particular build via the -D option of
     make(1) or	in environ(7).	In the case of world and kernel	builds it is
     possible to put these variables into src.conf(5) instead of make.conf.
     This way the environment for documentation	and ports builds is not	pol-
     luted by unrelated	variables.

     The following lists provide a name	and short description for each vari-
     able you can use during the indicated builds.  The	values of variables
     flagged as	bool are ignored; the variable being set at all	(even to
     "FALSE" or	"NO") causes it	to be treated as if it were set.

     The following list	provides a name	and short description for variables
     that are used for all builds, or are used by the makefiles	for things
     other than	builds.

		   (bool) Instructs the	top-level makefile in the source tree
		   (normally /usr/src) to always check if make(1) is up-to-
		   date.  Normally this	is only	done for the world and build-
		   world targets to handle upgrades from older versions	of

     CFLAGS	   (str) Controls the compiler setting when compiling C	code.
		   Optimization	levels other than -O and -O2 are not sup-

     CPUTYPE	   (str) Controls which	processor should be targeted for gen-
		   erated code.	 This controls processor-specific optimiza-
		   tions in certain code (currently only OpenSSL) as well as
		   modifying the value of CFLAGS and COPTFLAGS to contain the
		   appropriate optimization directive to cc(1).	 The automatic
		   setting of CFLAGS may be overridden using the NO_CPU_CFLAGS
		   variable.  Refer to /usr/share/examples/etc/make.conf for a
		   list	of recognized CPUTYPE options.

     CXXFLAGS	   (str) Controls the compiler settings	when compiling C++
		   code.  CXXFLAGS is initially	set to the value of CFLAGS.
		   If you want to add to the CXXFLAGS value, use "+=" instead
		   of "=".

     DTC	   (str) Select	the compiler for DTS (Device Tree Syntax)
		   file.  DTC is initially set to the value of dtc

     INSTALL	   (str) the default install command.  To install only files
		   for which the target	differs	or does	not exist, use

			 INSTALL+= -C
		   Note	that some makefiles (including those in	/usr/share/mk)
		   may hardcode	options	for the	supplied install command.

     LOCAL_DIRS	   (str) List any directories that should be entered when do-
		   ing make's in /usr/src in this variable.

     MAKE_SHELL	   (str) Controls the shell used internally by make(1) to
		   process the command scripts in makefiles.  sh(1), ksh(1),
		   and csh(1) all currently supported.


		   (str) Set this to "-L" to cause mtree(8) to follow sym-

		   (str) Setting this variable will prevent CPU	specific com-
		   piler flags from being automatically	added to CFLAGS	during
		   compile time.

     NO_DOCUPDATE  (bool) Set this to not update the doc tree during "make

		   (bool) Set this to not update the ports tree	during "make

     SVN_UPDATE	   (bool) Set this to use svn(1) or svnlite(1) to update your
		   src tree with "make update".	 Note that you can set SVN to
		   the full path of a svn(1) binary.

     The following list	provides a name	and short description for variables
     that are only used	doing a	kernel build:

     BOOTWAIT	   (int) Controls the amount of	time the kernel	waits for a
		   console keypress before booting the default kernel.	The
		   value is approximately milliseconds.	 Keypresses are	ac-
		   cepted by the BIOS before booting from disk,	making it pos-
		   sible to give custom	boot parameters	even when this is set
		   to 0.

     COPTFLAGS	   (str) Controls the compiler settings	when building the ker-
		   nel.	 Optimization levels above [-O (-O2, ...)] are not
		   guaranteed to work.

     KERNCONF	   (str) Controls which	kernel configurations will be built by
		   "${MAKE} buildkernel" and installed by "${MAKE}
		   installkernel".  For	example,


		   will	build the kernels specified by the config files	MINE,
		   DEBUG, GENERIC, and OTHERMACHINE, and install the kernel
		   specified by	the config file	MINE.  It defaults to GENERIC.

		   (str) Set to	a list of modules to build instead of all of

		   (bool) Set this to skip running "${MAKE} clean" during
		   "${MAKE} buildkernel".

		   (bool) Set this to skip running config(8) during "${MAKE}

     NO_KERNELOBJ  (bool) Set this to skip running "${MAKE} obj" during
		   "${MAKE} buildkernel".

     NO_MODULES	   (bool) Set to not build modules with	the kernel.

		   Set this to the list	of ports you wish to rebuild every
		   time	the kernel is built.

		   (str) Set to	a list of modules to exclude from the build.
		   This	provides a somewhat easier way to exclude modules you
		   are certain you will	never need than	specifying
		   MODULES_OVERRIDE.  This is applied after MODULES_OVERRIDE.

     The following list	provides a name	and short description for variables
     that are used during the world build:

		   (str) The port address to use for the console if the	boot
		   blocks have been configured to use a	serial console instead
		   of the keyboard/video card.

		   (int) The baud rate to use for the console if the boot
		   blocks have been configured to use a	serial console instead
		   of the keyboard/video card.

		   (bool) Compile in the code into pxeboot(8) that forces the
		   use of a serial console.  This is analogous to the -h op-
		   tion	in boot(8) blocks.

		   (bool) Compile in the code into pxeboot(8) that probes the
		   keyboard.  If no keyboard is	found, boot with the dual con-
		   sole	configuration.	This is	analogous to the -D option in
		   boot(8) blocks.

		   (bool) Set this if you wish to use the ksu utility.	Other-
		   wise, it will be installed without the set-user-ID bit set.

		   (bool) Set this to install newgrp(1)	with the set-user-ID
		   bit set.  Otherwise,	newgrp(1) will not be able to change
		   users' groups.

		   (bool) By default the pxeboot(8) loader retrieves the ker-
		   nel via NFS.	 Defining this and recompiling /usr/src/stand
		   will	cause it to retrieve the kernel	via TFTP.  This	allows
		   pxeboot(8) to load a	custom BOOTP diskless kernel yet still
		   mount the server's /	rather than load the server's kernel.

		   (bool) Defining this	and recompiling	/usr/src/stand/i386
		   will	add dcons(4) console driver to loader(8) and allow ac-
		   cess	over FireWire(IEEE1394)	using dconschat(8).  Cur-
		   rently, only	i386 and amd64 are supported.

     MAN_ARCH	   (str) Space-delimited list of one or	more MACHINE and/or
		   MACHINE_ARCH	values for which section 4 man pages will be
		   installed.  The special value `all' installs	all available
		   architectures.  The default is the MACHINE and MACHINE_ARCH
		   being built.

		   (bool) Set to build modules with the	system instead of the

     NO_CLEAN	   (bool) Set this to disable cleaning during "make
		   buildworld".	 This should not be set	unless you know	what
		   you are doing.

     NO_CLEANDIR   (bool) Set this to run "${MAKE} clean" instead of "${MAKE}

		   (defined) Set to install manual pages compressed.

		   (defined) Set to install manual pages uncompressed.

     NO_SHARE	   (bool) Set to not build in the share	subdir.

     NO_SHARED	   (bool) Set to build /bin and	/sbin statically linked, this
		   can be bad.	If set,	every utility that uses
		   will	be linked statically.

		   (str) Path to rsa private key passed	to pkg-repo(8) to sign
		   packages created when building the packages target, i.e.:
		   pkgbase.  The variable is named the same in poudriere(8) so
		   it will automatically be picked up when building pkgbase
		   with	poudriere.

     PPP_NO_NAT	   (bool) Build	ppp(8) without support for network address
		   translation (NAT).

		   (bool) Set to build ppp(8) without support for Netgraph.

		   (bool) Set to build ppp(8) without support for RADIUS.

     PPP_NO_SUID   (bool) Set to disable the installation of ppp(8) as a set-
		   user-ID root	program.

		   (str) Additional .mc	files which should be built into .cf
		   files at build time.	 The value should include the full
		   path	to the .mc file(s), e.g., /etc/mail/,

		   (str) List of aliases(5) files to rebuild when using
		   /etc/mail/Makefile.	The default value is

		   (str) Flags to pass to the compile command when building
		   sendmail(8).	 The SENDMAIL_*	flags can be used to provide
		   SASL	support	with setting such as:

			 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL

		   (str) Override the default location for the m4(1) configu-
		   ration files	used to	build a	.cf file from a	.mc file.

		   (str) Extra dependencies to add when	building sendmail(8).

		   (str) Flags to add to the end of the	ld(1) command when
		   building sendmail(8).

		   (str) Flags to pass to the ld(1) command when building

		   (str) Flags passed to m4(1) when building a .cf file	from a
		   .mc file.

		   (str) Mode to use when generating alias and map database
		   files using /etc/mail/Makefile.  The	default	value is 0640.

		   (str) Additional maps to rebuild when using
		   /etc/mail/Makefile.	The access, bitdomain, domaintable,
		   genericstable, mailertable, uucpdomain, and virtusertable
		   maps	are always rebuilt if they exist.

		   (str) Database map type to use when generating map database
		   files using /etc/mail/Makefile.  The	default	value is hash.
		   The alternative is btree.

     SENDMAIL_MC   (str) The default m4(1) configuration file to use at	in-
		   stall time.	The value should include the full path to the
		   .mc file, e.g., /etc/mail/  Use with caution as
		   a make install will overwrite any existing
		   /etc/mail/  Note	that SENDMAIL_CF is depre-

		   (bool) If set, install sendmail(8) as a set-user-ID root
		   binary instead of a set-group-ID binary and do not install
		   /etc/mail/submit.{cf,mc}.  Use of this flag is not recom-
		   mended and the alternative advice in	/etc/mail/README
		   should be followed instead if at all	possible.

		   (str) The script used by /etc/mail/Makefile to start, stop,
		   and restart sendmail(8).  The default value is
		   /etc/rc.sendmail.  This value should	match the
		   "mta_start_script" setting in rc.conf(5).

		   (str) The default m4(1) configuration file for mail submis-
		   sion	to use at install time.	 The value should include the
		   full	path to	the .mc	file, e.g., /etc/mail/
		   Use with caution as a make install will overwrite any ex-
		   isting /etc/mail/

		   (int) top(1)	uses a hash table for the user names.  The
		   size	of this	hash can be tuned to match the number of local
		   users.  The table size should be a prime number approxi-
		   mately twice	as large as the	number of lines	in
		   /etc/passwd.	 The default number is 20011.

		   (int) Causes	the system compiler to be built	such that it
		   forces high optimization levels to a	lower one.  cc(1) -O2
		   and above is	known to trigger known optimizer bugs at vari-
		   ous times.  The value assigned is the highest optimization
		   value used.

     The following list	provides a name	and short description for variables
     that are used when	building documentation.

     DISTDIR	    (str) Where	distfiles are kept.  Normally, this is
		    distfiles in PORTSDIR.

     DOC_LANG	    (str) The list of languages	and encodings to build and in-

     PRINTERDEVICE  (str) The default format for system	documentation, depends
		    on your printer.  This can be set to "ascii" for simple
		    printers, or "ps" for postscript or	graphics printers with
		    a ghostscript filter, or both.

     Several make variables can	be set that affect the building	of ports.
     These variables and their effects are documented in ports(7),
     ${PORTSDIR}/Mk/* and the FreeBSD Porter's Handbook.


     cc(1), install(1),	make(1), src.conf(5), style.Makefile(5), environ(7),
     ports(7), sendmail(8)

     The make.conf file	appeared sometime before FreeBSD 4.0.

     This manual page was written by Mike W. Meyer <>.

     Note, that	MAKEOBJDIRPREFIX and MAKEOBJDIR	are environment	variables and
     should not	be set in make.conf or as command line arguments to make(1),
     but in make's environment.

     This manual page may occasionally be out of date with respect to the op-
     tions currently available for use in make.conf.  Please check the
     /usr/share/examples/etc/make.conf file for	the latest options which are

FreeBSD	13.0		       December	20, 2020		  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help