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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
MAKE.CONF(5)              FreeBSD 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
     actions 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
     specified for a particular build via the -D option of make(1).

     The following lists provide a name and short description for each
     variable 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
                   generated code.  This controls processor-specific
                   optimizations 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 automatic setting of CFLAGS and COPTFLAGS may be
                   overridden using the NO_CPU_CFLAGS and NO_CPU_COPTFLAGS
                   variables, respectively.  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
                   compiler flags from being automatically added to CFLAGS
                   during compile time.

     NO_CPU_COPTFLAGS
                   (str) Setting this variable will prevent CPU specific
                   compiler flags from being automatically added to COPTFLAGS
                   during 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
                   compared before doing the install, use

                         INSTALL="install -C"

     LOCAL_DIRS    (str) List any directories that should be entered when
                   doing 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
                   symlinks.

     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.

     WARNS_WERROR  Causes -Werror to be added to CFLAGS when WARNS is in
                   effect.

     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
                   accepted by the BIOS before booting from disk, making it
                   possible to give custom boot parameters even when this is
                   set to 0.

     COPTFLAGS     (str) Controls the compiler settings when building the
                   kernel.  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
                   recompiling /usr/src/sys/boot will cause it to retrieve the
                   kernel via TFTP.  This allows pxeboot 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
                   libraries.

     COMPAT20      (bool) Set to install the FreeBSD 2.0 compatibility
                   libraries.

     COMPAT21      (bool) Set to install the FreeBSD 2.1 compatibility
                   libraries.

     COMPAT22      (bool) Set to install the FreeBSD 2.2 compatibility
                   libraries.

     COMPAT3X      (bool) Set to install the FreeBSD 3 compatibility
                   libraries.

     COMPAT4X      (bool) Set to install the FreeBSD 4 compatibility
                   libraries.

     ENABLE_SUIDPERL
                   (bool) Set to enable the installation of an suid perl(1)
                   binary.

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

     KRB5_HOME     (str) If you want to install the MIT Kerberos5 port
                   somewhere 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
                   Kerberos5, use the port(s).

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

     ENABLE_SUID_SSH
                   (bool) Set this to install ssh(1) with the setuid 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_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.

     NOMAN         (bool) Set to not build manual pages

     NO_MAKEDEV    (bool) Set to avoid running ``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.

     NOPERL        (bool) Set to avoid building perl(1).

     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.

     NOUUCP        (bool) Set to not build uucp(1) related programs.

     PERL_THREADED
                   (bool) Set to enable the building and installation of
                   perl(1) with thread support.

     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
                   deprecated.  Avoid using a value of /etc/mail/sendmail.mc
                   as a buildworld will create /etc/mail/sendmail.cf before
                   installworld 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
                   updated 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
                   recommended and the alternative advice in /etc/mail/README
                   should be followed instead of 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
                   approximately twice as large as the number of lines in
                   /etc/passwd.  The default number is 20011.

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

     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.

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

     FORCE_PKG_REGISTER
                   (bool) Set this to override any existing package
                   registration.

     HAVE_MOTIF    (bool) Set this if you have Motif on your system.

     KRB5_HOME     (str) Set this if you want to install the MIT Kerberos5
                   port somewhere other than /usr/local.

     LOCALBASE     (str) Set this to the base directory that non-X ports
                   should be installed in.  It provides the default for PREFIX
                   when building in /usr/ports.

     MASTER_SITE_AFTERSTEP
                   (str) Set this to change the master site for AfterStep
                   ports.  The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_BACKUP
                   (str) Controls the site location that ports check for
                   distfiles if the locations listed in their Makefile do not
                   work.  The last part of the path must be
                   ``/${DIST_SUBDIR}/''.

     MASTER_SITE_COMP_SOURCES
                   (str) Controls the master site location for comp.sources
                   ports.  The last part of the path must be ``%SUBDIR%/''

     MASTER_SITE_GNOME
                   (str) Controls the master site location for GNOME ports.
                   The last part of the path must be ``/%SUBDIR%/''

     MASTER_SITE_GNU
                   (str) Controls the master site location for GNU ports.  The
                   last part of the path must be ``/%SUBDIR%/''

     MASTER_SITE_KDE
                   (str) Controls the master site location for KDE ports.  The
                   last part of the path must be ``/%SUBDIR%/''

     MASTER_SITE_FREEBSD
                   (bool) If set, go to the master FreeBSD site for all files.

     MASTER_SITE_MOZILLA
                   (str) Controls the master site location for Mozilla ports.
                   The last part of the path must be ``/%SUBDIR%/''

     MASTER_SITE_OVERRIDE
                   (str) If set, this site is checked before the sites listed
                   in the ports Makefile.  You can have it check the backup
                   site first by like so:

                         MASTER_SITE_OVERRIDE?=  ${MASTER_SITE_BACKUP}

     MASTER_SITE_PERL_CPAN
                   (str) Controls the master site location for Perl ports.
                   The last part of the path must be

                         /%SUBDIR%/

     MASTER_SORT_REGEX
                   (str) Set this to control the sort order for mirror sets.
                   To set it to prefer mirrors in the .jp domain, use:

                         MASTER_SORT_REGEX?=     ^file: ^ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*.jp/ ://[^/]*.jp.

                   Users of other ccTLD domains should change the ``jp'' to
                   the appropriate domain.

     MASTER_SITE_RINGSERVER
                   (str) Controls the master site location for Ringserver
                   ports.  The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_RUBY
                   (str) Controls the master site location for Ruby ports.
                   The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_SUNSITE
                   (str) Controls the master site location for Sunsite ports.
                   The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_TCLTK
                   (str) Controls the master site location for Tcl and Tk
                   ports.  The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_TEX_CTAN
                   (str) Controls the master site location for TeX ports.  The
                   last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_WINDOWMAKER
                   (str) Controls the master site location for WindowMaker
                   ports.  The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_XCONTRIB
                   (str) Controls the master site location for contributed X
                   ports.  The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_XEMACS
                   (str) Controls the master site location for Xemacs ports.
                   The last part of the path must be ``/%SUBDIR%/''.

     MASTER_SITE_XFREE
                   (str) Controls the master site location for XFree ports.
                   The last part of the path must be ``/%SUBDIR%/''.

     MOTIFLIB      (str) Location of libXm.a and libXm.so.

     MOTIF_STATIC  (bool) Set this if you want ports that use Motif to be
                   built so they can be run on systems without the Motif
                   shared libraries.

     NOCLEANDEPENDS
                   (bool) Set this to prevent ``make clean'' from cleaning the
                   ports that the one being cleaned depends on.

     NOPORTDOCS    (bool) Set this to disable installing additional
                   documentation with ports.

     PACKAGES      (str) Used only for the package target; the directory for
                   the package tree.

     PATCH_SITES   (str) Primary location(s) for the distribution of patch
                   files.

     PORTSDIR      (str) The location of the ports tree.

     USA_RESIDENT  (bool) Set this if you are a resident of the USA so that
                   ports that need to can attempt to comply with U.S. export
                   regulations.

     WITHOUT_X11   (bool) Set this so that ports that can be built with or
                   without X11 support will build without X11 support by
                   default.

     WRKDIRPREFIX  (str) Where to create temporary files used when building
                   ports.

     X11BASE       (str) Should be set to where the X11 distribution has been
                   installed if it is installed anywhere other than
                   /usr/X11R6.

FILES
     /etc/defaults/make.conf
     /etc/make.conf
     /usr/doc/Makefile
     /usr/src/Makefile
     /usr/src/Makefile.inc1
     /usr/ports/Mk/bsd.port.mk
     /usr/ports/Mk/bsd.sites.mk

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
     options currently available for use in make.conf.  Please check the
     /etc/defaults/make.conf file for the latest options which are available.

FreeBSD 11.0-PRERELEASE        November 3, 2000        FreeBSD 11.0-PRERELEASE

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+4.8-RELEASE>

home | help