4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 .\" $FreeBSD: src/share/man/man5/make.conf.5,v 1.12.2.30 2003/05/18 17:05:55 brueffer Exp $
26 .\" $DragonFly: src/share/man/man5/make.conf.5,v 1.38 2008/11/03 00:25:45 pavalos Exp $
33 .Nd system build information
37 contains settings that control the compilation of the
42 is generally created by the system administrator when the values need
43 to be changed from their defaults.
47 is not to run commands or perform compilation actions
49 Instead, it is included by the various makefiles in
51 which conditionalize their internal actions according to the settings
56 file is included from the appropriate
58 which specifies the default settings for all the available options.
59 Options need only be specified in
61 when the system administrator wishes to override these defaults.
63 The build procedures occur in three areas: world, kernel, and
67 may be applicable during builds in one, two, or all of these areas.
68 They may be specified for a particular build via the
73 The following lists provide a name and short description for each
74 variable you can use during the indicated builds.
75 The values of variables flagged as
77 are ignored; the variable being set at all (even to
81 causes it to be treated as if it were set.
83 The following list provides a name and short description for variables
84 that are used for all builds, or are used by the
86 for things other than builds.
90 Controls which processor should be targeted for generated code.
91 This controls processor-specific optimizations in certain code
92 (currently only OpenSSL) as well as modifying the value of
96 to contain the appropriate optimization directive to
98 The automatic setting of
102 may be overridden using the
106 variables, respectively. Refer to
107 .Pa /usr/share/examples/etc/defaults/make.conf
108 for a list of recognized
113 Controls which GCC version to use by default.
116 so as not to interfere with overrides from userland.
117 We currently recommend that an override NOT be set in
119 Currently accepted values for compilers which are part of
125 All other values will handled according to the settings in
126 .Xr compilers.conf 5 .
129 Controls which binutils to use by default.
130 Currently accepted values are
136 Controls the compiler setting when compiling C code.
137 Optimization levels above
142 is provided as a set of
144 settings suggested by
145 .An "Bruce Evans" Aq bde@FreeBSD.org
146 for developing and testing changes.
147 They can be used, if set, by:
148 .Bd -literal -offset indent
157 to be set to a blank value, if set.
162 for compiling with debug symbols.
165 Setting this variable will prevent CPU specific compiler flags
166 from being automatically added to
171 Controls the compiler settings when compiling C++ code.
173 is initially set to the value of
175 If you want to add to the
183 the default install command.
184 To have components compared before doing the install, use
185 .Bd -literal -offset indent
190 List any directories that should be entered when running make
195 Controls the shell used internally by
197 to process the command scripts in makefiles.
202 all currently supported.
203 .Bd -literal -offset indent
206 .It Va MODULES_OVERRIDE
208 Set to a list of modules to build instead of all of them.
209 .It Va MTREE_FOLLOWS_SYMLINKS
218 Set this to the flag to pass to the
221 If set to a blank value, debug symbols will not be removed.
223 is automatically set to a blank value if
233 Set this to disable name caching in the nsswitch subsystem.
234 The generic caching daemon,
236 will not be built either if this option is set.
238 Set this if you don't want
242 or used in the kernel build.
243 .It Va STATIC_LOCALES
245 Set to a list of locales to build into statically-linked binaries.
246 Currently supported locales are: BIG5 EUC EUCTW ISO2022 MSKanji UTF8
249 The following list provides a name and short description for variables
250 that are only used doing a kernel build:
252 .It Va BOOT_COMCONSOLE_PORT
254 The port address to use for the console if the boot blocks have
255 been configured to use a serial console instead of the keyboard/video card.
256 .It Va BOOT_COMCONSOLE_SPEED
258 The baud rate to use for the console if the boot blocks have
259 been configured to use a serial console instead of the keyboard/video card.
262 Controls the compiler settings when building the
264 Optimization levels above
267 are not guaranteed to work.
270 Controls which kernel configurations will be
272 .Dq Li "${MAKE} buildkernel"
274 .Dq Li "${MAKE} installkernel" .
276 .Bd -literal -offset indent
277 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
280 will build the kernels specified by the config files
281 .Pa MINE , DEBUG , GENERIC ,
284 and install the kernel specified by the config file
288 .It Va LOADER_TFTP_SUPPORT
290 While not a buildkernel-affected option, there is no better place for this.
293 loader retrieves the kernel via NFS.
294 Defining this and recompiling
295 .Pa /usr/src/sys/boot
296 will cause it to retrieve the kernel via TFTP.
297 This allows pxeboot to load a custom BOOTP diskless kernel yet
298 still mount the server's
300 rather than load the server's kernel.
301 .It Va NO_CPU_COPTFLAGS
303 Setting this variable will prevent CPU specific compiler flags
304 from being automatically added to
307 .It Va NO_KERNELCLEAN
309 Set this to skip the clean target when using
310 .Dq Li "${MAKE} buildkernel" .
311 .It Va NO_KERNELCONFIG
313 Set this to skip running
316 .Dq Li "${MAKE} buildkernel" .
317 .It Va NO_KERNELDEPEND
319 Set this to skip running
320 .Dq Li "${MAKE} depend"
322 .Dq Li "${MAKE} buildkernel" .
323 .It Va NO_KERNEL_OLD_STRIP
325 Set this to skip stripping debugging symbols from old kernel and modules
326 (kernel.old, modules.old) during
327 .Dq Li "${MAKE} installkernel" .
330 Set to not build modules with the kernel.
333 The following list provides a name and short description for variables
334 that are used during the world build:
336 .It Va ENABLE_SUID_SSH
340 with the setuid bit turned on.
341 .It Va MODULES_WITH_WORLD
343 Set to build modules with the system instead of the kernel.
346 Set to not build BIND.
347 .It Va NO_BIND_DNSSEC
349 Set to not build DNSSEC support in BIND.
352 Set to not build crypto code.
355 Set to not build CVS.
358 Set to not build games.
361 Set to not build the newer version of GCC (4.4).
368 Set to not build isdn4bsd package.
371 Set to not build IP Filter package.
376 (reentrant version of
382 and related programs.
383 .It Va NO_MAILWRAPPER
390 Set to not build Objective C support.
393 Set to not build OpenSSH.
396 Set to not build OpenSSL (implies
402 and related programs.
405 Set to not enter the share subdirectory.
408 Set to not compile in X\-Windows support (e.g.\&
412 Set this to disable cleaning during
413 .Dq Li "make buildworld" .
414 This should not be set unless you know what you are doing.
418 .Dq Li "${MAKE} clean"
420 .Dq Li "${MAKE} cleandir" .
423 Set to not install certain components with flag schg.
424 This is useful in a jailed environment.
427 Set to not make or install
430 .It Va NOINFOCOMPRESS
432 Set to not compress the info pages.
435 Set to not build manual pages
438 Set to not compress the manual pages.
441 Set to avoid compiling profiled libraries.
444 Set to disable the installation of
446 with the set-user-ID bit on.
451 configuration file to use at install time.
452 The value should include the full path to the
455 .Pa /etc/mail/myconfig.mc .
456 Use with caution as a make install will overwrite any existing
457 .Pa /etc/mail/sendmail.cf .
461 .It Va SENDMAIL_SUBMIT_MC
465 configuration file for mail submission
466 to use at install time.
467 The value should include the full path to the
470 .Pa /etc/mail/mysubmit.mc .
471 Use with caution as a make install will overwrite any existing
472 .Pa /etc/mail/submit.cf .
473 .It Va SENDMAIL_ADDITIONAL_MC
477 files which should be built into
480 The value should include the full path to the
484 .Pa /etc/mail/bar.mc .
485 .It Va SENDMAIL_CF_DIR
487 Override the default location for the
489 configuration files used to build a
494 .It Va SENDMAIL_M4_FLAGS
503 .It Va SENDMAIL_CFLAGS
505 Flags to pass to the compile command when building
509 flags can be used to provide SASL support with setting such as:
510 .Bd -literal -offset indent
511 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
512 SENDMAIL_LDFLAGS=-L/usr/local/lib
513 SENDMAIL_LDADD=-lsasl
515 .It Va SENDMAIL_LDFLAGS
519 command when building
521 .It Va SENDMAIL_LDADD
523 Flags to add to the end of the
525 command when building
527 .It Va SENDMAIL_DPADD
529 Extra dependencies to add when building
531 .It Va SENDMAIL_SET_USER_ID
535 as a set-user-ID root binary instead of a set-group-ID binary
537 .Pa /etc/mail/submit.{cf,mc} .
538 Use of this flag is not recommended and the alternative advice in
540 should be followed instead if at all possible.
541 .It Va SENDMAIL_MAP_PERMS
543 Mode to use when generating alias and map database files using
544 .Pa /etc/mail/Makefile .
545 The default value is 0640.
552 to configure the system's default threading library.
557 Set to build the IDEA encryption code.
558 This code is patented in the USA and many European countries.
560 .Em "YOUR RESPONSIBILITY"
561 to determine if you can legally use IDEA.
562 .It Va WANT_INSTALLER
564 Set to build the installer.
567 The following list provides a name and short description for variables
568 that are used when building documentation.
572 The list of languages and encodings to build and install.
575 The default format for system documentation, depends on your
579 for simple printers or
581 for postscript or graphics printers with a ghostscript
583 .It Va GROFF_PAPER_SIZE
585 The default paper size for
593 .Bl -tag -width /etc/defaults/make.conf -compact
594 .It Pa /etc/defaults/make.conf
595 .It Pa /etc/make.conf
596 .It Pa /usr/src/Makefile
597 .It Pa /usr/src/Makefile.inc1
608 file appeared sometime before
611 This manual page was written by
612 .An Mike W. Meyer Aq mwm@mired.org .