The file
contains system-wide settings that will apply to every build using
make(1)
and the standard
sys.mk
file.
This is achieved as follows:
make(1)
processes the system makefile
sys.mk
before any other file by default, and
sys.mk
includes
.
The file
uses the standard makefile syntax.
However,
should not specify any dependencies to
make(1).
Instead,
is to set
make(1)
variables that control the actions of other makefiles.
The default location of
is
/etc/make.conf
though an alternative location can be specified in the
make(1)
variable
__MAKE_CONF
You may need to override the location of
if the system-wide settings are not suitable for a particular build.
For instance, setting
__MAKE_CONF
to
/dev/null
effectively resets all build controls to their defaults.
The primary purpose of
is to control the compilation of the
Fx sources, documentation, and ported applications,
which are usually found in
/usr/src
/usr/doc
and
/usr/ports
As a rule, the system administrator creates
when the values of certain control variables 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
may be applicable 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).
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
Vt 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.
ALWAYS_CHECK_MAKE
(Vt 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 buildworld targets to handle
upgrades from older versions of
Fx .
CFLAGS
(Vt str
)
Controls the compiler setting when compiling C code.
Optimization levels other than
-O
and
-O2
are not supported.
BDECFLAGS
is provided as a set of
gcc(1)
settings suggested by
An Bruce Evans Aq bde@FreeBSD.org
for developing and testing changes.
They can be used, if set, by:
CFLAGS+=${BDECFLAGS}
CPUTYPE
(Vt 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.
CVS_UPDATE
(Vt bool
)
Set this to use
cvs(1)
to update your ports with
``make update
''
CXXFLAGS
(Vt 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
``=
''
DOCSUPFILE
(Vt str
)
The documentation
supfile
to use when doing a
``make update
''
This defaults to
/usr/share/examples/cvsup/doc-supfile
INSTALL
(Vt str
)
the default install command.
To install only files for which the target differs or does not exist, use
INSTALL="install -C"
Note that some makefiles (including those in
/usr/share/mk
may hardcode options for the supplied install command.
LOCAL_DIRS
(Vt str
)
List any directories that should be entered when doing
make's in
/usr/src
in this variable.
MAKE_SHELL
(Vt 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
(Vt str
)
Set this to
``-L
''
to cause
mtree(8)
to follow symlinks.
NO_CPU_CFLAGS
(Vt str
)
Setting this variable will prevent CPU specific compiler flags
from being automatically added to
CFLAGS
during compile time.
NO_CPU_COPTFLAGS
(Vt str
)
Setting this variable will prevent CPU specific compiler flags
from being automatically added to
COPTFLAGS
during compile time.
NO_DOCUPDATE
(Vt bool
)
Set this to not update the doc tree during
``make update
''
NO_PORTSUPDATE
(Vt bool
)
Set this to not update the ports tree during
``make update
''
PORTSSUPFILE
(Vt str
)
The ports
supfile
to use when doing a
``make update
''
This defaults to
/usr/share/examples/cvsup/ports-supfile
SUP
(Vt str
)
The location of the
csup(1)
or
cvsup(1)
command for
``make update
''
SUPFILE
(Vt str
)
The first
supfile
to use when doing a
``make update
''
This defaults to
/usr/share/examples/cvsup/standard-supfile
SUPFILE1
(Vt str
)
The second
supfile
to use when doing a
``make update
''
This defaults to
/usr/share/examples/cvsup/secure-supfile
SUPFILE2
(Vt str
)
The third
supfile
to use when doing a
``make update
''
This defaults to
/usr/share/examples/cvsup/secure-supfile
SUPFLAGS
(Vt str
)
The flag for the
sup(1)
command when doing
``make update
''
This defaults to
[-g L 2
]
SUPHOST
(Vt str
)
The hostname of the sup server to use when doing
``make update
''
SUP_UPDATE
(Vt bool
)
Set this to use
cvsup(1)
to update your ports with
``make update
''
BUILDING THE KERNEL
The following list provides a name and short description for variables
that are only used doing a kernel build:
BOOTWAIT
(Vt 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
(Vt str
)
Controls the compiler settings when building the
kernel.
Optimization levels above
[-O ( O2 , ... ) ]
are not guaranteed to work.
KERNCONF
(Vt 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
MODULES_OVERRIDE
(Vt str
)
Set to a list of modules to build instead of all of them.
NO_KERNELCONFIG
(Vt bool
)
Set this to skip running
config(8)
during
``${MAKE} buildkernel
''
NO_KERNELDEPEND
(Vt bool
)
Set this to skip running
``${MAKE} depend
''
during
``${MAKE} buildkernel
''
NO_MODULES
(Vt bool
)
Set to not build modules with the kernel.
PORTS_MODULES
Set this to the list of ports you wish to rebuild every time the kernel
is built.
WITHOUT_MODULES
(Vt 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
afterMODULES_OVERRIDE
BUILDING THE WORLD
The following list provides a name and short description for variables
that are used during the world build:
BOOT_COMCONSOLE_PORT
(Vt 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
(Vt 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.
BOOT_PXELDR_ALWAYS_SERIAL
(Vt bool
)
Compile in the code into
pxeboot(8)
that forces the use of a serial console.
This is analogous to the
-h
option in
boot(8)
blocks.
BOOT_PXELDR_PROBE_KEYBOARD
(Vt bool
)
Compile in the code into
pxeboot(8)
that probes the keyboard.
If no keyboard is found, boot with the dual console configuration.
This is analogous to the
-D
option in
boot(8)
blocks.
ENABLE_SUID_K5SU
(Vt bool
)
Set this if you wish to use the ksu utility.
Otherwise, it will be
installed without the set-user-ID bit set.
ENABLE_SUID_NEWGRP
(Vt 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
(Vt bool
)
Set this to install
ssh(1)
with the set-user-ID bit turned on.
LOADER_TFTP_SUPPORT
(Vt bool
)
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(8)
to load a custom BOOTP diskless kernel yet
still mount the server's
/
rather than load the server's kernel.
LOADER_FIREWIRE_SUPPORT
(Vt bool
)
Defining this and recompiling
/usr/src/sys/boot/i386
will add
dcons(4)
console driver to
loader(8)
and allow access over FireWire(IEEE1394) using
dconschat(8).
Currently, only i386 and amd64 are supported.
MODULES_WITH_WORLD
(Vt bool
)
Set to build modules with the system instead of the kernel.
NO_CLEAN
(Vt bool
)
Set this to disable cleaning during
``make buildworld
''
This should not be set unless you know what you are doing.
NO_CLEANDIR
(Vt bool
)
Set this to run
``${MAKE} clean
''
instead of
``${MAKE} cleandir
''
NO_MANCOMPRESS
(Vt bool
)
Set to install manual pages uncompressed.
NO_SHARE
(Vt bool
)
Set to not build in the
share
subdir.
NO_SHARED
(Vt bool
)
Set to build
/bin
and
/sbin
statically linked, this can be bad.
If set, every utility that uses
bsd.prog.mk
will be linked statically.
PPP_NO_NAT
(Vt bool
)
Build
ppp(8)
without support for network address translation (NAT).
PPP_NO_NETGRAPH
(Vt bool
)
Set to build
ppp(8)
without support for Netgraph.
PPP_NO_RADIUS
(Vt bool
)
Set to build
ppp(8)
without support for RADIUS.
PPP_NO_SUID
(Vt bool
)
Set to disable the installation of
ppp(8)
as a set-user-ID root program.
SENDMAIL_ADDITIONAL_MC
(Vt 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
SENDMAIL_ALIASES
(Vt str
)
List of
aliases(5)
files to rebuild when using
/etc/mail/Makefile
The default value is
/etc/mail/aliases
SENDMAIL_CFLAGS
(Vt 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:
(Vt str
)
Override the default location for the
m4(1)
configuration files used to build a
.cf
file from a
.mc
file.
SENDMAIL_DPADD
(Vt str
)
Extra dependencies to add when building
sendmail(8).
SENDMAIL_LDADD
(Vt str
)
Flags to add to the end of the
ld(1)
command when building
sendmail(8).
SENDMAIL_LDFLAGS
(Vt str
)
Flags to pass to the
ld(1)
command when building
sendmail(8).
SENDMAIL_M4_FLAGS
(Vt str
)
Flags passed to
m4(1)
when building a
.cf
file from a
.mc
file.
SENDMAIL_MAP_PERMS
(Vt str
)
Mode to use when generating alias and map database files using
/etc/mail/Makefile
The default value is 0640.
SENDMAIL_MAP_SRC
(Vt 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.
SENDMAIL_MAP_TYPE
(Vt 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
(Vt str
)
The default
m4(1)
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.
SENDMAIL_SET_USER_ID
(Vt 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 if at all possible.
SENDMAIL_START_SCRIPT
(Vt 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.conf5.
SENDMAIL_SUBMIT_MC
(Vt str
)
The default
m4(1)
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
TOP_TABLE_SIZE
(Vt 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.
WANT_FORCE_OPTIMIZATION_DOWNGRADE
(Vt 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 various
times.
The value assigned is the highest optimization value used.
BUILDING DOCUMENTATION
The following list provides a name and short description for variables
that are used when building documentation.
DISTDIR
(Vt str
)
Where distfiles are kept.
Normally, this is
distfiles
in
PORTSDIR
DOC_LANG
(Vt str
)
The list of languages and encodings to build and install.
PRINTERDEVICE
(Vt 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.
This
manual page was written by
An Mike W. Meyer Aq mwm@mired.org .
BUGS
This manual page may occasionally be out of date with respect to
the options currently available for use in
.
Please check the
/usr/share/examples/etc/make.conf
file for the latest options which are available.
CAVEATS
Note, that
MAKEOBJDIRPREFIX
and
MAKEOBJDIR
are environment variables and should not be set in
but in make's environment.
