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

FreeBSD Manual Pages

  
 
  

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

NAME
     make.conf -- system build information

DESCRIPTION
     The file make.conf	contains settings that control the compilation of the
     FreeBSD sources and ported	applications.  The file	make.conf is generally
     created by	the system administrator when the values need to be changed
     from their	defaults.

     The purpose of make.conf is not to	run commands or	perform	compilation
     actions directly.	Instead, it is included	by the various makefiles in
     /usr/src, /usr/ports and /usr/doc which conditionalize their internal ac-
     tions according to	the settings found there.

     The /etc/make.conf	file is	included from the appropriate Makefile which
     specifies the default settings for	all the	available options.  Options
     need only be specified in /etc/make.conf when the system administrator
     wishes to override	these defaults.

     The build procedures occur	in four	broad areas: the world,	the kernel,
     documentations and	ports.	Variables set in make.conf may be applicable
     during builds in one, two,	or all four of these areas.  They may be spec-
     ified for a particular build via the -D option of make(1).

     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.

     CFLAGS	   (str) Controls the compiler setting when compiling C	code.
		   Optimization	levels above -O	(-O2, ...) are not supported.
		   BDECFLAGS is	provided as a set of gcc(1) settings suggested
		   by Bruce Evans <bde@FreeBSD.org> for	developing and testing
		   changes.  They can be used, if set, by:

			 CFLAGS+=${BDECFLAGS}

     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 gcc(1).  The auto-
		   matic setting of CFLAGS and COPTFLAGS may be	overridden us-
		   ing the NO_CPU_CFLAGS and NO_CPU_COPTFLAGS variables, re-
		   spectively.	Refer to /usr/share/examples/etc/make.conf for
		   a list of recognized	CPUTYPE	options.

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

     NO_CPU_COPTFLAGS
		   (str) Setting this variable will prevent cpu	specific com-
		   piler flags from being automatically	added to COPTFLAGS du-
		   ing compile time.

     CVS_UPDATE	   (bool) Set this to use cvs(1) to update your	ports with
		   "make update".

     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 "=".

     INSTALL	   (str) the default install command.  To have commands	com-
		   pared before	doing the install, use

			 INSTALL="install -C"

     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.

			 MAKE_SHELL?=sh

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

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

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

     SUP_UPDATE	   (bool) Set this to use cvsup(1) to update your ports	with
		   "make update".

     SUP	   (str) The location of the cvsup(1) command for "make
		   update".

     SUPFLAGS	   (str) The flag for the sup(1) command when doing "make
		   update".  This defaults to [-g -L 2].

     SUPHOST	   (str) The hostname of the sup server	to use when doing
		   "make update".

     SUPFILE	   (str) The first supfile to use when doing a "make update".
		   This	defaults to
		   /usr/share/examples/cvsup/standard-supfile.

     SUPFILE1	   (str) The second supfile to use when	doing a	"make update".
		   This	defaults to /usr/share/examples/cvsup/secure-supfile.

     SUPFILE2	   (str) The third supfile to use when doing a "make update".
		   This	defaults to /usr/share/examples/cvsup/secure-supfile.

     PORTSSUPFILE  (str) The ports supfile to use when doing a "make update".
		   This	defaults to /usr/share/examples/cvsup/ports-supfile.

     DOCSUPFILE	   (str) The documentation supfile to use when doing a "make
		   update".  This defaults to
		   /usr/share/examples/cvsup/doc-supfile.

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

     BOOT_COMCONSOLE_PORT
		   (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.

     BOOT_COMCONSOLE_SPEED
		   (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.

     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,

			 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE

		   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.

     LOADER_TFTP_SUPPORT
		   (bool) While	not a buildkernel-affected option, there is no
		   better place	for this.  By default the pxeboot(8) loader
		   retrieves the kernel	via NFS.  Defining this	and recompil-
		   ing /usr/src/sys/boot 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.

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

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

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

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

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

     COMPAT1X	   (bool) Set to install the FreeBSD 1 compatibility li-
		   braries.

     COMPAT20	   (bool) Set to install the FreeBSD 2.0 compatibility li-
		   braries.

     COMPAT21	   (bool) Set to install the FreeBSD 2.1 compatibility li-
		   braries.

     COMPAT22	   (bool) Set to install the FreeBSD 2.2 compatibility li-
		   braries.

     COMPAT3X	   (bool) Set to install the FreeBSD 3 compatibility li-
		   braries.

     COMPAT4X	   (bool) Set to install the FreeBSD 4 compatibility li-
		   braries.

     FETCH_CMD	   (str) Command to use	to fetch files.	 Normally fetch(1).

     KRB5_HOME	   (str) If you	want to	install	the MIT	Kerberos5 port some-
		   where other than /usr/local,	define this.  This is also
		   used	to tell	ssh1 that Kerberos is needed.

     MAKE_IDEA	   (bool) Set to build the IDEA	encryption code.  This code is
		   patented in the USA and many	European countries.  It	is
		   YOUR	RESPONSIBILITY to determine if you can legally use
		   IDEA.

     MAKE_KERBEROS4
		   (bool) Set this to build KerberosIV (KTH eBones).

     MAKE_KERBEROS5
		   (bool) Set this to build Kerberos5 (KTH Heimdal).  WARNING!
		   This	is still experimental code.  If	you need stable	Ker-
		   beros5, use the port(s).

     ENABLE_SUID_K5SU
		   (bool) Set this if you wish to use the k5su utility.	 Oth-
		   erwise, it will be installed	without	the set-user-ID	bit
		   set.

     ENABLE_SUID_NEWGRP
		   (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.

     ENABLE_SUID_SSH
		   (bool) Set this to install ssh(1) with the set-user-ID bit
		   turned on.

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

     NO_CVS	   (bool) Set to not build CVS.

     NO_CXX	   (bool) Set to not build g++(1) and related libraries.

     NO_BIND	   (bool) Set to not build BIND.

     NO_FORTRAN	   (bool) Set to not build g77(1) and related libraries.

     NO_GDB	   (bool) Set to not build gdb(1).

     NO_I4B	   (bool) Set to not build isdn4bsd package.

     NO_IPFILTER   (bool) Set to not build IP Filter package.

     NO_LPR	   (bool) Set to not build lpr(1) and related programs.

     NO_MAILWRAPPER
		   (bool) Set to not build the mailwrapper(8) MTA selector.

     MAKEDEV_INSTALL
		   (bool) Set to install MAKEDEV in /dev.  This	is needed for
		   the MAKEDEV_RUN variable to have an effect.

     MAKEDEV_RUN   (bool) Set to run "MAKEDEV all" on /dev during install.

     NO_OBJC	   (bool) Set to not build Objective C support.

     NO_OPENSSH	   (bool) Set to not build OpenSSH.

     NO_OPENSSL	   (bool) Set to not build OpenSSL (implies NO_OPENSSH).

     NO_SENDMAIL   (bool) Set to not build sendmail(8) and related programs.

     NO_SHAREDOCS  (bool) Set to not build the 4.4BSD legacy docs.

     NO_TCSH	   (bool) Set to not build and install /bin/csh	(which is
		   tcsh(1)).

     NO_X	   (bool) Set to not compile in	X-Windows support (e.g.
		   doscmd(1)).

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

     NOCLEANDIR	   (bool) Set this to run "${MAKE} clean" instead of "${MAKE}
		   cleandir".

     NOCRYPT	   (bool) Set to not build any crypto code.

     NOGAMES	   (bool) Set to not build games.

     NOINFO	   (bool) Set to not make or install info(5) files.

     NOLIBC_R	   (bool) Set to not build libc_r (reentrant version of	libc).

     NOMANCOMPRESS
		   (bool) Set to install man pages uncompressed.

     NOPROFILE	   (bool) Set to avoid compiling profiled libraries.

     NOSECURE	   (bool) set to not build crypto code in secure subdir.

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

     PPP_NOSUID	   (bool) Set to disable the installation of ppp(8) as an suid
		   root	program.

     SENDMAIL_MC   (str) The default m4	configuration file to use at install
		   time.  The value should include the full path to the	.mc
		   file, e.g., /etc/mail/myconfig.mc.  Use with	caution	as a
		   make	install	will overwrite any existing
		   /etc/mail/sendmail.cf.  Note	that SENDMAIL_CF is now	depre-
		   cated.  Avoid using a value of /etc/mail/sendmail.mc, as a
		   buildworld will create /etc/mail/sendmail.cf	before in-
		   stallworld installs an updated sendmail(8) binary.

     SENDMAIL_SUBMIT_MC
		   (str) The default m4	configuration file for mail submission
		   to use at install time.  The	value should include the full
		   path	to the .mc file, e.g., /etc/mail/mysubmit.mc.  Use
		   with	caution	as a make install will overwrite any existing
		   /etc/mail/submit.cf.	 Avoid using a value of
		   /etc/mail/submit.mc,	as a buildworld	will create
		   /etc/mail/submit.cf before installworld installs an updated
		   sendmail(8) binary.

     SENDMAIL_ADDITIONAL_MC
		   (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/foo.mc
		   /etc/mail/bar.mc.  Avoid using a value of
		   /etc/mail/sendmail.mc, as a buildworld will create
		   /etc/mail/sendmail.cf before	installworld installs an up-
		   dated sendmail(8) binary.

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

     SENDMAIL_CFLAGS
		   (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
			 SENDMAIL_LDFLAGS=-L/usr/local/lib
			 SENDMAIL_LDADD=-lsasl

     SENDMAIL_LDFLAGS
		   (str) Flags to pass to the ld(1) command when building
		   sendmail(8).

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

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

     SENDMAIL_SET_USER_ID
		   (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.

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

     TOP_TABLE_SIZE
		   (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.

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

     WANT_OPENSSL_MANPAGES
		   (bool) Set this to build the	OpenSSL	manual pages.  These
		   are not built by default because they clobber a number of
		   system manual pages with manual pages describing parts of
		   the OpenSSL toolkit,	including passwd(1), err(3), md5(3),
		   and others.

     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-
		   stall.

     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.

FILES
     /etc/make.conf
     /usr/doc/Makefile
     /usr/share/examples/etc/make.conf
     /usr/src/Makefile
     /usr/src/Makefile.inc1

SEE ALSO
     gcc(1), install(1), make(1), ports(7), lpd(8), sendmail(8)

HISTORY
     The make.conf file	appeared sometime before FreeBSD 4.0.

AUTHORS
     This manual page was written by Mike W. Meyer <mwm@mired.org>.

BUGS
     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
     available.

BSD			       November	3, 2000				   BSD

NAME | DESCRIPTION | FILES | SEE ALSO | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=make.conf&sektion=5&manpath=FreeBSD+5.0-RELEASE>

home | help