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 version of GCC builds the base system, including
132 is the default value.
135 Controls which linker to use by default. Currently accepted
138 (GNU gold linker, default) and
140 (classic GNU ld linker).
143 Controls which linker builds the base system, including
146 is the default value.
149 Controls which binutils to use by default.
150 Currently accepted values are
155 .It Va WORLD_BINUTILSVER
157 Controls which version of binutils builds the base system, including
160 is the default value.
163 Controls the compiler setting when compiling C code.
164 Optimization levels are controlled by
165 .Va WORLD_CCOPTLEVEL .
167 is provided as a set of
169 settings suggested by
170 .An Bruce Evans Aq Mt bde@FreeBSD.org
171 for developing and testing changes.
172 They can be used safely, if set, by:
173 .Bd -literal -offset indent
174 WORLD_CFLAGS+=${BDECFLAGS}
176 .It Va WORLD_CCOPTLEVEL
177 (str) Allows to override default compiler optimization level
179 Common levels are: 0, 1, 2, 3, g, s, fast.
184 is strongly discouraged.
191 to be set to a blank value, if set.
196 for compiling with debug symbols.
199 Setting this variable will prevent CPU specific compiler flags
200 from being automatically added to
205 Controls the compiler settings when compiling C++ code.
207 is initially set to the value of
209 If you want to add to the
217 the default install command.
218 To have components compared before doing the install, use
219 .Bd -literal -offset indent
224 Inhibit automatic backup of world binaries as port of
231 defines where system binaries will be backed up for the
236 .Dq /var/backups/world_backup .
239 defines where system binaries will be backed up automatically
245 .Dq Ev MAKEOBJDIRPREFIX Ns /world_binaries/ Ns Ev DESTDIR .
248 List of directories that should be entered when running
254 Controls the shell used internally by
256 to process the command scripts in makefiles.
261 all currently supported.
262 .Bd -literal -offset indent
265 .It Va MODULES_OVERRIDE
267 Set to a list of modules to build instead of all of them.
268 .It Va MTREE_FOLLOWS_SYMLINKS
277 Set this to the flag to pass to the
280 If set to a blank value, debug symbols will not be removed.
282 is automatically set to a blank value if
292 Set this to disable name caching in the nsswitch subsystem.
293 The generic caching daemon,
295 will not be built either if this option is set.
297 Set this if you don't want
301 or used in the kernel build.
302 .It Va STATIC_LOCALES
304 Set to a list of locales to build into statically-linked binaries.
305 Currently supported locales are: BIG5 EUC EUCTW ISO2022 MSKanji UTF8
308 The following list provides a name and short description for variables
309 that are only used doing a kernel build:
311 .It Va BOOT_COMCONSOLE_PORT
313 The port address to use for the console if the boot blocks have
314 been configured to use a serial console instead of the keyboard/video card.
315 .It Va BOOT_COMCONSOLE_SPEED
317 The baud rate to use for the console if the boot blocks have
318 been configured to use a serial console instead of the keyboard/video card.
321 Controls the compiler optimization settings for kernel and module compiles.
323 Allows you to add additional compiler flags for kernel and module compiles.
327 to specify any optimization overrides, as some modules may have to override
328 it to enforce a lower optimization level.
331 Controls which kernel configurations will be
333 .Dq Li "${MAKE} buildkernel"
335 .Dq Li "${MAKE} installkernel" .
337 .Bd -literal -offset indent
338 KERNCONF=MINE DEBUG X86_64_GENERIC OTHERMACHINE
341 will build the kernels specified by the config files
342 .Pa MINE , DEBUG , X86_64_GENERIC ,
345 and install the kernel specified by the config file
349 .It Va NO_CPU_COPTFLAGS
351 Setting this variable will prevent CPU specific compiler flags
352 from being automatically added to
355 .It Va NO_KERNELCLEAN
357 Set this to skip the clean target when using
358 .Dq Li "${MAKE} buildkernel" .
359 .It Va NO_KERNELCONFIG
361 Set this to skip running
364 .Dq Li "${MAKE} buildkernel" .
365 .It Va NO_KERNELDEPEND
367 Set this to skip running
368 .Dq Li "${MAKE} depend"
370 .Dq Li "${MAKE} buildkernel" .
371 .It Va NO_KERNEL_OLD_STRIP
373 Set this to skip stripping debugging symbols from old kernel and modules
374 (kernel.old, modules.old) during
375 .Dq Li "${MAKE} installkernel" .
378 Set to not build modules with the kernel.
381 The following list provides a name and short description for variables
382 that are used during the world build:
384 .It Va ENABLE_SUID_SSH
388 with the setuid bit turned on.
389 .It Va MODULES_WITH_WORLD
391 Set to build modules with the system instead of the kernel.
392 .It Va NO_ALTBINUTILS
394 Set to not build the alternative (non-default) set of binutils.
395 .It Va NO_ALTCOMPILER
397 Set to not build the designated secondary compiler (GCC 4.7 and others).
400 Set to not build CVS.
403 Set to not build games.
412 (reentrant version of
418 and related programs.
421 Set to not enter or install to the share subdirectory.
424 Set this to disable cleaning during
425 .Dq Li "make buildworld" .
426 This should not be set unless you know what you are doing.
430 .Dq Li "${MAKE} clean"
432 .Dq Li "${MAKE} cleandir" .
435 Set to not install certain components with flag schg.
436 This is useful in a jailed environment.
439 Set to not build manual pages
442 Set to not compress the manual pages.
445 Set to avoid compiling profiled libraries.
448 Set to disable the installation of
450 with the set-user-ID bit on.
453 The path to the xauth program used by OpenSSH client.
458 configuration file to use at install time.
459 The value should include the full path to the
462 .Pa /etc/mail/myconfig.mc .
463 Use with caution as a make install will overwrite any existing
464 .Pa /etc/mail/sendmail.cf .
465 .It Va SENDMAIL_SUBMIT_MC
469 configuration file for mail submission
470 to use at install time.
471 The value should include the full path to the
474 .Pa /etc/mail/mysubmit.mc .
475 Use with caution as a make install will overwrite any existing
476 .Pa /etc/mail/submit.cf .
477 .It Va SENDMAIL_CF_DIR
479 Override the default location for the
481 configuration files used to build a
487 .Pa /usr/local/share/sendmail/cf .
488 .It Va SENDMAIL_M4_FLAGS
497 .It Va SENDMAIL_MAP_PERMS
499 Mode to use when generating alias and map database files using
500 .Pa /etc/mail/Makefile .
501 The default value is 0640.
508 to configure the system's default threading library.
511 .It Va WANT_INSTALLER
513 Set to build the installer.
514 .It Va WANT_NETGRAPH7
516 Set to build a newer, experimental
519 It has to be accompanied by
521 options in the kernel.
524 The following list provides a name and short description for variables
525 that are used when performing various audit builds.
528 Enable extra format checking related warnings.
530 Include skipped or moved warning flags for a given
536 The following list provides a name and short description for variables
537 that are used when building documentation.
541 The default format for system documentation, depends on your
545 for simple printers or
547 for postscript or graphics printers with a ghostscript
549 .It Va GROFF_PAPER_SIZE
551 The default paper size for
559 .Bl -tag -width /etc/defaults/make.conf -compact
560 .It Pa /etc/defaults/make.conf
561 .It Pa /etc/make.conf
562 .It Pa /usr/src/Makefile
563 .It Pa /usr/src/Makefile.inc1
573 file appeared sometime before
576 This manual page was written by
577 .An Mike W. Meyer Aq Mt mwm@mired.org .