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.18 2006/11/09 18:44:52 pavalos Exp $
28 .Dd September 10, 2006
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. It should be set as
114 CCVER?= so as not to interfere with overrides from userland. We
115 currently recommend that an override NOT be set in
117 Currently accepted values are cc34 and cc40 (experimental).
120 Controls the compiler setting when compiling C code.
121 Optimization levels above
126 is provided as a set of
128 settings suggested by
129 .An "Bruce Evans" Aq bde@FreeBSD.org
130 for developing and testing changes.
131 They can be used, if set, by:
133 .Bd -literal -offset indent
138 Setting this variable will prevent CPU specific compiler flags
139 from being automatically added to
144 Controls the compiler settings when compiling C++ code.
146 is initially set to the value of
148 If you want to add to the
156 the default install command.
157 To have components compared before doing the install, use
158 .Bd -literal -offset indent
163 List any directories that should be entered when running make
168 Controls the shell used internally by
170 to process the command scripts in makefiles.
175 all currently supported.
176 .Bd -literal -offset indent
179 .It Va MODULES_OVERRIDE
181 Set to a list of modules to build instead of all of them.
182 .It Va MTREE_FOLLOWS_SYMLINKS
191 Set this to not update the doc tree during
192 .Dq Li "make update" .
195 Set this to the flag to pass the
198 If set to a blank value, components will be installed with debugging
204 to update your ports with
205 .Dq Li "make update" .
211 .Dq Li "make update" .
217 .Dq Li "make update" .
222 The hostname of the sup server to use when doing
223 .Dq Li "make update" .
229 .Dq Li "make update" .
231 .Pa /usr/share/examples/cvsup/standard\-supfile .
237 .Dq Li "make update" .
239 .Pa /usr/share/examples/cvsup/secure\-supfile .
245 .Dq Li "make update" .
247 .Pa /usr/share/examples/cvsup/secure\-supfile .
253 .Dq Li "make update" .
255 .Pa /usr/share/examples/cvsup/doc\-supfile .
261 when WARNS is in effect.
264 The following list provides a name and short description for variables
265 that are only used doing a kernel build:
267 .It Va BOOT_COMCONSOLE_PORT
269 The port address to use for the console if the boot blocks have
270 been configured to use a serial console instead of the keyboard/video card.
271 .It Va BOOT_COMCONSOLE_SPEED
273 The baud rate to use for the console if the boot blocks have
274 been configured to use a serial console instead of the keyboard/video card.
277 Controls the compiler settings when building the
279 Optimization levels above
280 .Oo Fl O ( O2 , No ...\& ) Oc
281 are not guaranteed to work.
284 Controls which kernel configurations will be
286 .Dq Li "${MAKE} buildkernel"
288 .Dq Li "${MAKE} installkernel" .
290 .Bd -literal -offset indent
291 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
294 will build the kernels specified by the config files
295 .Pa MINE , DEBUG , GENERIC ,
298 and install the kernel specified by the config file
302 .It Va LOADER_TFTP_SUPPORT
304 While not a buildkernel-affected option, there is no better place for this.
307 loader retrieves the kernel via NFS.
308 Defining this and recompiling
309 .Pa /usr/src/sys/boot
310 will cause it to retrieve the kernel via TFTP.
311 This allows pxeboot to load a custom BOOTP diskless kernel yet
312 still mount the server's
314 rather than load the server's kernel.
315 .It Va NO_CPU_COPTFLAGS
317 Setting this variable will prevent CPU specific compiler flags
318 from being automatically added to
321 .It Va NO_KERNELCLEAN
323 Set this to skip the clean target when using
324 .Dq Li "${MAKE} buildkernel" .
325 .It Va NO_KERNELCONFIG
327 Set this to skip running
330 .Dq Li "${MAKE} buildkernel" .
331 .It Va NO_KERNELDEPEND
333 Set this to skip running
334 .Dq Li "${MAKE} depend"
336 .Dq Li "${MAKE} buildkernel" .
339 Set to not build modules with the kernel.
342 The following list provides a name and short description for variables
343 that are used during the world build:
345 .It Va ENABLE_SUID_K5SU
347 Set this if you wish to use the k5su utility.
348 Otherwise, it will be installed without the set-user-ID bit set.
349 This is only relevant if
352 .It Va ENABLE_SUID_SSH
356 with the setuid bit turned on.
357 .It Va MODULES_WITH_WORLD
359 Set to build modules with the system instead of the kernel.
362 Set to not build BIND.
365 Set to not build crypto code.
368 Set to not build CVS.
373 and related libraries.
376 Set to not build games.
383 Set to not build isdn4bsd package.
386 Set to not build IP Filter package.
391 (reentrant version of
397 and related programs.
398 .It Va NO_MAILWRAPPER
412 Set to not build Objective C support.
415 Set to not build OpenSSH.
418 Set to not build OpenSSL (implies
424 and related programs.
427 Set to not enter the share subdirectory.
430 Set to not compile in X\-Windows support (e.g.\&
434 Set this to disable cleaning during
435 .Dq Li "make buildworld" .
436 This should not be set unless you know what you are doing.
440 .Dq Li "${MAKE} clean"
442 .Dq Li "${MAKE} cleandir" .
445 Set to not install certain components with flag fschg.
446 This is useful in a jailed environment.
449 Set to not make or install
452 .It Va NOINFOCOMPRESS
454 Set to not compress the info pages.
457 Set to not build manual pages
460 Set to not compress the manual pages.
463 Set to avoid compiling profiled libraries.
466 Set to disable the installation of
468 with the set-user-ID bit on.
473 configuration file to use at install time.
474 The value should include the full path to the
477 .Pa /etc/mail/myconfig.mc .
478 Use with caution as a make install will overwrite any existing
479 .Pa /etc/mail/sendmail.cf .
483 .It Va SENDMAIL_SUBMIT_MC
487 configuration file for mail submission
488 to use at install time.
489 The value should include the full path to the
492 .Pa /etc/mail/mysubmit.mc .
493 Use with caution as a make install will overwrite any existing
494 .Pa /etc/mail/submit.cf .
495 .It Va SENDMAIL_ADDITIONAL_MC
499 files which should be built into
502 The value should include the full path to the
506 .Pa /etc/mail/bar.mc .
507 .It Va SENDMAIL_CF_DIR
509 Override the default location for the
511 configuration files used to build a
516 .It Va SENDMAIL_M4_FLAGS
525 .It Va SENDMAIL_CFLAGS
527 Flags to pass to the compile command when building
531 flags can be used to provide SASL support with setting such as:
532 .Bd -literal -offset indent
533 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
534 SENDMAIL_LDFLAGS=-L/usr/local/lib
535 SENDMAIL_LDADD=-lsasl
537 .It Va SENDMAIL_LDFLAGS
541 command when building
543 .It Va SENDMAIL_LDADD
545 Flags to add to the end of the
547 command when building
549 .It Va SENDMAIL_DPADD
551 Extra dependencies to add when building
553 .It Va SENDMAIL_SET_USER_ID
557 as a set-user-ID root binary instead of a set-group-ID binary
559 .Pa /etc/mail/submit.{cf,mc} .
560 Use of this flag is not recommended and the alternative advice in
562 should be followed instead if at all possible.
563 .It Va SENDMAIL_MAP_PERMS
565 Mode to use when generating alias and map database files using
566 .Pa /etc/mail/Makefile .
567 The default value is 0640.
568 .It Va TOP_TABLE_SIZE
571 uses a hash table for the user names. The size of this hash can be tuned
572 to match the number of local users. The table size should be a prime number
573 approximately twice as large as the number of lines in
575 The default number is 20011.
578 Set to build the experimental version of GCC (4.0).
581 Set to build the experimental version of GCC (4.1).
584 Set to build the IDEA encryption code.
585 This code is patented in the USA and many European countries.
587 .Em "YOUR RESPONSIBILITY"
588 to determine if you can legally use IDEA.
591 Set this to build Kerberos5 (KTH Heimdal).
593 This is still experimental code.
600 The default is to use
604 The following list provides a name and short description for variables
605 that are used when building documentation.
609 The list of languages and encodings to build and install.
612 The default format for system documentation, depends on your
616 for simple printers or
618 for postscript or graphics printers with a ghostscript
622 .Bl -tag -width /etc/defaults/make.conf -compact
623 .It Pa /etc/defaults/make.conf
624 .It Pa /etc/make.conf
625 .It Pa /usr/src/Makefile
626 .It Pa /usr/src/Makefile.inc1
637 file appeared sometime before
640 This manual page was written by
641 .An Mike W. Meyer Aq mwm@mired.org .
643 This manual page may occasionally be out of date with respect to
644 the options currently available for use in
647 .Pa /etc/defaults/make.conf
648 file for the latest options which are available.