share/man/man5/make.conf.5

   1 .\" Copyright (c) 2000
   2 .\"     Mike W. Meyer
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   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.
  12 .\"
  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
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\" $FreeBSD$
  26 .\"
  27 .Dd June 16, 2011
  28 .Dt MAKE.CONF 5
  29 .Os
  30 .Sh NAME
  31 .Nm make.conf
  32 .Nd system build information
  33 .Sh DESCRIPTION
  34 The file
  35 .Nm
  36 contains system-wide settings that will apply to every build using
  37 .Xr make 1
  38 and the standard
  39 .Pa sys.mk
  40 file.
  41 This is achieved as follows:
  42 .Xr make 1
  43 processes the system makefile
  44 .Pa sys.mk
  45 before any other file by default, and
  46 .Pa sys.mk
  47 includes
  48 .Nm .
  49 .Pp
  50 The file
  51 .Nm
  52 uses the standard makefile syntax.
  53 However,
  54 .Nm
  55 should not specify any dependencies to
  56 .Xr make 1 .
  57 Instead,
  58 .Nm
  59 is to set
  60 .Xr make 1
  61 variables that control the actions of other makefiles.
  62 .Pp
  63 The default location of
  64 .Nm
  65 is
  66 .Pa /etc/make.conf ,
  67 though an alternative location can be specified in the
  68 .Xr make 1
  69 variable
  70 .Va __MAKE_CONF .
  71 You may need to override the location of
  72 .Nm
  73 if the system-wide settings are not suitable for a particular build.
  74 For instance, setting
  75 .Va __MAKE_CONF
  76 to
  77 .Pa /dev/null
  78 effectively resets all build controls to their defaults.
  79 .Pp
  80 The primary purpose of
  81 .Nm
  82 is to control the compilation of the
  83 .Fx
  84 sources, documentation, and ported applications,
  85 which are usually found in
  86 .Pa /usr/src ,
  87 .Pa /usr/doc ,
  88 and
  89 .Pa /usr/ports .
  90 As a rule, the system administrator creates
  91 .Nm
  92 when the values of certain control variables need to be changed
  93 from their defaults.
  94 .Pp
  95 The system build procedures occur in four broad areas:
  96 the world, the kernel, documentation and ports.
  97 Variables set in
  98 .Nm
  99 may be applicable in one, two, or all four of these areas.
 100 In addition, control variables can be specified
 101 for a particular build via the
 102 .Fl D
 103 option of
 104 .Xr make 1
 105 or in
 106 .Xr environ 7 .
 107 .Pp
 108 The following lists provide a name and short description for each
 109 variable you can use during the indicated builds.
 110 The values of
 111 variables flagged as
 112 .Vt bool
 113 are ignored; the variable being
 114 set at all (even to
 115 .Dq Li FALSE
 116 or
 117 .Dq Li NO )
 118 causes it to
 119 be treated as if it were set.
 120 .Pp
 121 The following list provides a name and short description for variables
 122 that are used for all builds, or are used by the
 123 .Pa makefiles
 124 for things other than builds.
 125 .Bl -tag -width Ar
 126 .It Va ALWAYS_CHECK_MAKE
 127 .Pq Vt bool
 128 Instructs the top-level makefile in the source tree (normally
 129 .Pa /usr/src )
 130 to always check if
 131 .Xr make 1
 132 is up-to-date.
 133 Normally this is only done for the world and buildworld targets to handle
 134 upgrades from older versions of
 135 .Fx .
 136 .It Va CFLAGS
 137 .Pq Vt str
 138 Controls the compiler setting when compiling C code.
 139 Optimization levels other than
 140 .Fl O
 141 and
 142 .Fl O2
 143 are not supported.
 144 .Va BDECFLAGS
 145 is provided as a set of
 146 .Xr gcc 1
 147 settings suggested by
 148 .An "Bruce Evans" Aq bde@FreeBSD.org
 149 for developing and testing changes.
 150 They can be used, if set, by:
 151 .Bd -literal -offset indent
 152 CFLAGS+=${BDECFLAGS}
 153 .Ed
 154 .It Va CPUTYPE
 155 .Pq Vt str
 156 Controls which processor should be targeted for generated
 157 code.
 158 This controls processor-specific optimizations in
 159 certain code (currently only OpenSSL) as well as modifying
 160 the value of
 161 .Va CFLAGS
 162 and
 163 .Va COPTFLAGS
 164 to contain the appropriate optimization directive to
 165 .Xr gcc 1 .
 166 The automatic setting of
 167 .Va CFLAGS
 168 and
 169 .Va COPTFLAGS
 170 may be overridden using the
 171 .Va NO_CPU_CFLAGS
 172 and
 173 .Va NO_CPU_COPTFLAGS
 174 variables, respectively.
 175 Refer to
 176 .Pa /usr/share/examples/etc/make.conf
 177 for a list of recognized
 178 .Va CPUTYPE
 179 options.
 180 .It Va CVS_UPDATE
 181 .Pq Vt bool
 182 Set this to use
 183 .Xr cvs 1
 184 to update your
 185 .Pa src , ports
 186 and
 187 .Pa doc
 188 trees with
 189 .Dq Li "make update" .
 190 .It Va CXXFLAGS
 191 .Pq Vt str
 192 Controls the compiler settings when compiling C++ code.
 193 .Va CXXFLAGS
 194 is initially set to the value of
 195 .Va CFLAGS .
 196 If you want to
 197 add to the
 198 .Va CXXFLAGS
 199 value, use
 200 .Dq Li +=
 201 instead of
 202 .Dq Li = .
 203 .It Va DOCSUPFILE
 204 .Pq Vt str
 205 The documentation
 206 .Ar supfile
 207 to use when doing a
 208 .Dq Li "make update" .
 209 For example,
 210 .Pa /usr/share/examples/cvsup/doc-supfile .
 211 .It Va INSTALL
 212 .Pq Vt str
 213 the default install command.
 214 To install only files for which the target differs or does not exist, use
 215 .Bd -literal -offset indent
 216 INSTALL="install -C"
 217 .Ed
 218 Note that some makefiles (including those in
 219 .Pa /usr/share/mk )
 220 may hardcode options for the supplied install command.
 221 .It Va LOCAL_DIRS
 222 .Pq Vt str
 223 List any directories that should be entered when doing
 224 make's in
 225 .Pa /usr/src
 226 in this variable.
 227 .It Va MAKE_SHELL
 228 .Pq Vt str
 229 Controls the shell used internally by
 230 .Xr make 1
 231 to process the command scripts in makefiles.
 232 .Xr sh 1 ,
 233 .Xr ksh 1 ,
 234 and
 235 .Xr csh 1
 236 all currently supported.
 237 .Pp
 238 .Dl "MAKE_SHELL?=sh"
 239 .It Va MTREE_FOLLOWS_SYMLINKS
 240 .Pq Vt str
 241 Set this to
 242 .Dq Fl L
 243 to cause
 244 .Xr mtree 8
 245 to follow symlinks.
 246 .It Va NO_CPU_CFLAGS
 247 .Pq Vt str
 248 Setting this variable will prevent CPU specific compiler flags
 249 from being automatically added to
 250 .Va CFLAGS
 251 during compile time.
 252 .It Va NO_CPU_COPTFLAGS
 253 .Pq Vt str
 254 Setting this variable will prevent CPU specific compiler flags
 255 from being automatically added to
 256 .Va COPTFLAGS
 257 during compile time.
 258 .It Va NO_DOCUPDATE
 259 .Pq Vt bool
 260 Set this to not update the doc tree during
 261 .Dq Li "make update" .
 262 .It Va NO_PORTSUPDATE
 263 .Pq Vt bool
 264 Set this to not update the ports tree during
 265 .Dq Li "make update" .
 266 .It Va NO_WWWUPDATE
 267 .Pq Vt bool
 268 Set this to not update the www tree during
 269 .Dq Li "make update" .
 270 .It Va PORTSSUPFILE
 271 .Pq Vt str
 272 The ports
 273 .Ar supfile
 274 to use when doing a
 275 .Dq Li "make update" .
 276 For example,
 277 .Pa /usr/share/examples/cvsup/ports-supfile .
 278 .It Va SUP
 279 .Pq Vt str
 280 The location of the
 281 .Xr csup 1
 282 or
 283 .Xr cvsup 1
 284 command for
 285 .Dq Li "make update" .
 286 .It Va SUPFILE
 287 .Pq Vt str
 288 The first
 289 .Ar supfile
 290 to use when doing a
 291 .Dq Li "make update" .
 292 For example,
 293 .Pa /usr/share/examples/cvsup/standard-supfile .
 294 .It Va SUPFILE1
 295 .Pq Vt str
 296 The second
 297 .Ar supfile
 298 to use when doing a
 299 .Dq Li "make update" .
 300 .It Va SUPFILE2
 301 .Pq Vt str
 302 The third
 303 .Ar supfile
 304 to use when doing a
 305 .Dq Li "make update" .
 306 .It Va SUPFLAGS
 307 .Pq Vt str
 308 The flag for the
 309 .Xr sup 1
 310 command when doing
 311 .Dq Li "make update" .
 312 This defaults to
 313 .Op Fl g L Ar 2 .
 314 .It Va SUPHOST
 315 .Pq Vt str
 316 The hostname of the sup server to use when doing
 317 .Dq Li "make update" .
 318 .It Va SUP_UPDATE
 319 .Pq Vt bool
 320 Set this to use
 321 .Xr cvsup 1
 322 to update your
 323 .Pa src , ports , doc
 324 and
 325 .Pa www
 326 trees with
 327 .Dq Li "make update" .
 328 .It Va SVN_UPDATE
 329 .Pq Vt bool
 330 Set this to use
 331 .Xr svn 1
 332 to update your
 333 .Pa src
 334 tree with
 335 .Dq Li "make update" .
 336 .It Va WWWSUPFILE
 337 .Pq Vt str
 338 The www
 339 .Ar supfile
 340 to use when doing a
 341 .Dq Li "make update" .
 342 For example,
 343 .Pa /usr/share/examples/cvsup/www-supfile .
 344 .El
 345 .Ss "BUILDING THE KERNEL"
 346 The following list provides a name and short description for variables
 347 that are only used doing a kernel build:
 348 .Bl -tag -width Ar
 349 .It Va BOOTWAIT
 350 .Pq Vt int
 351 Controls the amount of time the kernel waits for a console keypress
 352 before booting the default kernel.
 353 The value is approximately milliseconds.
 354 Keypresses are accepted by the BIOS before booting from disk,
 355 making it possible to give custom boot parameters even when this is
 356 set to 0.
 357 .It Va COPTFLAGS
 358 .Pq Vt str
 359 Controls the compiler settings when building the
 360 kernel.
 361 Optimization levels above
 362 .Oo Fl O ( O2 , No ...\& ) Oc
 363 are not guaranteed to work.
 364 .It Va KERNCONF
 365 .Pq Vt str
 366 Controls which kernel configurations will be
 367 built by
 368 .Dq Li "${MAKE} buildkernel"
 369 and installed by
 370 .Dq Li "${MAKE} installkernel" .
 371 For example,
 372 .Bd -literal -offset indent
 373 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
 374 .Ed
 375 .Pp
 376 will build the kernels specified by the config files
 377 .Pa MINE , DEBUG , GENERIC ,
 378 and
 379 .Pa OTHERMACHINE ,
 380 and install the kernel specified by the config file
 381 .Pa MINE .
 382 It defaults to
 383 .Pa GENERIC .
 384 .It Va MODULES_OVERRIDE
 385 .Pq Vt str
 386 Set to a list of modules to build instead of all of them.
 387 .It Va NO_KERNELCLEAN
 388 .Pq Vt bool
 389 Set this to skip running
 390 .Dq Li "${MAKE} clean"
 391 during
 392 .Dq Li "${MAKE} buildkernel" .
 393 .It Va NO_KERNELCONFIG
 394 .Pq Vt bool
 395 Set this to skip running
 396 .Xr config 8
 397 during
 398 .Dq Li "${MAKE} buildkernel" .
 399 .It Va NO_KERNELDEPEND
 400 .Pq Vt bool
 401 Set this to skip running
 402 .Dq Li "${MAKE} depend"
 403 during
 404 .Dq Li "${MAKE} buildkernel" .
 405 .It Va NO_KERNELOBJ
 406 .Pq Vt bool
 407 Set this to skip running
 408 .Dq Li "${MAKE} obj"
 409 during
 410 .Dq Li "${MAKE} buildkernel" .
 411 .It Va NO_MODULES
 412 .Pq Vt bool
 413 Set to not build modules with the kernel.
 414 .It Va PORTS_MODULES
 415 Set this to the list of ports you wish to rebuild every time the kernel
 416 is built.
 417 .It Va WITHOUT_MODULES
 418 .Pq Vt str
 419 Set to a list of modules to exclude from the build.
 420 This provides a
 421 somewhat easier way to exclude modules you are certain you will never
 422 need than specifying
 423 .Va MODULES_OVERRIDE .
 424 This is applied
 425 .Em after
 426 .Va MODULES_OVERRIDE .
 427 .El
 428 .Ss "BUILDING THE WORLD"
 429 The following list provides a name and short description for variables
 430 that are used during the world build:
 431 .Bl -tag -width Ar
 432 .It Va BOOT_COMCONSOLE_PORT
 433 .Pq Vt str
 434 The port address to use for the console if the boot blocks have
 435 been configured to use a serial console instead of the keyboard/video card.
 436 .It Va BOOT_COMCONSOLE_SPEED
 437 .Pq Vt int
 438 The baud rate to use for the console if the boot blocks have
 439 been configured to use a serial console instead of the keyboard/video card.
 440 .It Va BOOT_PXELDR_ALWAYS_SERIAL
 441 .Pq Vt bool
 442 Compile in the code into
 443 .Xr pxeboot 8
 444 that forces the use of a serial console.
 445 This is analogous to the
 446 .Fl h
 447 option in
 448 .Xr boot 8
 449 blocks.
 450 .It Va BOOT_PXELDR_PROBE_KEYBOARD
 451 .Pq Vt bool
 452 Compile in the code into
 453 .Xr pxeboot 8
 454 that probes the keyboard.
 455 If no keyboard is found, boot with the dual console configuration.
 456 This is analogous to the
 457 .Fl D
 458 option in
 459 .Xr boot 8
 460 blocks.
 461 .It Va ENABLE_SUID_K5SU
 462 .Pq Vt bool
 463 Set this if you wish to use the ksu utility.
 464 Otherwise, it will be
 465 installed without the set-user-ID bit set.
 466 .It Va ENABLE_SUID_NEWGRP
 467 .Pq Vt bool
 468 Set this to install
 469 .Xr newgrp 1
 470 with the set-user-ID bit set.
 471 Otherwise,
 472 .Xr newgrp 1
 473 will not be able to change users' groups.
 474 .It Va ENABLE_SUID_SSH
 475 .Pq Vt bool
 476 Set this to install
 477 .Xr ssh 1
 478 with the set-user-ID bit turned on.
 479 .It Va LOADER_TFTP_SUPPORT
 480 .Pq Vt bool
 481 By default the
 482 .Xr pxeboot 8
 483 loader retrieves the kernel via NFS.
 484 Defining this and recompiling
 485 .Pa /usr/src/sys/boot
 486 will cause it to retrieve the kernel via TFTP.
 487 This allows
 488 .Xr pxeboot 8
 489 to load a custom BOOTP diskless kernel yet
 490 still mount the server's
 491 .Pa /
 492 rather than load the server's kernel.
 493 .It Va LOADER_FIREWIRE_SUPPORT
 494 .Pq Vt bool
 495 Defining this and recompiling
 496 .Pa /usr/src/sys/boot/i386
 497 will add
 498 .Xr dcons 4
 499 console driver to
 500 .Xr loader 8
 501 and allow access over FireWire(IEEE1394) using
 502 .Xr dconschat 8 .
 503 Currently, only i386 and amd64 are supported.
 504 .It Va MALLOC_PRODUCTION
 505 .Pq Vt bool
 506 Set this to disable assertions and statistics gathering in
 507 .Xr malloc 3 .
 508 It also defaults the A and J runtime options to off.
 509 Disabled by default on -CURRENT.
 510 .It Va MODULES_WITH_WORLD
 511 .Pq Vt bool
 512 Set to build modules with the system instead of the kernel.
 513 .It Va NO_CLEAN
 514 .Pq Vt bool
 515 Set this to disable cleaning during
 516 .Dq Li "make buildworld" .
 517 This should not be set unless you know what you are doing.
 518 .It Va NO_CLEANDIR
 519 .Pq Vt bool
 520 Set this to run
 521 .Dq Li "${MAKE} clean"
 522 instead of
 523 .Dq Li "${MAKE} cleandir" .
 524 .It Va NO_MANCOMPRESS
 525 .Pq Vt bool
 526 Set to install manual pages uncompressed.
 527 .It Va NO_SHARE
 528 .Pq Vt bool
 529 Set to not build in the
 530 .Pa share
 531 subdir.
 532 .It Va NO_SHARED
 533 .Pq Vt bool
 534 Set to build
 535 .Pa /bin
 536 and
 537 .Pa /sbin
 538 statically linked, this can be bad.
 539 If set, every utility that uses
 540 .Pa bsd.prog.mk
 541 will be linked statically.
 542 .It Va PPP_NO_NAT
 543 .Pq Vt bool
 544 Build
 545 .Xr ppp 8
 546 without support for network address translation (NAT).
 547 .It Va PPP_NO_NETGRAPH
 548 .Pq Vt bool
 549 Set to build
 550 .Xr ppp 8
 551 without support for Netgraph.
 552 .It Va PPP_NO_RADIUS
 553 .Pq Vt bool
 554 Set to build
 555 .Xr ppp 8
 556 without support for RADIUS.
 557 .It Va PPP_NO_SUID
 558 .Pq Vt bool
 559 Set to disable the installation of
 560 .Xr ppp 8
 561 as a set-user-ID root program.
 562 .It Va SENDMAIL_ADDITIONAL_MC
 563 .Pq Vt str
 564 Additional
 565 .Pa .mc
 566 files which should be built into
 567 .Pa .cf
 568 files at build time.
 569 The value should include the full path to the
 570 .Pa .mc
 571 file(s), e.g.,
 572 .Pa /etc/mail/foo.mc
 573 .Pa /etc/mail/bar.mc .
 574 .It Va SENDMAIL_ALIASES
 575 .Pq Vt str
 576 List of
 577 .Xr aliases 5
 578 files to rebuild when using
 579 .Pa /etc/mail/Makefile .
 580 The default value is
 581 .Pa /etc/mail/aliases .
 582 .It Va SENDMAIL_CFLAGS
 583 .Pq Vt str
 584 Flags to pass to the compile command when building
 585 .Xr sendmail 8 .
 586 The
 587 .Va SENDMAIL_*
 588 flags can be used to provide SASL support with setting such as:
 589 .Bd -literal -offset indent
 590 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 591 SENDMAIL_LDFLAGS=-L/usr/local/lib
 592 SENDMAIL_LDADD=-lsasl
 593 .Ed
 594 .It Va SENDMAIL_CF_DIR
 595 .Pq Vt str
 596 Override the default location for the
 597 .Xr m4 1
 598 configuration files used to build a
 599 .Pa .cf
 600 file from a
 601 .Pa .mc
 602 file.
 603 .It Va SENDMAIL_DPADD
 604 .Pq Vt str
 605 Extra dependencies to add when building
 606 .Xr sendmail 8 .
 607 .It Va SENDMAIL_LDADD
 608 .Pq Vt str
 609 Flags to add to the end of the
 610 .Xr ld 1
 611 command when building
 612 .Xr sendmail 8 .
 613 .It Va SENDMAIL_LDFLAGS
 614 .Pq Vt str
 615 Flags to pass to the
 616 .Xr ld 1
 617 command when building
 618 .Xr sendmail 8 .
 619 .It Va SENDMAIL_M4_FLAGS
 620 .Pq Vt str
 621 Flags passed to
 622 .Xr m4 1
 623 when building a
 624 .Pa .cf
 625 file from a
 626 .Pa .mc
 627 file.
 628 .It Va SENDMAIL_MAP_PERMS
 629 .Pq Vt str
 630 Mode to use when generating alias and map database files using
 631 .Pa /etc/mail/Makefile .
 632 The default value is 0640.
 633 .It Va SENDMAIL_MAP_SRC
 634 .Pq Vt str
 635 Additional maps to rebuild when using
 636 .Pa /etc/mail/Makefile .
 637 The
 638 .Pa access ,
 639 .Pa bitdomain ,
 640 .Pa domaintable ,
 641 .Pa genericstable ,
 642 .Pa mailertable ,
 643 .Pa uucpdomain ,
 644 and
 645 .Pa virtusertable
 646 maps are always rebuilt if they exist.
 647 .It Va SENDMAIL_MAP_TYPE
 648 .Pq Vt str
 649 Database map type to use when generating map database files using
 650 .Pa /etc/mail/Makefile .
 651 The default value is hash.
 652 The alternative is btree.
 653 .It Va SENDMAIL_MC
 654 .Pq Vt str
 655 The default
 656 .Xr m4 1
 657 configuration file to use at install time.
 658 The value should include the full path to the
 659 .Pa .mc
 660 file, e.g.,
 661 .Pa /etc/mail/myconfig.mc .
 662 Use with caution as a make install will overwrite any existing
 663 .Pa /etc/mail/sendmail.cf .
 664 Note that
 665 .Va SENDMAIL_CF
 666 is now deprecated.
 667 .It Va SENDMAIL_SET_USER_ID
 668 .Pq Vt bool
 669 If set, install
 670 .Xr sendmail 8
 671 as a set-user-ID root binary instead of a set-group-ID binary
 672 and do not install
 673 .Pa /etc/mail/submit.{cf,mc} .
 674 Use of this flag is not recommended and the alternative advice in
 675 .Pa /etc/mail/README
 676 should be followed instead if at all possible.
 677 .It Va SENDMAIL_START_SCRIPT
 678 .Pq Vt str
 679 The script used by
 680 .Pa /etc/mail/Makefile
 681 to start, stop, and restart
 682 .Xr sendmail 8 .
 683 The default value is
 684 .Pa /etc/rc.sendmail .
 685 This value should match the
 686 .Dq Li mta_start_script
 687 setting in
 688 .Xr rc.conf 5 .
 689 .It Va SENDMAIL_SUBMIT_MC
 690 .Pq Vt str
 691 The default
 692 .Xr m4 1
 693 configuration file for mail submission
 694 to use at install time.
 695 The value should include the full path to the
 696 .Pa .mc
 697 file, e.g.,
 698 .Pa /etc/mail/mysubmit.mc .
 699 Use with caution as a make install will overwrite any existing
 700 .Pa /etc/mail/submit.cf .
 701 .It Va TOP_TABLE_SIZE
 702 .Pq Vt int
 703 .Xr top 1
 704 uses a hash table for the user names.
 705 The size of this hash can be tuned to match the number of local users.
 706 The table size should be a prime number
 707 approximately twice as large as the number of lines in
 708 .Pa /etc/passwd .
 709 The default number is 20011.
 710 .It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
 711 .Pq Vt int
 712 Causes the system compiler to be built such that it forces high optimization
 713 levels to a lower one.
 714 .Xr gcc 1
 715 .Fl O2
 716 and above is known to trigger known optimizer bugs at various
 717 times.
 718 The value assigned is the highest optimization value used.
 719 .El
 720 .Ss "BUILDING DOCUMENTATION"
 721 The following list provides a name and short description for variables
 722 that are used when building documentation.
 723 .Bl -tag -width ".Va PRINTERDEVICE"
 724 .It Va DISTDIR
 725 .Pq Vt str
 726 Where distfiles are kept.
 727 Normally, this is
 728 .Pa distfiles
 729 in
 730 .Va PORTSDIR .
 731 .It Va DOC_LANG
 732 .Pq Vt str
 733 The list of languages and encodings to build and install.
 734 .It Va PRINTERDEVICE
 735 .Pq Vt str
 736 The default format for system documentation, depends on your
 737 printer.
 738 This can be set to
 739 .Dq Li ascii
 740 for simple printers, or
 741 .Dq Li ps
 742 for postscript or graphics printers with a ghostscript
 743 filter, or both.
 744 .El
 745 .Sh FILES
 746 .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
 747 .It Pa /etc/make.conf
 748 .It Pa /usr/doc/Makefile
 749 .It Pa /usr/ports/Makefile
 750 .It Pa /usr/share/examples/etc/make.conf
 751 .It Pa /usr/share/mk/sys.mk
 752 .It Pa /usr/src/Makefile
 753 .It Pa /usr/src/Makefile.inc1
 754 .El
 755 .Sh SEE ALSO
 756 .Xr gcc 1 ,
 757 .Xr install 1 ,
 758 .Xr make 1 ,
 759 .Xr src.conf 5 ,
 760 .Xr environ 7 ,
 761 .Xr ports 7 ,
 762 .Xr sendmail 8
 763 .Sh HISTORY
 764 The
 765 .Nm
 766 file appeared sometime before
 767 .Fx 4.0 .
 768 .Sh AUTHORS
 769 This
 770 manual page was written by
 771 .An Mike W. Meyer Aq mwm@mired.org .
 772 .Sh CAVEATS
 773 Note, that
 774 .Ev MAKEOBJDIRPREFIX
 775 and
 776 .Ev MAKEOBJDIR
 777 are environment variables and should not be set in
 778 .Nm
 779 but in make's environment.
 780 .Sh BUGS
 781 This manual page may occasionally be out of date with respect to
 782 the options currently available for use in
 783 .Nm .
 784 Please check the
 785 .Pa /usr/share/examples/etc/make.conf
 786 file for the latest options which are available.