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 $
32 .Nd system build information
36 contains settings that control the compilation of the
41 is generally created by the system administrator when the values need
42 to be changed from their defaults.
46 is not to run commands or perform compilation actions
48 Instead, it is included by the various makefiles in
50 which conditionalize their internal actions according to the settings
55 file is included from the appropriate
57 which specifies the default settings for all the available options.
58 Options need only be specified in
60 when the system administrator wishes to override these defaults.
62 The build procedures occur in three areas: world, kernel, and
66 may be applicable during builds in one, two, or all of these areas.
67 They may be specified for a particular build via the
72 The following lists provide a name and short description for each
73 variable you can use during the indicated builds.
74 The values of variables flagged as
76 are ignored; the variable being set at all (even to
80 causes it to be treated as if it were set.
82 The following list provides a name and short description for variables
83 that are used for all builds, or are used by the
85 for things other than builds.
89 Controls which processor should be targeted for generated code.
90 This controls processor-specific optimizations in certain code
91 (currently only OpenSSL) as well as modifying the value of
95 to contain the appropriate optimization directive to
97 The automatic setting of
101 may be overridden using the
105 variables, respectively. Refer to
106 .Pa /usr/share/examples/etc/defaults/make.conf
107 for a list of recognized
112 Controls which GCC version to use by default.
115 so as not to interfere with overrides from userland.
116 We currently recommend that an override NOT be set in
118 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
137 Controls the compiler setting when compiling C code.
138 Optimization levels above
143 is provided as a set of
145 settings suggested by
146 .An "Bruce Evans" Aq bde@FreeBSD.org
147 for developing and testing changes.
148 They can be used, if set, by:
149 .Bd -literal -offset indent
158 to be set to a blank value, if set.
163 for compiling with debug symbols.
166 Setting this variable will prevent CPU specific compiler flags
167 from being automatically added to
172 Controls the compiler settings when compiling C++ code.
174 is initially set to the value of
176 If you want to add to the
184 the default install command.
185 To have components compared before doing the install, use
186 .Bd -literal -offset indent
191 List any directories that should be entered when running make
196 Controls the shell used internally by
198 to process the command scripts in makefiles.
203 all currently supported.
204 .Bd -literal -offset indent
207 .It Va MODULES_OVERRIDE
209 Set to a list of modules to build instead of all of them.
210 .It Va MTREE_FOLLOWS_SYMLINKS
219 Set this to the flag to pass to the
222 If set to a blank value, debug symbols will not be removed.
224 is automatically set to a blank value if
234 Set this to disable name caching in the nsswitch subsystem.
235 The generic caching daemon,
237 will not be built either if this option is set.
239 Set this if you don't want
243 or used in the kernel build.
244 .It Va STATIC_LOCALES
246 Set to a list of locales to build into statically-linked binaries.
247 Currently supported locales are: BIG5 EUC EUCTW ISO2022 MSKanji UTF8
250 The following list provides a name and short description for variables
251 that are only used doing a kernel build:
253 .It Va BOOT_COMCONSOLE_PORT
255 The port address to use for the console if the boot blocks have
256 been configured to use a serial console instead of the keyboard/video card.
257 .It Va BOOT_COMCONSOLE_SPEED
259 The baud rate to use for the console if the boot blocks have
260 been configured to use a serial console instead of the keyboard/video card.
263 Controls the compiler settings when building the
265 Optimization levels above
268 are not guaranteed to work.
271 Controls which kernel configurations will be
273 .Dq Li "${MAKE} buildkernel"
275 .Dq Li "${MAKE} installkernel" .
277 .Bd -literal -offset indent
278 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
281 will build the kernels specified by the config files
282 .Pa MINE , DEBUG , GENERIC ,
285 and install the kernel specified by the config file
289 .It Va LOADER_TFTP_SUPPORT
291 While not a buildkernel-affected option, there is no better place for this.
294 loader retrieves the kernel via NFS.
295 Defining this and recompiling
296 .Pa /usr/src/sys/boot
297 will cause it to retrieve the kernel via TFTP.
298 This allows pxeboot to load a custom BOOTP diskless kernel yet
299 still mount the server's
301 rather than load the server's kernel.
302 .It Va NO_CPU_COPTFLAGS
304 Setting this variable will prevent CPU specific compiler flags
305 from being automatically added to
308 .It Va NO_KERNELCLEAN
310 Set this to skip the clean target when using
311 .Dq Li "${MAKE} buildkernel" .
312 .It Va NO_KERNELCONFIG
314 Set this to skip running
317 .Dq Li "${MAKE} buildkernel" .
318 .It Va NO_KERNELDEPEND
320 Set this to skip running
321 .Dq Li "${MAKE} depend"
323 .Dq Li "${MAKE} buildkernel" .
324 .It Va NO_KERNEL_OLD_STRIP
326 Set this to skip stripping debugging symbols from old kernel and modules
327 (kernel.old, modules.old) during
328 .Dq Li "${MAKE} installkernel" .
331 Set to not build modules with the kernel.
334 The following list provides a name and short description for variables
335 that are used during the world build:
337 .It Va ENABLE_SUID_SSH
341 with the setuid bit turned on.
342 .It Va MODULES_WITH_WORLD
344 Set to build modules with the system instead of the kernel.
345 .It Va NO_BINUTILS221
347 Set to not build the older version of binutils (2.21).
350 Set to not build crypto code.
353 Set to not build CVS.
356 Set to not build games.
359 Set to not build the older version of GCC (4.1).
366 Set to not build isdn4bsd package.
371 (reentrant version of
377 and related programs.
378 .It Va NO_MAILWRAPPER
385 Set to not build Objective C support.
388 Set to not build OpenSSH.
391 Set to not build OpenSSL (implies
397 and related programs.
400 Set to not enter the share subdirectory.
403 Set to not compile in X\-Windows support (e.g.\&
407 Set this to disable cleaning during
408 .Dq Li "make buildworld" .
409 This should not be set unless you know what you are doing.
413 .Dq Li "${MAKE} clean"
415 .Dq Li "${MAKE} cleandir" .
418 Set to not install certain components with flag schg.
419 This is useful in a jailed environment.
422 Set to not make or install
425 .It Va NOINFOCOMPRESS
427 Set to not compress the info pages.
430 Set to not build manual pages
433 Set to not compress the manual pages.
436 Set to avoid compiling profiled libraries.
439 Set to disable the installation of
441 with the set-user-ID bit on.
446 configuration file to use at install time.
447 The value should include the full path to the
450 .Pa /etc/mail/myconfig.mc .
451 Use with caution as a make install will overwrite any existing
452 .Pa /etc/mail/sendmail.cf .
456 .It Va SENDMAIL_SUBMIT_MC
460 configuration file for mail submission
461 to use at install time.
462 The value should include the full path to the
465 .Pa /etc/mail/mysubmit.mc .
466 Use with caution as a make install will overwrite any existing
467 .Pa /etc/mail/submit.cf .
468 .It Va SENDMAIL_ADDITIONAL_MC
472 files which should be built into
475 The value should include the full path to the
479 .Pa /etc/mail/bar.mc .
480 .It Va SENDMAIL_CF_DIR
482 Override the default location for the
484 configuration files used to build a
489 .It Va SENDMAIL_M4_FLAGS
498 .It Va SENDMAIL_CFLAGS
500 Flags to pass to the compile command when building
504 flags can be used to provide SASL support with setting such as:
505 .Bd -literal -offset indent
506 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
507 SENDMAIL_LDFLAGS=-L/usr/local/lib
508 SENDMAIL_LDADD=-lsasl
510 .It Va SENDMAIL_LDFLAGS
514 command when building
516 .It Va SENDMAIL_LDADD
518 Flags to add to the end of the
520 command when building
522 .It Va SENDMAIL_DPADD
524 Extra dependencies to add when building
526 .It Va SENDMAIL_SET_USER_ID
530 as a set-user-ID root binary instead of a set-group-ID binary
532 .Pa /etc/mail/submit.{cf,mc} .
533 Use of this flag is not recommended and the alternative advice in
535 should be followed instead if at all possible.
536 .It Va SENDMAIL_MAP_PERMS
538 Mode to use when generating alias and map database files using
539 .Pa /etc/mail/Makefile .
540 The default value is 0640.
547 to configure the system's default threading library.
552 Set to build the IDEA encryption code.
553 This code is patented in the USA and many European countries.
555 .Em "YOUR RESPONSIBILITY"
556 to determine if you can legally use IDEA.
557 .It Va WANT_INSTALLER
559 Set to build the installer.
562 The following list provides a name and short description for variables
563 that are used when building documentation.
567 The list of languages and encodings to build and install.
570 The default format for system documentation, depends on your
574 for simple printers or
576 for postscript or graphics printers with a ghostscript
578 .It Va GROFF_PAPER_SIZE
580 The default paper size for
588 .Bl -tag -width /etc/defaults/make.conf -compact
589 .It Pa /etc/defaults/make.conf
590 .It Pa /etc/make.conf
591 .It Pa /usr/src/Makefile
592 .It Pa /usr/src/Makefile.inc1
603 file appeared sometime before
606 This manual page was written by
607 .An Mike W. Meyer Aq mwm@mired.org .