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 December 11, 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 Note that since a subversion client is not included in the base system,
 337 you will need to set
 338 .Va SVN
 339 to the full path of a
 340 .Xr svn 1
 341 binary.
 342 .It Va WWWSUPFILE
 343 .Pq Vt str
 344 The www
 345 .Ar supfile
 346 to use when doing a
 347 .Dq Li "make update" .
 348 For example,
 349 .Pa /usr/share/examples/cvsup/www-supfile .
 350 .El
 351 .Ss "BUILDING THE KERNEL"
 352 The following list provides a name and short description for variables
 353 that are only used doing a kernel build:
 354 .Bl -tag -width Ar
 355 .It Va BOOTWAIT
 356 .Pq Vt int
 357 Controls the amount of time the kernel waits for a console keypress
 358 before booting the default kernel.
 359 The value is approximately milliseconds.
 360 Keypresses are accepted by the BIOS before booting from disk,
 361 making it possible to give custom boot parameters even when this is
 362 set to 0.
 363 .It Va COPTFLAGS
 364 .Pq Vt str
 365 Controls the compiler settings when building the
 366 kernel.
 367 Optimization levels above
 368 .Oo Fl O ( O2 , No ...\& ) Oc
 369 are not guaranteed to work.
 370 .It Va KERNCONF
 371 .Pq Vt str
 372 Controls which kernel configurations will be
 373 built by
 374 .Dq Li "${MAKE} buildkernel"
 375 and installed by
 376 .Dq Li "${MAKE} installkernel" .
 377 For example,
 378 .Bd -literal -offset indent
 379 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
 380 .Ed
 381 .Pp
 382 will build the kernels specified by the config files
 383 .Pa MINE , DEBUG , GENERIC ,
 384 and
 385 .Pa OTHERMACHINE ,
 386 and install the kernel specified by the config file
 387 .Pa MINE .
 388 It defaults to
 389 .Pa GENERIC .
 390 .It Va MODULES_OVERRIDE
 391 .Pq Vt str
 392 Set to a list of modules to build instead of all of them.
 393 .It Va NO_KERNELCLEAN
 394 .Pq Vt bool
 395 Set this to skip running
 396 .Dq Li "${MAKE} clean"
 397 during
 398 .Dq Li "${MAKE} buildkernel" .
 399 .It Va NO_KERNELCONFIG
 400 .Pq Vt bool
 401 Set this to skip running
 402 .Xr config 8
 403 during
 404 .Dq Li "${MAKE} buildkernel" .
 405 .It Va NO_KERNELDEPEND
 406 .Pq Vt bool
 407 Set this to skip running
 408 .Dq Li "${MAKE} depend"
 409 during
 410 .Dq Li "${MAKE} buildkernel" .
 411 .It Va NO_KERNELOBJ
 412 .Pq Vt bool
 413 Set this to skip running
 414 .Dq Li "${MAKE} obj"
 415 during
 416 .Dq Li "${MAKE} buildkernel" .
 417 .It Va NO_MODULES
 418 .Pq Vt bool
 419 Set to not build modules with the kernel.
 420 .It Va PORTS_MODULES
 421 Set this to the list of ports you wish to rebuild every time the kernel
 422 is built.
 423 .It Va WITHOUT_MODULES
 424 .Pq Vt str
 425 Set to a list of modules to exclude from the build.
 426 This provides a
 427 somewhat easier way to exclude modules you are certain you will never
 428 need than specifying
 429 .Va MODULES_OVERRIDE .
 430 This is applied
 431 .Em after
 432 .Va MODULES_OVERRIDE .
 433 .El
 434 .Ss "BUILDING THE WORLD"
 435 The following list provides a name and short description for variables
 436 that are used during the world build:
 437 .Bl -tag -width Ar
 438 .It Va BOOT_COMCONSOLE_PORT
 439 .Pq Vt str
 440 The port address to use for the console if the boot blocks have
 441 been configured to use a serial console instead of the keyboard/video card.
 442 .It Va BOOT_COMCONSOLE_SPEED
 443 .Pq Vt int
 444 The baud rate to use for the console if the boot blocks have
 445 been configured to use a serial console instead of the keyboard/video card.
 446 .It Va BOOT_PXELDR_ALWAYS_SERIAL
 447 .Pq Vt bool
 448 Compile in the code into
 449 .Xr pxeboot 8
 450 that forces the use of a serial console.
 451 This is analogous to the
 452 .Fl h
 453 option in
 454 .Xr boot 8
 455 blocks.
 456 .It Va BOOT_PXELDR_PROBE_KEYBOARD
 457 .Pq Vt bool
 458 Compile in the code into
 459 .Xr pxeboot 8
 460 that probes the keyboard.
 461 If no keyboard is found, boot with the dual console configuration.
 462 This is analogous to the
 463 .Fl D
 464 option in
 465 .Xr boot 8
 466 blocks.
 467 .It Va ENABLE_SUID_K5SU
 468 .Pq Vt bool
 469 Set this if you wish to use the ksu utility.
 470 Otherwise, it will be
 471 installed without the set-user-ID bit set.
 472 .It Va ENABLE_SUID_NEWGRP
 473 .Pq Vt bool
 474 Set this to install
 475 .Xr newgrp 1
 476 with the set-user-ID bit set.
 477 Otherwise,
 478 .Xr newgrp 1
 479 will not be able to change users' groups.
 480 .It Va ENABLE_SUID_SSH
 481 .Pq Vt bool
 482 Set this to install
 483 .Xr ssh 1
 484 with the set-user-ID bit turned on.
 485 .It Va LOADER_TFTP_SUPPORT
 486 .Pq Vt bool
 487 By default the
 488 .Xr pxeboot 8
 489 loader retrieves the kernel via NFS.
 490 Defining this and recompiling
 491 .Pa /usr/src/sys/boot
 492 will cause it to retrieve the kernel via TFTP.
 493 This allows
 494 .Xr pxeboot 8
 495 to load a custom BOOTP diskless kernel yet
 496 still mount the server's
 497 .Pa /
 498 rather than load the server's kernel.
 499 .It Va LOADER_FIREWIRE_SUPPORT
 500 .Pq Vt bool
 501 Defining this and recompiling
 502 .Pa /usr/src/sys/boot/i386
 503 will add
 504 .Xr dcons 4
 505 console driver to
 506 .Xr loader 8
 507 and allow access over FireWire(IEEE1394) using
 508 .Xr dconschat 8 .
 509 Currently, only i386 and amd64 are supported.
 510 .It Va MALLOC_PRODUCTION
 511 .Pq Vt bool
 512 Set this to disable assertions and statistics gathering in
 513 .Xr malloc 3 .
 514 It also defaults the A and J runtime options to off.
 515 Disabled by default on -CURRENT.
 516 .It Va MODULES_WITH_WORLD
 517 .Pq Vt bool
 518 Set to build modules with the system instead of the kernel.
 519 .It Va NO_CLEAN
 520 .Pq Vt bool
 521 Set this to disable cleaning during
 522 .Dq Li "make buildworld" .
 523 This should not be set unless you know what you are doing.
 524 .It Va NO_CLEANDIR
 525 .Pq Vt bool
 526 Set this to run
 527 .Dq Li "${MAKE} clean"
 528 instead of
 529 .Dq Li "${MAKE} cleandir" .
 530 .It Va NO_MANCOMPRESS
 531 .Pq Vt bool
 532 Set to install manual pages uncompressed.
 533 .It Va NO_SHARE
 534 .Pq Vt bool
 535 Set to not build in the
 536 .Pa share
 537 subdir.
 538 .It Va NO_SHARED
 539 .Pq Vt bool
 540 Set to build
 541 .Pa /bin
 542 and
 543 .Pa /sbin
 544 statically linked, this can be bad.
 545 If set, every utility that uses
 546 .Pa bsd.prog.mk
 547 will be linked statically.
 548 .It Va PPP_NO_NAT
 549 .Pq Vt bool
 550 Build
 551 .Xr ppp 8
 552 without support for network address translation (NAT).
 553 .It Va PPP_NO_NETGRAPH
 554 .Pq Vt bool
 555 Set to build
 556 .Xr ppp 8
 557 without support for Netgraph.
 558 .It Va PPP_NO_RADIUS
 559 .Pq Vt bool
 560 Set to build
 561 .Xr ppp 8
 562 without support for RADIUS.
 563 .It Va PPP_NO_SUID
 564 .Pq Vt bool
 565 Set to disable the installation of
 566 .Xr ppp 8
 567 as a set-user-ID root program.
 568 .It Va SENDMAIL_ADDITIONAL_MC
 569 .Pq Vt str
 570 Additional
 571 .Pa .mc
 572 files which should be built into
 573 .Pa .cf
 574 files at build time.
 575 The value should include the full path to the
 576 .Pa .mc
 577 file(s), e.g.,
 578 .Pa /etc/mail/foo.mc
 579 .Pa /etc/mail/bar.mc .
 580 .It Va SENDMAIL_ALIASES
 581 .Pq Vt str
 582 List of
 583 .Xr aliases 5
 584 files to rebuild when using
 585 .Pa /etc/mail/Makefile .
 586 The default value is
 587 .Pa /etc/mail/aliases .
 588 .It Va SENDMAIL_CFLAGS
 589 .Pq Vt str
 590 Flags to pass to the compile command when building
 591 .Xr sendmail 8 .
 592 The
 593 .Va SENDMAIL_*
 594 flags can be used to provide SASL support with setting such as:
 595 .Bd -literal -offset indent
 596 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 597 SENDMAIL_LDFLAGS=-L/usr/local/lib
 598 SENDMAIL_LDADD=-lsasl
 599 .Ed
 600 .It Va SENDMAIL_CF_DIR
 601 .Pq Vt str
 602 Override the default location for the
 603 .Xr m4 1
 604 configuration files used to build a
 605 .Pa .cf
 606 file from a
 607 .Pa .mc
 608 file.
 609 .It Va SENDMAIL_DPADD
 610 .Pq Vt str
 611 Extra dependencies to add when building
 612 .Xr sendmail 8 .
 613 .It Va SENDMAIL_LDADD
 614 .Pq Vt str
 615 Flags to add to the end of the
 616 .Xr ld 1
 617 command when building
 618 .Xr sendmail 8 .
 619 .It Va SENDMAIL_LDFLAGS
 620 .Pq Vt str
 621 Flags to pass to the
 622 .Xr ld 1
 623 command when building
 624 .Xr sendmail 8 .
 625 .It Va SENDMAIL_M4_FLAGS
 626 .Pq Vt str
 627 Flags passed to
 628 .Xr m4 1
 629 when building a
 630 .Pa .cf
 631 file from a
 632 .Pa .mc
 633 file.
 634 .It Va SENDMAIL_MAP_PERMS
 635 .Pq Vt str
 636 Mode to use when generating alias and map database files using
 637 .Pa /etc/mail/Makefile .
 638 The default value is 0640.
 639 .It Va SENDMAIL_MAP_SRC
 640 .Pq Vt str
 641 Additional maps to rebuild when using
 642 .Pa /etc/mail/Makefile .
 643 The
 644 .Pa access ,
 645 .Pa bitdomain ,
 646 .Pa domaintable ,
 647 .Pa genericstable ,
 648 .Pa mailertable ,
 649 .Pa uucpdomain ,
 650 and
 651 .Pa virtusertable
 652 maps are always rebuilt if they exist.
 653 .It Va SENDMAIL_MAP_TYPE
 654 .Pq Vt str
 655 Database map type to use when generating map database files using
 656 .Pa /etc/mail/Makefile .
 657 The default value is hash.
 658 The alternative is btree.
 659 .It Va SENDMAIL_MC
 660 .Pq Vt str
 661 The default
 662 .Xr m4 1
 663 configuration file to use at install time.
 664 The value should include the full path to the
 665 .Pa .mc
 666 file, e.g.,
 667 .Pa /etc/mail/myconfig.mc .
 668 Use with caution as a make install will overwrite any existing
 669 .Pa /etc/mail/sendmail.cf .
 670 Note that
 671 .Va SENDMAIL_CF
 672 is now deprecated.
 673 .It Va SENDMAIL_SET_USER_ID
 674 .Pq Vt bool
 675 If set, install
 676 .Xr sendmail 8
 677 as a set-user-ID root binary instead of a set-group-ID binary
 678 and do not install
 679 .Pa /etc/mail/submit.{cf,mc} .
 680 Use of this flag is not recommended and the alternative advice in
 681 .Pa /etc/mail/README
 682 should be followed instead if at all possible.
 683 .It Va SENDMAIL_START_SCRIPT
 684 .Pq Vt str
 685 The script used by
 686 .Pa /etc/mail/Makefile
 687 to start, stop, and restart
 688 .Xr sendmail 8 .
 689 The default value is
 690 .Pa /etc/rc.sendmail .
 691 This value should match the
 692 .Dq Li mta_start_script
 693 setting in
 694 .Xr rc.conf 5 .
 695 .It Va SENDMAIL_SUBMIT_MC
 696 .Pq Vt str
 697 The default
 698 .Xr m4 1
 699 configuration file for mail submission
 700 to use at install time.
 701 The value should include the full path to the
 702 .Pa .mc
 703 file, e.g.,
 704 .Pa /etc/mail/mysubmit.mc .
 705 Use with caution as a make install will overwrite any existing
 706 .Pa /etc/mail/submit.cf .
 707 .It Va TOP_TABLE_SIZE
 708 .Pq Vt int
 709 .Xr top 1
 710 uses a hash table for the user names.
 711 The size of this hash can be tuned to match the number of local users.
 712 The table size should be a prime number
 713 approximately twice as large as the number of lines in
 714 .Pa /etc/passwd .
 715 The default number is 20011.
 716 .It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
 717 .Pq Vt int
 718 Causes the system compiler to be built such that it forces high optimization
 719 levels to a lower one.
 720 .Xr gcc 1
 721 .Fl O2
 722 and above is known to trigger known optimizer bugs at various
 723 times.
 724 The value assigned is the highest optimization value used.
 725 .El
 726 .Ss "BUILDING DOCUMENTATION"
 727 The following list provides a name and short description for variables
 728 that are used when building documentation.
 729 .Bl -tag -width ".Va PRINTERDEVICE"
 730 .It Va DISTDIR
 731 .Pq Vt str
 732 Where distfiles are kept.
 733 Normally, this is
 734 .Pa distfiles
 735 in
 736 .Va PORTSDIR .
 737 .It Va DOC_LANG
 738 .Pq Vt str
 739 The list of languages and encodings to build and install.
 740 .It Va PRINTERDEVICE
 741 .Pq Vt str
 742 The default format for system documentation, depends on your
 743 printer.
 744 This can be set to
 745 .Dq Li ascii
 746 for simple printers, or
 747 .Dq Li ps
 748 for postscript or graphics printers with a ghostscript
 749 filter, or both.
 750 .El
 751 .Sh FILES
 752 .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
 753 .It Pa /etc/make.conf
 754 .It Pa /usr/doc/Makefile
 755 .It Pa /usr/ports/Makefile
 756 .It Pa /usr/share/examples/etc/make.conf
 757 .It Pa /usr/share/mk/sys.mk
 758 .It Pa /usr/src/Makefile
 759 .It Pa /usr/src/Makefile.inc1
 760 .El
 761 .Sh SEE ALSO
 762 .Xr gcc 1 ,
 763 .Xr install 1 ,
 764 .Xr make 1 ,
 765 .Xr src.conf 5 ,
 766 .Xr environ 7 ,
 767 .Xr ports 7 ,
 768 .Xr sendmail 8
 769 .Sh HISTORY
 770 The
 771 .Nm
 772 file appeared sometime before
 773 .Fx 4.0 .
 774 .Sh AUTHORS
 775 This
 776 manual page was written by
 777 .An Mike W. Meyer Aq mwm@mired.org .
 778 .Sh CAVEATS
 779 Note, that
 780 .Ev MAKEOBJDIRPREFIX
 781 and
 782 .Ev MAKEOBJDIR
 783 are environment variables and should not be set in
 784 .Nm
 785 but in make's environment.
 786 .Sh BUGS
 787 This manual page may occasionally be out of date with respect to
 788 the options currently available for use in
 789 .Nm .
 790 Please check the
 791 .Pa /usr/share/examples/etc/make.conf
 792 file for the latest options which are available.