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 September 27, 2004
  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 settings that control the compilation of the
  37 .Fx
  38 sources
  39 and ported applications.
  40 The file
  41 .Nm
  42 is generally created by the system administrator when the values need
  43 to be changed from their defaults.
  44 .Pp
  45 The purpose of
  46 .Nm
  47 is not to run commands or perform compilation actions
  48 directly.
  49 Instead, it is included by the
  50 various makefiles in
  51 .Pa /usr/src ,
  52 .Pa /usr/ports
  53 and
  54 .Pa /usr/doc
  55 which conditionalize their
  56 internal actions according to the settings found there.
  57 .Pp
  58 The
  59 .Pa /etc/make.conf
  60 file is included from the appropriate
  61 .Pa Makefile
  62 which specifies the default settings for all the available options.
  63 Options need only be specified in
  64 .Pa /etc/make.conf
  65 when the system administrator wishes to override these defaults.
  66 .Pp
  67 The build procedures occur in four broad areas: the world, the kernel,
  68 documentations and ports.
  69 Variables set in
  70 .Nm
  71 may be applicable during builds in one, two, or all four of these
  72 areas.
  73 They may be specified for a particular build via the
  74 .Fl D
  75 option of
  76 .Xr make 1 .
  77 .Pp
  78 The following lists provide a name and short description for each
  79 variable you can use during the indicated builds.
  80 The values of
  81 variables flagged as
  82 .Vt bool
  83 are ignored; the variable being
  84 set at all (even to
  85 .Dq Li FALSE
  86 or
  87 .Dq Li NO )
  88 causes it to
  89 be treated as if it were set.
  90 .Pp
  91 The following list provides a name and short description for variables
  92 that are used for all builds, or are used by the
  93 .Pa makefiles
  94 for things other than builds.
  95 .Bl -tag -width Ar
  96 .It Va ALWAYS_CHECK_MAKE
  97 .Pq Vt bool
  98 Instructs the top-level makefile in the source tree (normally
  99 .Pa /usr/src )
 100 to always check if
 101 .Xr make 1
 102 is up-to-date.
 103 Normally this is only done for the world and buildworld targets to handle
 104 upgrades from older versions of
 105 .Fx .
 106 .It Va CFLAGS
 107 .Pq Vt str
 108 Controls the compiler setting when compiling C code.
 109 Optimization levels other than
 110 .Fl O
 111 and
 112 .Fl O2
 113 are not supported.
 114 .Va BDECFLAGS
 115 is provided as a set of
 116 .Xr gcc 1
 117 settings suggested by
 118 .An "Bruce Evans" Aq bde@FreeBSD.org
 119 for developing and testing changes.
 120 They can be used, if set, by:
 121 .Pp
 122 .Bd -literal -offset indent
 123 CFLAGS+=${BDECFLAGS}
 124 .Ed
 125 .It Va CPUTYPE
 126 .Pq Vt str
 127 Controls which processor should be targeted for generated
 128 code.
 129 This controls processor-specific optimizations in
 130 certain code (currently only OpenSSL) as well as modifying
 131 the value of
 132 .Va CFLAGS
 133 and
 134 .Va COPTFLAGS
 135 to contain the appropriate optimization directive to
 136 .Xr gcc 1 .
 137 The automatic setting of
 138 .Va CFLAGS
 139 and
 140 .Va COPTFLAGS
 141 may be overridden using the
 142 .Va NO_CPU_CFLAGS
 143 and
 144 .Va NO_CPU_COPTFLAGS
 145 variables, respectively.
 146 Refer to
 147 .Pa /usr/share/examples/etc/make.conf
 148 for a list of recognized
 149 .Va CPUTYPE
 150 options.
 151 .It Va NO_CPU_CFLAGS
 152 .Pq Vt str
 153 Setting this variable will prevent CPU specific compiler flags
 154 from being automatically added to
 155 .Va CFLAGS
 156 during compile time.
 157 .It Va NO_CPU_COPTFLAGS
 158 .Pq Vt str
 159 Setting this variable will prevent CPU specific compiler flags
 160 from being automatically added to
 161 .Va COPTFLAGS
 162 during compile time.
 163 .It Va CVS_UPDATE
 164 .Pq Vt bool
 165 Set this to use
 166 .Xr cvs 1
 167 to update your ports with
 168 .Dq Li "make update" .
 169 .It Va CXXFLAGS
 170 .Pq Vt str
 171 Controls the compiler settings when compiling C++ code.
 172 .Va CXXFLAGS
 173 is initially set to the value of
 174 .Va CFLAGS .
 175 If you want to
 176 add to the
 177 .Va CXXFLAGS
 178 value, use
 179 .Dq Li +=
 180 instead of
 181 .Dq Li = .
 182 .It Va INSTALL
 183 .Pq Vt str
 184 the default install command.
 185 To install only files for which the target differs or does not exist, use
 186 .Bd -literal -offset indent
 187 INSTALL="install -C"
 188 .Ed
 189 Note that some makefiles (including those in
 190 .Pa /usr/share/mk )
 191 may hardcode options for the supplied install command.
 192 .It Va LOCAL_DIRS
 193 .Pq Vt str
 194 List any directories that should be entered when doing
 195 make's in
 196 .Pa /usr/src
 197 in this variable.
 198 .It Va MAKE_SHELL
 199 .Pq Vt str
 200 Controls the shell used internally by
 201 .Xr make 1
 202 to process the command scripts in makefiles.
 203 .Xr sh 1 ,
 204 .Xr ksh 1 ,
 205 and
 206 .Xr csh 1
 207 all currently supported.
 208 .Pp
 209 .Dl "MAKE_SHELL?=sh"
 210 .It Va MTREE_FOLLOWS_SYMLINKS
 211 .Pq Vt str
 212 Set this to
 213 .Dq Fl L
 214 to cause
 215 .Xr mtree 8
 216 to follow symlinks.
 217 .It Va NO_DOCUPDATE
 218 .Pq Vt bool
 219 Set this to not update the doc tree during
 220 .Dq Li "make update" .
 221 .It Va NO_PORTSUPDATE
 222 .Pq Vt bool
 223 Set this to not update the ports tree during
 224 .Dq Li "make update" .
 225 .It Va SUP_UPDATE
 226 .Pq Vt bool
 227 Set this to use
 228 .Xr cvsup 1
 229 to update your ports with
 230 .Dq Li "make update" .
 231 .It Va SUP
 232 .Pq Vt str
 233 The location of the
 234 .Xr cvsup 1
 235 command for
 236 .Dq Li "make update" .
 237 .It Va SUPFLAGS
 238 .Pq Vt str
 239 The flag for the
 240 .Xr sup 1
 241 command when doing
 242 .Dq Li "make update" .
 243 This defaults to
 244 .Op Fl g L Ar 2 .
 245 .It Va SUPHOST
 246 .Pq Vt str
 247 The hostname of the sup server to use when doing
 248 .Dq Li "make update" .
 249 .It Va SUPFILE
 250 .Pq Vt str
 251 The first
 252 .Ar supfile
 253 to use when doing a
 254 .Dq Li "make update" .
 255 This defaults to
 256 .Pa /usr/share/examples/cvsup/standard\-supfile .
 257 .It Va SUPFILE1
 258 .Pq Vt str
 259 The second
 260 .Ar supfile
 261 to use when doing a
 262 .Dq Li "make update" .
 263 This defaults to
 264 .Pa /usr/share/examples/cvsup/secure\-supfile .
 265 .It Va SUPFILE2
 266 .Pq Vt str
 267 The third
 268 .Ar supfile
 269 to use when doing a
 270 .Dq Li "make update" .
 271 This defaults to
 272 .Pa /usr/share/examples/cvsup/secure\-supfile .
 273 .It Va PORTSSUPFILE
 274 .Pq Vt str
 275 The ports
 276 .Ar supfile
 277 to use when doing a
 278 .Dq Li "make update" .
 279 This defaults to
 280 .Pa /usr/share/examples/cvsup/ports\-supfile .
 281 .It Va DOCSUPFILE
 282 .Pq Vt str
 283 The documentation
 284 .Ar supfile
 285 to use when doing a
 286 .Dq Li "make update" .
 287 This defaults to
 288 .Pa /usr/share/examples/cvsup/doc\-supfile .
 289 .El
 290 .Pp
 291 The following list provides a name and short description for variables
 292 that are only used doing a kernel build:
 293 .Bl -tag -width Ar
 294 .It Va BOOT_COMCONSOLE_PORT
 295 .Pq Vt str
 296 The port address to use for the console if the boot blocks have
 297 been configured to use a serial console instead of the keyboard/video card.
 298 .It Va BOOT_COMCONSOLE_SPEED
 299 .Pq Vt int
 300 The baud rate to use for the console if the boot blocks have
 301 been configured to use a serial console instead of the keyboard/video card.
 302 .It Va BOOTWAIT
 303 .Pq Vt int
 304 Controls the amount of time the kernel waits for a console keypress
 305 before booting the default kernel.
 306 The value is approximately milliseconds.
 307 Keypresses are accepted by the BIOS before booting from disk,
 308 making it possible to give custom boot parameters even when this is
 309 set to 0.
 310 .It Va COPTFLAGS
 311 .Pq Vt str
 312 Controls the compiler settings when building the
 313 kernel.
 314 Optimization levels above
 315 .Oo Fl O ( O2 , No ...\& ) Oc
 316 are not guaranteed to work.
 317 .It Va KERNCONF
 318 .Pq Vt str
 319 Controls which kernel configurations will be
 320 built by
 321 .Dq Li "${MAKE} buildkernel"
 322 and installed by
 323 .Dq Li "${MAKE} installkernel" .
 324 For example,
 325 .Bd -literal -offset indent
 326 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
 327 .Ed
 328 .Pp
 329 will build the kernels specified by the config files
 330 .Pa MINE , DEBUG , GENERIC ,
 331 and
 332 .Pa OTHERMACHINE ,
 333 and install the kernel specified by the config file
 334 .Pa MINE .
 335 It defaults to
 336 .Pa GENERIC .
 337 .It Va LOADER_TFTP_SUPPORT
 338 .Pq Vt bool
 339 While not a buildkernel-affected option, there is no better place for this.
 340 By default the
 341 .Xr pxeboot 8
 342 loader retrieves the kernel via NFS.
 343 Defining this and recompiling
 344 .Pa /usr/src/sys/boot
 345 will cause it to retrieve the kernel via TFTP.
 346 This allows
 347 .Xr pxeboot 8
 348 to load a custom BOOTP diskless kernel yet
 349 still mount the server's
 350 .Pa /
 351 rather than load the server's kernel.
 352 .It Va MODULES_OVERRIDE
 353 .Pq Vt str
 354 Set to a list of modules to build instead of all of them.
 355 .It Va NO_KERNELCONFIG
 356 .Pq Vt bool
 357 Set this to skip running
 358 .Xr config 8
 359 during
 360 .Dq Li "${MAKE} buildkernel" .
 361 .It Va NO_KERNELDEPEND
 362 .Pq Vt bool
 363 Set this to skip running
 364 .Dq Li "${MAKE} depend"
 365 during
 366 .Dq Li "${MAKE} buildkernel" .
 367 .It Va NO_MODULES
 368 .Pq Vt bool
 369 Set to not build modules with the kernel.
 370 .El
 371 .Pp
 372 The following list provides a name and short description for variables
 373 that are used during the world build:
 374 .Bl -tag -width Ar
 375 .It Va COMPAT1X
 376 .Pq Vt bool
 377 Set to install the
 378 .Fx
 379 1 compatibility libraries.
 380 .It Va COMPAT20
 381 .Pq Vt bool
 382 Set to install the
 383 .Fx 2.0
 384 compatibility libraries.
 385 .It Va COMPAT21
 386 .Pq Vt bool
 387 Set to install the
 388 .Fx 2.1
 389 compatibility libraries.
 390 .It Va COMPAT22
 391 .Pq Vt bool
 392 Set to install the
 393 .Fx 2.2
 394 compatibility libraries.
 395 .It Va COMPAT3X
 396 .Pq Vt bool
 397 Set to install the
 398 .Fx
 399 3
 400 compatibility libraries.
 401 .It Va COMPAT4X
 402 .Pq Vt bool
 403 Set to install the
 404 .Fx
 405 4
 406 compatibility libraries.
 407 .It Va MAKE_IDEA
 408 .Pq Vt bool
 409 Set to build the IDEA encryption code.
 410 This code is patented in the USA and many European countries.
 411 It is
 412 .Em "YOUR RESPONSIBILITY"
 413 to determine if you can legally use IDEA.
 414 .It Va NO_DYNAMICROOT
 415 .Pq Vt bool
 416 Set this if you do not want to link
 417 .Pa /bin
 418 and
 419 .Pa /sbin
 420 dynamically.
 421 .It Va NO_KERBEROS
 422 .Pq Vt bool
 423 Set this if you do not want to build Kerberos 5 (KTH Heimdal).
 424 .It Va ENABLE_SUID_K5SU
 425 .Pq Vt bool
 426 Set this if you wish to use the ksu utility.
 427 Otherwise, it will be
 428 installed without the set-user-ID bit set.
 429 .It Va ENABLE_SUID_NEWGRP
 430 .Pq Vt bool
 431 Set this to install
 432 .Xr newgrp 1
 433 with the set-user-ID bit set.
 434 Otherwise,
 435 .Xr newgrp 1
 436 will not be able to change users' groups.
 437 .It Va ENABLE_SUID_SSH
 438 .Pq Vt bool
 439 Set this to install
 440 .Xr ssh 1
 441 with the set-user-ID bit turned on.
 442 .It Va MODULES_WITH_WORLD
 443 .Pq Vt bool
 444 Set to build modules with the system instead of the kernel.
 445 .It Va NO_BLUETOOTH
 446 .Pq Vt bool
 447 Set to not build Bluetooth related kernel modules, programs and libraries.
 448 .It Va NO_BOOT
 449 .Pq Vt bool
 450 Set to not build the boot blocks and loader.
 451 .It Va NO_CVS
 452 .Pq Vt bool
 453 Set to not build CVS.
 454 .It Va NO_CXX
 455 .Pq Vt bool
 456 Set to not build
 457 .Xr g++ 1
 458 and related libraries.
 459 .It Va NO_FORTRAN
 460 .Pq Vt bool
 461 Set to not build
 462 .Xr g77 1
 463 and related libraries.
 464 .It Va NO_GDB
 465 .Pq Vt bool
 466 Set to not build
 467 .Xr gdb 1 .
 468 .It Va NO_I4B
 469 .Pq Vt bool
 470 Set to not build isdn4bsd package.
 471 .It Va NO_IPFILTER
 472 .Pq Vt bool
 473 Set to not build IP Filter package.
 474 .It Va NO_PF
 475 .Pq Vt bool
 476 Set to not build PF firewall package.
 477 .It Va NO_AUTHPF
 478 .Pq Vt bool
 479 Set to not build
 480 .Xr authpf 8 .
 481 .It Va NO_TOOLCHAIN
 482 .Pq Vt bool
 483 Set to not build
 484 programs used for program development,
 485 compilers, debuggers etc.
 486 .It Va NOINET6
 487 .Pq Vt bool
 488 Set to not build
 489 programs and libraries related to IPv6 networking.
 490 .It Va NOATM
 491 .Pq Vt bool
 492 Set to not build
 493 programs and libraries related to ATM networking.
 494 .It Va NO_USB
 495 .Pq Vt bool
 496 Set to not build
 497 .Xr usbd 8
 498 and related programs.
 499 .It Va NO_LPR
 500 .Pq Vt bool
 501 Set to not build
 502 .Xr lpr 1
 503 and related programs.
 504 .It Va NO_ACPI
 505 .Pq Vt bool
 506 Set to not build
 507 .Xr acpiconf 8 ,
 508 .Xr acpidump 8
 509 and related programs.
 510 .It Va NO_VINUM
 511 .Pq Vt bool
 512 Set to not build
 513 .Xr vinum 8
 514 and related programs.
 515 .It Va NO_MAILWRAPPER
 516 .Pq Vt bool
 517 Set to not build the
 518 .Xr mailwrapper 8
 519 MTA selector.
 520 .It Va NOMAN
 521 .Pq Vt bool
 522 Set to not build manual pages.
 523 .It Va NO_OBJC
 524 .Pq Vt bool
 525 Set to not build Objective C support.
 526 .It Va NO_OPENSSH
 527 .Pq Vt bool
 528 Set to not build OpenSSH.
 529 .It Va NO_OPENSSL
 530 .Pq Vt bool
 531 Set to not build OpenSSL (implies
 532 .Va NO_KERBEROS
 533 and
 534 .Va NO_OPENSSH ) .
 535 .It Va NO_SENDMAIL
 536 .Pq Vt bool
 537 Set to not build
 538 .Xr sendmail 8
 539 and related programs.
 540 .It Va NO_SHAREDOCS
 541 .Pq Vt bool
 542 Set to not build the
 543 .Bx 4.4
 544 legacy docs.
 545 .It Va NO_TCSH
 546 .Pq Vt bool
 547 Set to not build and install
 548 .Pa /bin/csh
 549 (which is
 550 .Xr tcsh 1 ) .
 551 .It Va NOCLEAN
 552 .Pq Vt bool
 553 Set this to disable cleaning during
 554 .Dq Li "make buildworld" .
 555 This should not be set unless you know what you are doing.
 556 .It Va NOCLEANDIR
 557 .Pq Vt bool
 558 Set this to run
 559 .Dq Li "${MAKE} clean"
 560 instead of
 561 .Dq Li "${MAKE} cleandir" .
 562 .It Va NOCRYPT
 563 .Pq Vt bool
 564 Set to not build any crypto code.
 565 .It Va NOGAMES
 566 .Pq Vt bool
 567 Set to not build games.
 568 .It Va NOINFO
 569 .Pq Vt bool
 570 Set to not make or install
 571 .Xr info 5
 572 files.
 573 .It Va NOLIBC_R
 574 .Pq Vt bool
 575 Set to not build
 576 .Nm libc_r
 577 (reentrant version of
 578 .Nm libc ) .
 579 .It Va NOLIBPTHREAD
 580 .Pq Vt bool
 581 Set to not build the
 582 .Nm libpthread
 583 (M:N threading)
 584 library.
 585 .It Va NOLIBTHR
 586 .Pq Vt bool
 587 Set to not build the
 588 .Nm libthr
 589 (1:1 threading)
 590 library.
 591 .It Va NOMANCOMPRESS
 592 .Pq Vt bool
 593 Set to install man pages uncompressed.
 594 .It Va NOPROFILE
 595 .Pq Vt bool
 596 Set to avoid compiling profiled libraries.
 597 .It Va NOSHARE
 598 .Pq Vt bool
 599 Set to not build in the
 600 .Pa share
 601 subdir.
 602 .It Va NO_BIND
 603 .Pq Vt bool
 604 Setting this variable will prevent any part of BIND from being built,
 605 regardless of the presence of any of the other *_BIND_* variables below.
 606 .It Va NO_BIND_DNSSEC
 607 .Pq Vt bool
 608 Set to avoid building or installing the DNSSEC related binaries,
 609 .Xr dnssec-keygen 8
 610 and
 611 .Xr dnssec-signzone 8 .
 612 .It Va NO_BIND_ETC
 613 .Pq Vt bool
 614 Set to avoid installing the default files to
 615 .Pa /etc/namedb .
 616 .It Va NO_BIND_LIBS_LWRES
 617 .Pq Vt bool
 618 Set to avoid installing the lightweight resolver library in
 619 .Pa /usr/lib .
 620 The library that is private to the build system may still be built as needed.
 621 .It Va NO_BIND_NAMED
 622 .Pq Vt bool
 623 Set to avoid building or installing
 624 .Xr named 8 ,
 625 .Xr named.reload 8 ,
 626 .Xr named-checkconf 8 ,
 627 .Xr named-checkzone 8 ,
 628 .Xr rndc 8 ,
 629 and
 630 .Xr rndc-confgen 8 .
 631 .It Va NO_BIND_UTILS
 632 .Pq Vt bool
 633 Set to avoid building or installing the BIND userland utilities,
 634 .Xr dig 1 ,
 635 .Xr host 1 ,
 636 .Xr nslookup 1 ,
 637 and
 638 .Xr nsupdate 8 .
 639 .It Va WITH_BIND_LIBS
 640 .Pq Vt bool
 641 Set to install BIND libraries and include files.
 642 .It Va PPP_NOSUID
 643 .Pq Vt bool
 644 Set to disable the installation of
 645 .Xr ppp 8
 646 as an suid root program.
 647 .It Va SENDMAIL_MC
 648 .Pq Vt str
 649 The default
 650 .Xr m4 1
 651 configuration file to use at install time.
 652 The value should include the full path to the
 653 .Pa .mc
 654 file, e.g.,
 655 .Pa /etc/mail/myconfig.mc .
 656 Use with caution as a make install will overwrite any existing
 657 .Pa /etc/mail/sendmail.cf .
 658 Note that
 659 .Va SENDMAIL_CF
 660 is now deprecated.
 661 .It Va SENDMAIL_SUBMIT_MC
 662 .Pq Vt str
 663 The default
 664 .Xr m4 1
 665 configuration file for mail submission
 666 to use at install time.
 667 The value should include the full path to the
 668 .Pa .mc
 669 file, e.g.,
 670 .Pa /etc/mail/mysubmit.mc .
 671 Use with caution as a make install will overwrite any existing
 672 .Pa /etc/mail/submit.cf .
 673 .It Va SENDMAIL_ADDITIONAL_MC
 674 .Pq Vt str
 675 Additional
 676 .Pa .mc
 677 files which should be built into
 678 .Pa .cf
 679 files at build time.
 680 The value should include the full path to the
 681 .Pa .mc
 682 file(s), e.g.,
 683 .Pa /etc/mail/foo.mc
 684 .Pa /etc/mail/bar.mc .
 685 .It Va SENDMAIL_CF_DIR
 686 .Pq Vt str
 687 Override the default location for the
 688 .Xr m4 1
 689 configuration files used to build a
 690 .Pa .cf
 691 file from a
 692 .Pa .mc
 693 file.
 694 .It Va SENDMAIL_M4_FLAGS
 695 .Pq Vt str
 696 Flags passed to
 697 .Xr m4 1
 698 when building a
 699 .Pa .cf
 700 file from a
 701 .Pa .mc
 702 file.
 703 .It Va SENDMAIL_CFLAGS
 704 .Pq Vt str
 705 Flags to pass to the compile command when building
 706 .Xr sendmail 8 .
 707 The
 708 .Va SENDMAIL_*
 709 flags can be used to provide SASL support with setting such as:
 710 .Bd -literal -offset indent
 711 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 712 SENDMAIL_LDFLAGS=-L/usr/local/lib
 713 SENDMAIL_LDADD=-lsasl
 714 .Ed
 715 .It Va SENDMAIL_LDFLAGS
 716 .Pq Vt str
 717 Flags to pass to the
 718 .Xr ld 1
 719 command when building
 720 .Xr sendmail 8 .
 721 .It Va SENDMAIL_LDADD
 722 .Pq Vt str
 723 Flags to add to the end of the
 724 .Xr ld 1
 725 command when building
 726 .Xr sendmail 8 .
 727 .It Va SENDMAIL_DPADD
 728 .Pq Vt str
 729 Extra dependencies to add when building
 730 .Xr sendmail 8 .
 731 .It Va SENDMAIL_SET_USER_ID
 732 .Pq Vt bool
 733 If set, install
 734 .Xr sendmail 8
 735 as a set-user-ID root binary instead of a set-group-ID binary
 736 and do not install
 737 .Pa /etc/mail/submit.{cf,mc} .
 738 Use of this flag is not recommended and the alternative advice in
 739 .Pa /etc/mail/README
 740 should be followed instead if at all possible.
 741 .It Va SENDMAIL_MAP_PERMS
 742 .Pq Vt str
 743 Mode to use when generating alias and map database files using
 744 .Pa /etc/mail/Makefile .
 745 The default value is 0640.
 746 .It Va TOP_TABLE_SIZE
 747 .Pq Vt int
 748 .Xr top 1
 749 uses a hash table for the user names.
 750 The size of this hash can be tuned to match the number of local users.
 751 The table size should be a prime number
 752 approximately twice as large as the number of lines in
 753 .Pa /etc/passwd .
 754 The default number is 20011.
 755 .It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
 756 .Pq Vt int
 757 Causes the system compiler to be built such that it forces high optimization
 758 levels to a lower one.
 759 .Xr gcc 1
 760 .Fl O2
 761 and above is known to trigger known optimizer bugs at various
 762 times \(em this is worse on the Alpha platform.
 763 The value assigned is the highest optimization value used.
 764 .El
 765 .Pp
 766 The following list provides a name and short description for variables
 767 that are used when building documentation.
 768 .Bl -tag -width Ar
 769 .It Va DISTDIR
 770 .Pq Vt str
 771 Where distfiles are kept.
 772 Normally, this is
 773 .Pa distfiles
 774 in
 775 .Va PORTSDIR .
 776 .It Va DOC_LANG
 777 .Pq Vt str
 778 The list of languages and encodings to build and install.
 779 .It Va PRINTERDEVICE
 780 .Pq Vt str
 781 The default format for system documentation, depends on your
 782 printer.
 783 This can be set to
 784 .Dq Li ascii
 785 for simple printers, or
 786 .Dq Li ps
 787 for postscript or graphics printers with a ghostscript
 788 filter, or both.
 789 .El
 790 .Sh FILES
 791 .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
 792 .It Pa /etc/make.conf
 793 .It Pa /usr/doc/Makefile
 794 .It Pa /usr/share/examples/etc/make.conf
 795 .It Pa /usr/src/Makefile
 796 .It Pa /usr/src/Makefile.inc1
 797 .El
 798 .Sh SEE ALSO
 799 .Xr gcc 1 ,
 800 .Xr install 1 ,
 801 .Xr make 1 ,
 802 .Xr ports 7 ,
 803 .Xr lpd 8 ,
 804 .Xr sendmail 8
 805 .Sh HISTORY
 806 The
 807 .Nm
 808 file appeared sometime before
 809 .Fx 4.0 .
 810 .Sh AUTHORS
 811 This
 812 manual page was written by
 813 .An Mike W. Meyer Aq mwm@mired.org .
 814 .Sh BUGS
 815 This manual page may occasionally be out of date with respect to
 816 the options currently available for use in
 817 .Nm .
 818 Please check the
 819 .Pa /usr/share/examples/etc/make.conf
 820 file for the latest options which are available.
 821 .Sh CAVEATS
 822 Note, that
 823 .Ev MAKEOBJDIRPREFIX
 824 and
 825 .Ev MAKEOBJDIR
 826 are environment variables and should not be set in
 827 .Nm
 828 but in make's environment.