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 are
127 Controls the compiler setting when compiling C code.
128 Optimization levels above
133 is provided as a set of
135 settings suggested by
136 .An "Bruce Evans" Aq bde@FreeBSD.org
137 for developing and testing changes.
138 They can be used, if set, by:
139 .Bd -literal -offset indent
144 Setting this variable will prevent CPU specific compiler flags
145 from being automatically added to
150 Controls the compiler settings when compiling C++ code.
152 is initially set to the value of
154 If you want to add to the
162 the default install command.
163 To have components compared before doing the install, use
164 .Bd -literal -offset indent
169 List any directories that should be entered when running make
174 Controls the shell used internally by
176 to process the command scripts in makefiles.
181 all currently supported.
182 .Bd -literal -offset indent
185 .It Va MODULES_OVERRIDE
187 Set to a list of modules to build instead of all of them.
188 .It Va MTREE_FOLLOWS_SYMLINKS
197 Set this to the flag to pass the
200 If set to a blank value, components will be installed with debugging
207 when WARNS is in effect.
215 Set this to disable name caching in the nsswitch subsystem.
216 The generic caching daemon,
218 will not be built either if this option is set.
221 The following list provides a name and short description for variables
222 that are only used doing a kernel build:
224 .It Va BOOT_COMCONSOLE_PORT
226 The port address to use for the console if the boot blocks have
227 been configured to use a serial console instead of the keyboard/video card.
228 .It Va BOOT_COMCONSOLE_SPEED
230 The baud rate to use for the console if the boot blocks have
231 been configured to use a serial console instead of the keyboard/video card.
234 Controls the compiler settings when building the
236 Optimization levels above
239 are not guaranteed to work.
242 Controls which kernel configurations will be
244 .Dq Li "${MAKE} buildkernel"
246 .Dq Li "${MAKE} installkernel" .
248 .Bd -literal -offset indent
249 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
252 will build the kernels specified by the config files
253 .Pa MINE , DEBUG , GENERIC ,
256 and install the kernel specified by the config file
260 .It Va LOADER_TFTP_SUPPORT
262 While not a buildkernel-affected option, there is no better place for this.
265 loader retrieves the kernel via NFS.
266 Defining this and recompiling
267 .Pa /usr/src/sys/boot
268 will cause it to retrieve the kernel via TFTP.
269 This allows pxeboot to load a custom BOOTP diskless kernel yet
270 still mount the server's
272 rather than load the server's kernel.
273 .It Va NO_CPU_COPTFLAGS
275 Setting this variable will prevent CPU specific compiler flags
276 from being automatically added to
279 .It Va NO_KERNELCLEAN
281 Set this to skip the clean target when using
282 .Dq Li "${MAKE} buildkernel" .
283 .It Va NO_KERNELCONFIG
285 Set this to skip running
288 .Dq Li "${MAKE} buildkernel" .
289 .It Va NO_KERNELDEPEND
291 Set this to skip running
292 .Dq Li "${MAKE} depend"
294 .Dq Li "${MAKE} buildkernel" .
295 .It Va NO_KERNEL_OLD_STRIP
297 Set this to skip stripping debugging symbols from old kernel and modules
298 (kernel.old, modules.old) during
299 .Dq Li "${MAKE} installkernel" .
302 Set to not build modules with the kernel.
305 The following list provides a name and short description for variables
306 that are used during the world build:
308 .It Va ENABLE_SUID_K5SU
310 Set this if you wish to use the k5su utility.
311 Otherwise, it will be installed without the set-user-ID bit set.
312 This is only relevant if
315 .It Va ENABLE_SUID_SSH
319 with the setuid bit turned on.
320 .It Va MODULES_WITH_WORLD
322 Set to build modules with the system instead of the kernel.
325 Set to not build BIND.
328 Set to not build crypto code.
331 Set to not build CVS.
334 Set to not build games.
337 Set to not build the older version of GCC (3.4).
344 Set to not build isdn4bsd package.
347 Set to not build IP Filter package.
352 (reentrant version of
358 and related programs.
359 .It Va NO_MAILWRAPPER
366 Set to not build Objective C support.
369 Set to not build OpenSSH.
372 Set to not build OpenSSL (implies
378 and related programs.
381 Set to not enter the share subdirectory.
384 Set to not compile in X\-Windows support (e.g.\&
388 Set this to disable cleaning during
389 .Dq Li "make buildworld" .
390 This should not be set unless you know what you are doing.
394 .Dq Li "${MAKE} clean"
396 .Dq Li "${MAKE} cleandir" .
399 Set to not install certain components with flag schg.
400 This is useful in a jailed environment.
403 Set to not make or install
406 .It Va NOINFOCOMPRESS
408 Set to not compress the info pages.
411 Set to not build manual pages
414 Set to not compress the manual pages.
417 Set to avoid compiling profiled libraries.
420 Set to disable the installation of
422 with the set-user-ID bit on.
427 configuration file to use at install time.
428 The value should include the full path to the
431 .Pa /etc/mail/myconfig.mc .
432 Use with caution as a make install will overwrite any existing
433 .Pa /etc/mail/sendmail.cf .
437 .It Va SENDMAIL_SUBMIT_MC
441 configuration file for mail submission
442 to use at install time.
443 The value should include the full path to the
446 .Pa /etc/mail/mysubmit.mc .
447 Use with caution as a make install will overwrite any existing
448 .Pa /etc/mail/submit.cf .
449 .It Va SENDMAIL_ADDITIONAL_MC
453 files which should be built into
456 The value should include the full path to the
460 .Pa /etc/mail/bar.mc .
461 .It Va SENDMAIL_CF_DIR
463 Override the default location for the
465 configuration files used to build a
470 .It Va SENDMAIL_M4_FLAGS
479 .It Va SENDMAIL_CFLAGS
481 Flags to pass to the compile command when building
485 flags can be used to provide SASL support with setting such as:
486 .Bd -literal -offset indent
487 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
488 SENDMAIL_LDFLAGS=-L/usr/local/lib
489 SENDMAIL_LDADD=-lsasl
491 .It Va SENDMAIL_LDFLAGS
495 command when building
497 .It Va SENDMAIL_LDADD
499 Flags to add to the end of the
501 command when building
503 .It Va SENDMAIL_DPADD
505 Extra dependencies to add when building
507 .It Va SENDMAIL_SET_USER_ID
511 as a set-user-ID root binary instead of a set-group-ID binary
513 .Pa /etc/mail/submit.{cf,mc} .
514 Use of this flag is not recommended and the alternative advice in
516 should be followed instead if at all possible.
517 .It Va SENDMAIL_MAP_PERMS
519 Mode to use when generating alias and map database files using
520 .Pa /etc/mail/Makefile .
521 The default value is 0640.
528 to configure the system's default threading library.
531 .It Va TOP_TABLE_SIZE
534 uses a hash table for the user names. The size of this hash can be tuned
535 to match the number of local users. The table size should be a prime number
536 approximately twice as large as the number of lines in
538 The default number is 20011.
541 Set to build the IDEA encryption code.
542 This code is patented in the USA and many European countries.
544 .Em "YOUR RESPONSIBILITY"
545 to determine if you can legally use IDEA.
546 .It Va WANT_INSTALLER
548 Set to build the installer.
551 Set this to build Kerberos5 (KTH Heimdal).
553 This is still experimental code.
556 The following list provides a name and short description for variables
557 that are used when building documentation.
561 The list of languages and encodings to build and install.
564 The default format for system documentation, depends on your
568 for simple printers or
570 for postscript or graphics printers with a ghostscript
572 .It Va GROFF_PAPER_SIZE
574 The default paper size for
582 .Bl -tag -width /etc/defaults/make.conf -compact
583 .It Pa /etc/defaults/make.conf
584 .It Pa /etc/make.conf
585 .It Pa /usr/src/Makefile
586 .It Pa /usr/src/Makefile.inc1
597 file appeared sometime before
600 This manual page was written by
601 .An Mike W. Meyer Aq mwm@mired.org .
603 This manual page may occasionally be out of date with respect to
604 the options currently available for use in
607 .Pa /etc/defaults/make.conf
608 file for the latest options which are available.