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: src/share/man/man5/make.conf.5,v 1.12.2.30 2003/05/18 17:05:55 brueffer Exp $
  26 .\" $DragonFly: src/share/man/man5/make.conf.5,v 1.2 2003/06/17 04:37:00 dillon Exp $
  27 .\"
  28 .Dd November 3, 2000
  29 .Dt MAKE.CONF 5
  30 .Os
  31 .Sh NAME
  32 .Nm make.conf
  33 .Nd system build information
  34 .Sh DESCRIPTION
  35 The file
  36 .Nm
  37 contains settings that control the compilation of the
  38 .Fx
  39 sources
  40 and ported applications.
  41 The file
  42 .Nm
  43 is generally created by the system administrator when the values need
  44 to be changed from their defaults.
  45 .Pp
  46 The purpose of
  47 .Nm
  48 is not to run commands or perform compilation actions
  49 directly.
  50 Instead, it is included by the
  51 various makefiles in
  52 .Pa /usr/src ,
  53 .Pa /usr/ports
  54 and
  55 .Pa /usr/doc
  56 which conditionalize their
  57 internal actions according to the settings found there.
  58 .Pp
  59 The
  60 .Pa /etc/make.conf
  61 file is included from the appropriate
  62 .Pa Makefile
  63 which specifies the default settings for all the available options.
  64 Options need only be specified in
  65 .Pa /etc/make.conf
  66 when the system administrator wishes to override these defaults.
  67 .Pp
  68 The build procedures occur in four broad areas: the world, the kernel,
  69 documentations and ports.
  70 Variables set in
  71 .Nm
  72 may be applicable during builds in one, two, or all four of these
  73 areas.
  74 They may be specified for a particular build via the
  75 .Fl D
  76 option of
  77 .Xr make 1 .
  78 .Pp
  79 The following lists provide a name and short description for each
  80 variable you can use during the indicated builds.
  81 The values of
  82 variables flagged as
  83 .Vt bool
  84 are ignored; the variable being
  85 set at all (even to
  86 .Dq Li FALSE
  87 or
  88 .Dq Li NO )
  89 causes it to
  90 be treated as if it were set.
  91 .Pp
  92 The following list provides a name and short description for variables
  93 that are used for all builds, or are used by the
  94 .Pa makefiles
  95 for things other than builds.
  96 .Bl -tag -width Ar
  97 .It Va CFLAGS
  98 .Pq Vt str
  99 Controls the compiler setting when compiling C code.
 100 Optimization levels above
 101 .Fl O
 102 .Pq Fl O2 , No ...
 103 are not supported.
 104 .Va BDECFLAGS
 105 is provided as a set of
 106 .Xr gcc 1
 107 settings suggested by
 108 .An "Bruce Evans" Aq bde@FreeBSD.org
 109 for developing and testing changes.
 110 They can be used, if set, by:
 111 .Pp
 112 .Bd -literal -offset indent
 113 CFLAGS+=${BDECFLAGS}
 114 .Ed
 115 .It Va CPUTYPE
 116 .Pq Vt str
 117 Controls which processor should be targeted for generated
 118 code.  This controls processor-specific optimizations in
 119 certain code (currently only OpenSSL) as well as modifying
 120 the value of
 121 .Va CFLAGS
 122 and
 123 .Va COPTFLAGS
 124 to contain the appropriate optimization directive to
 125 .Xr gcc 1 .
 126 The automatic setting of
 127 .Va CFLAGS
 128 and
 129 .Va COPTFLAGS
 130 may be overridden using the
 131 .Va NO_CPU_CFLAGS
 132 and
 133 .Va NO_CPU_COPTFLAGS
 134 variables, respectively.  Refer to
 135 .Pa /usr/share/examples/etc/make.conf
 136 for a list of recognized
 137 .Va CPUTYPE
 138 options.
 139 .It Va NO_CPU_CFLAGS
 140 .Pq Vt str
 141 Setting this variable will prevent CPU specific compiler flags
 142 from being automatically added to
 143 .Va CFLAGS
 144 during compile time.
 145 .It Va NO_CPU_COPTFLAGS
 146 .Pq Vt str
 147 Setting this variable will prevent CPU specific compiler flags
 148 from being automatically added to
 149 .Va COPTFLAGS
 150 during compile time.
 151 .It Va CVS_UPDATE
 152 .Pq Vt bool
 153 Set this to use
 154 .Xr cvs 1
 155 to update your ports with
 156 .Dq Li "make update" .
 157 .It Va CXXFLAGS
 158 .Pq Vt str
 159 Controls the compiler settings when compiling C++ code.
 160 .Va CXXFLAGS
 161 is initially set to the value of
 162 .Va CFLAGS .
 163 If you want to
 164 add to the
 165 .Va CXXFLAGS
 166 value, use
 167 .Dq Li +=
 168 instead of
 169 .Dq Li = .
 170 .It Va INSTALL
 171 .Pq Vt str
 172 the default install command.
 173 To have commands compared before doing
 174 the install, use
 175 .Bd -literal -offset indent
 176 INSTALL="install -C"
 177 .Ed
 178 .It Va LOCAL_DIRS
 179 .Pq Vt str
 180 List any directories that should be entered when doing
 181 make's in
 182 .Pa /usr/src
 183 in this variable.
 184 .It Va MAKE_SHELL
 185 .Pq Vt str
 186 Controls the shell used internally by
 187 .Xr make 1
 188 to process the command scripts in makefiles.
 189 .Xr sh 1 ,
 190 .Xr ksh 1 ,
 191 and
 192 .Xr csh 1
 193 all currently supported.
 194 .Bd -literal -offset indent
 195 MAKE_SHELL?=sh
 196 .Ed
 197 .It Va MTREE_FOLLOWS_SYMLINKS
 198 .Pq Vt str
 199 Set this to
 200 .Dq Fl L
 201 to cause
 202 .Xr mtree 8
 203 to follow symlinks.
 204 .It Va NO_DOCUPDATE
 205 .Pq Vt bool
 206 Set this to not update the doc tree during
 207 .Dq Li "make update" .
 208 .It Va NO_PORTSUPDATE
 209 .Pq Vt bool
 210 Set this to not update the ports tree during
 211 .Dq Li "make update" .
 212 .It Va SUP_UPDATE
 213 .Pq Vt bool
 214 Set this to use
 215 .Xr cvsup 1
 216 to update your ports with
 217 .Dq Li "make update" .
 218 .It Va SUP
 219 .Pq Vt str
 220 The location of the
 221 .Xr cvsup 1
 222 command for
 223 .Dq Li "make update" .
 224 .It Va SUPFLAGS
 225 .Pq Vt str
 226 The flag for the
 227 .Xr sup 1
 228 command when doing
 229 .Dq Li "make update" .
 230 This defaults to
 231 .Op Fl g L Ar 2 .
 232 .It Va SUPHOST
 233 .Pq Vt str
 234 The hostname of the sup server to use when doing
 235 .Dq Li "make update" .
 236 .It Va SUPFILE
 237 .Pq Vt str
 238 The first
 239 .Ar supfile
 240 to use when doing a
 241 .Dq Li "make update" .
 242 This defaults to
 243 .Pa /usr/share/examples/cvsup/standard\-supfile .
 244 .It Va SUPFILE1
 245 .Pq Vt str
 246 The second
 247 .Ar supfile
 248 to use when doing a
 249 .Dq Li "make update" .
 250 This defaults to
 251 .Pa /usr/share/examples/cvsup/secure\-supfile .
 252 .It Va SUPFILE2
 253 .Pq Vt str
 254 The third
 255 .Ar supfile
 256 to use when doing a
 257 .Dq Li "make update" .
 258 This defaults to
 259 .Pa /usr/share/examples/cvsup/secure\-supfile .
 260 .It Va PORTSSUPFILE
 261 .Pq Vt str
 262 The ports
 263 .Ar supfile
 264 to use when doing a
 265 .Dq Li "make update" .
 266 This defaults to
 267 .Pa /usr/share/examples/cvsup/ports\-supfile .
 268 .It Va DOCSUPFILE
 269 .Pq Vt str
 270 The documentation
 271 .Ar supfile
 272 to use when doing a
 273 .Dq Li "make update" .
 274 This defaults to
 275 .Pa /usr/share/examples/cvsup/doc\-supfile .
 276 .It Va WARNS_WERROR
 277 Causes -Werror to be added to
 278 .Va CFLAGS
 279 when WARNS is in effect.
 280 .El
 281 .Pp
 282 The following list provides a name and short description for variables
 283 that are only used doing a kernel build:
 284 .Bl -tag -width Ar
 285 .It Va BOOT_COMCONSOLE_PORT
 286 .Pq Vt str
 287 The port address to use for the console if the boot blocks have
 288 been configured to use a serial console instead of the keyboard/video card.
 289 .It Va BOOT_COMCONSOLE_SPEED
 290 .Pq Vt int
 291 The baud rate to use for the console if the boot blocks have
 292 been configured to use a serial console instead of the keyboard/video card.
 293 .It Va BOOTWAIT
 294 .Pq Vt int
 295 Controls the amount of time the kernel waits for a console keypress
 296 before booting the default kernel.
 297 The value is approximately milliseconds.
 298 Keypresses are accepted by the BIOS before booting from disk,
 299 making it possible to give custom boot parameters even when this is
 300 set to 0.
 301 .It Va COPTFLAGS
 302 .Pq Vt str
 303 Controls the compiler settings when building the
 304 kernel.
 305 Optimization levels above
 306 .Oo Fl O ( O2 , No ...\& ) Oc
 307 are not guaranteed to work.
 308 .It Va KERNCONF
 309 .Pq Vt str
 310 Controls which kernel configurations will be
 311 built by
 312 .Dq Li "${MAKE} buildkernel"
 313 and installed by
 314 .Dq Li "${MAKE} installkernel" .
 315 For example,
 316 .Bd -literal -offset indent
 317 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
 318 .Ed
 319 .Pp
 320 will build the kernels specified by the config files
 321 .Pa MINE , DEBUG , GENERIC ,
 322 and
 323 .Pa OTHERMACHINE ,
 324 and install the kernel specified by the config file
 325 .Pa MINE .
 326 It defaults to
 327 .Pa GENERIC .
 328 .It Va LOADER_TFTP_SUPPORT
 329 .Pq Vt bool
 330 While not a buildkernel-affected option, there is no better place for this.
 331 By default the
 332 .Xr pxeboot 8
 333 loader retrieves the kernel via NFS.
 334 Defining this and recompiling
 335 .Pa /usr/src/sys/boot
 336 will cause it to retrieve the kernel via TFTP.
 337 This allows pxeboot to load a custom BOOTP diskless kernel yet
 338 still mount the server's
 339 .Pa /
 340 rather than load the server's kernel.
 341 .It Va MODULES_OVERRIDE
 342 .Pq Vt str
 343 Set to a list of modules to build instead of all of them.
 344 .It Va NO_KERNELCONFIG
 345 .Pq Vt bool
 346 Set this to skip running
 347 .Xr config 8
 348 during
 349 .Dq Li "${MAKE} buildkernel" .
 350 .It Va NO_KERNELDEPEND
 351 .Pq Vt bool
 352 Set this to skip running
 353 .Dq Li "${MAKE} depend"
 354 during
 355 .Dq Li "${MAKE} buildkernel" .
 356 .It Va NO_MODULES
 357 .Pq Vt bool
 358 Set to not build modules with the kernel.
 359 .El
 360 .Pp
 361 The following list provides a name and short description for variables
 362 that are used during the world build:
 363 .Bl -tag -width Ar
 364 .It Va COMPAT1X
 365 .Pq Vt bool
 366 Set to install the
 367 .Fx
 368 1 compatibility libraries.
 369 .It Va COMPAT20
 370 .Pq Vt bool
 371 Set to install the
 372 .Fx 2.0
 373 compatibility libraries.
 374 .It Va COMPAT21
 375 .Pq Vt bool
 376 Set to install the
 377 .Fx 2.1
 378 compatibility libraries.
 379 .It Va COMPAT22
 380 .Pq Vt bool
 381 Set to install the
 382 .Fx 2.2
 383 compatibility libraries.
 384 .It Va COMPAT3X
 385 .Pq Vt bool
 386 Set to install the
 387 .Fx
 388 3
 389 compatibility libraries.
 390 .It Va COMPAT4X
 391 .Pq Vt bool
 392 Set to install the
 393 .Fx
 394 4
 395 compatibility libraries.
 396 .It Va ENABLE_SUIDPERL
 397 .Pq Vt bool
 398 Set to enable the installation of an suid
 399 .Xr perl 1
 400 binary.
 401 .It Va FETCH_CMD
 402 .Pq Vt str
 403 Command to use to fetch files.
 404 Normally
 405 .Xr fetch 1 .
 406 .It Va KRB5_HOME
 407 .Pq Vt str
 408 If you want to install the MIT Kerberos5 port somewhere other than
 409 .Pa /usr/local ,
 410 define this.  This is also used to tell ssh1 that kerberos is needed.
 411 .It Va MAKE_IDEA
 412 .Pq Vt bool
 413 Set to build the IDEA encryption code.
 414 This code is patented in the USA and many European countries.
 415 It is
 416 .Em "YOUR RESPONSIBILITY"
 417 to determine if you can legally use IDEA.
 418 .It Va MAKE_KERBEROS4
 419 .Pq Vt bool
 420 Set this to build KerberosIV (KTH eBones).
 421 .It Va MAKE_KERBEROS5
 422 .Pq Vt bool
 423 Set this to build Kerberos5 (KTH Heimdal).
 424 .Em WARNING !
 425 This is still experimental code.
 426 If you need stable Kerberos5, use the
 427 port(s).
 428 .It Va ENABLE_SUID_K5SU
 429 .Pq Vt bool
 430 Set this if you wish to use the k5su utility.  Otherwise, it will be
 431 installed without the set-user-ID bit set.
 432 .It Va ENABLE_SUID_SSH
 433 .Pq Vt bool
 434 Set this to install
 435 .Xr ssh 1
 436 with the setuid bit turned on.
 437 .It Va MODULES_WITH_WORLD
 438 .Pq Vt bool
 439 Set to build modules with the system instead of the kernel.
 440 .It Va NO_CVS
 441 .Pq Vt bool
 442 Set to not build CVS.
 443 .It Va NO_BIND
 444 .Pq Vt bool
 445 Set to not build BIND.
 446 .It Va NO_FORTRAN
 447 .Pq Vt bool
 448 Set to not build
 449 .Xr g77 1
 450 and related libraries.
 451 .It Va NO_GDB
 452 .Pq Vt bool
 453 Set to not build
 454 .Xr gdb 1
 455 .It Va NO_I4B
 456 .Pq Vt bool
 457 Set to not build isdn4bsd package.
 458 .It Va NO_IPFILTER
 459 .Pq Vt bool
 460 Set to not build IP Filter package.
 461 .It Va NO_LPR
 462 .Pq Vt bool
 463 Set to not build
 464 .Xr lpr 1
 465 and related programs.
 466 .It Va NO_MAILWRAPPER
 467 .Pq Vt bool
 468 Set to not build the
 469 .Xr mailwrapper 8
 470 MTA selector.
 471 .It Va NOMAN
 472 .Pq Vt bool
 473 Set to not build manual pages
 474 .It Va NO_MAKEDEV
 475 .Pq Vt bool
 476 Set to avoid running
 477 .Dq Li "MAKEDEV all"
 478 on
 479 .Pa /dev
 480 during install.
 481 .It Va NO_OBJC
 482 .Pq Vt bool
 483 Set to not build Objective C support.
 484 .It Va NO_OPENSSH
 485 .Pq Vt bool
 486 Set to not build OpenSSH.
 487 .It Va NO_OPENSSL
 488 .Pq Vt bool
 489 Set to not build OpenSSL (implies
 490 .Va NO_OPENSSH ) .
 491 .It Va NO_SENDMAIL
 492 .Pq Vt bool
 493 Set to not build
 494 .Xr sendmail 8
 495 and related programs.
 496 .It Va NO_SHAREDOCS
 497 .Pq Vt bool
 498 Set to not build the
 499 .Bx 4.4
 500 legacy docs.
 501 .It Va NO_TCSH
 502 .Pq Vt bool
 503 Set to not build and install
 504 .Pa /bin/csh
 505 (which is
 506 .Xr tcsh 1 ) .
 507 .It Va NO_X
 508 .Pq Vt bool
 509 Set to not compile in X\-Windows support (e.g.\&
 510 .Xr doscmd 1 ) .
 511 .It Va NOCLEAN
 512 .Pq Vt bool
 513 Set this to disable cleaning during
 514 .Dq Li "make buildworld" .
 515 This should not be set unless you know what you are doing.
 516 .It Va NOCLEANDIR
 517 .Pq Vt bool
 518 Set this to run
 519 .Dq Li "${MAKE} clean"
 520 instead of
 521 .Dq Li "${MAKE} cleandir" .
 522 .It Va NOCRYPT
 523 .Pq Vt bool
 524 Set to not build any crypto code.
 525 .It Va NOGAMES
 526 .Pq Vt bool
 527 Set to not build games.
 528 .It Va NOINFO
 529 .Pq Vt bool
 530 Set to not make or install
 531 .Xr info 5
 532 files.
 533 .It Va NOLIBC_R
 534 .Pq Vt bool
 535 Set to not build
 536 .Nm libc_r
 537 (reentrant version of
 538 .Nm libc ) .
 539 .It Va NOMANCOMPRESS
 540 .Pq Vt bool
 541 Set to install man pages uncompressed.
 542 .It Va NOPERL
 543 .Pq Vt bool
 544 Set to avoid building
 545 .Xr perl 1 .
 546 .It Va NOPROFILE
 547 .Pq Vt bool
 548 Set to avoid compiling profiled libraries.
 549 .It Va NOSECURE
 550 .Pq Vt bool
 551 set to not build crypto code in
 552 .Pa secure
 553 subdir.
 554 .It Va NOSHARE
 555 .Pq Vt bool
 556 Set to not build in the
 557 .Pa share
 558 subdir.
 559 .It Va NOUUCP
 560 .Pq Vt bool
 561 Set to not build
 562 .Xr uucp 1
 563 related programs.
 564 .It Va PERL_THREADED
 565 .Pq Vt bool
 566 Set to enable the building and installation of
 567 .Xr perl 1
 568 with thread
 569 support.
 570 .It Va PPP_NOSUID
 571 .Pq Vt bool
 572 Set to disable the installation of
 573 .Xr ppp 8
 574 as an suid root program.
 575 .It Va SENDMAIL_MC
 576 .Pq Vt str
 577 The default m4 configuration file to use at install time.
 578 The value should include the full path to the
 579 .Pa .mc
 580 file, e.g.,
 581 .Pa /etc/mail/myconfig.mc .
 582 Use with caution as a make install will overwrite any existing
 583 .Pa /etc/mail/sendmail.cf .
 584 Note that
 585 .Va SENDMAIL_CF
 586 is now deprecated.
 587 Avoid using a value of
 588 .Pa /etc/mail/sendmail.mc
 589 as a buildworld will create
 590 .Pa /etc/mail/sendmail.cf
 591 before installworld installs an updated
 592 .Xr sendmail 8
 593 binary.
 594 .It Va SENDMAIL_SUBMIT_MC
 595 .Pq Vt str
 596 The default m4 configuration file for mail submission
 597 to use at install time.
 598 The value should include the full path to the
 599 .Pa .mc
 600 file, e.g.,
 601 .Pa /etc/mail/mysubmit.mc .
 602 Use with caution as a make install will overwrite any existing
 603 .Pa /etc/mail/submit.cf .
 604 Avoid using a value of
 605 .Pa /etc/mail/submit.mc
 606 as a buildworld will create
 607 .Pa /etc/mail/submit.cf
 608 before installworld installs an updated
 609 .Xr sendmail 8
 610 binary.
 611 .It Va SENDMAIL_ADDITIONAL_MC
 612 .Pq Vt str
 613 Additional
 614 .Pa .mc
 615 files which should be built into
 616 .Pa .cf
 617 files at build time.
 618 The value should include the full path to the
 619 .Pa .mc
 620 file(s), e.g.,
 621 .Pa /etc/mail/foo.mc
 622 .Pa /etc/mail/bar.mc .
 623 Avoid using a value of
 624 .Pa /etc/mail/sendmail.mc
 625 as a buildworld will create
 626 .Pa /etc/mail/sendmail.cf
 627 before installworld installs an updated
 628 .Xr sendmail 8
 629 binary.
 630 .It Va SENDMAIL_M4_FLAGS
 631 .Pq Vt str
 632 Flags passed to m4 when building a
 633 .Pa .cf
 634 file from a
 635 .Pa .mc
 636 file.
 637 .It Va SENDMAIL_CFLAGS
 638 .Pq Vt str
 639 Flags to pass to the compile command when building
 640 .Xr sendmail 8 .
 641 The
 642 .Va SENDMAIL_*
 643 flags can be used to provide SASL support with setting such as:
 644 .Bd -literal -offset indent
 645 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 646 SENDMAIL_LDFLAGS=-L/usr/local/lib
 647 SENDMAIL_LDADD=-lsasl
 648 .Ed
 649 .It Va SENDMAIL_LDFLAGS
 650 .Pq Vt str
 651 Flags to pass to the
 652 .Xr ld 1
 653 command when building
 654 .Xr sendmail 8 .
 655 .It Va SENDMAIL_LDADD
 656 .Pq Vt str
 657 Flags to add to the end of the
 658 .Xr ld 1
 659 command when building
 660 .Xr sendmail 8 .
 661 .It Va SENDMAIL_DPADD
 662 .Pq Vt str
 663 Extra dependencies to add when building
 664 .Xr sendmail 8 .
 665 .It Va SENDMAIL_SET_USER_ID
 666 .Pq Vt bool
 667 If set, install
 668 .Xr sendmail 8
 669 as a set-user-ID root binary instead of a set-group-ID binary
 670 and do not install
 671 .Pa /etc/mail/submit.{cf,mc} .
 672 Use of this flag is not recommended and the alternative advice in
 673 .Pa /etc/mail/README
 674 should be followed instead of at all possible.
 675 .It Va SENDMAIL_MAP_PERMS
 676 .Pq Vt str
 677 Mode to use when generating alias and map database files using
 678 .Pa /etc/mail/Makefile .
 679 The default value is 0640.
 680 .It Va TOP_TABLE_SIZE
 681 .Pq Vt int
 682 .Xr top 1
 683 uses a hash table for the user names.  The size of this hash can be tuned
 684 to match the number of local users.  The table size should be a prime number
 685 approximately twice as large as the number of lines in
 686 .Pa /etc/passwd .
 687 The default number is 20011.
 688 .El
 689 .Pp
 690 The following list provides a name and short description for variables
 691 that are used when building documentation.
 692 .Bl -tag -width Ar
 693 .It Va DISTDIR
 694 .Pq Vt str
 695 Where distfiles are kept.
 696 Normally, this is
 697 .Pa distfiles
 698 in
 699 .Va PORTSDIR .
 700 .It Va DOC_LANG
 701 .Pq Vt str
 702 The list of languages and encodings to build and install.
 703 .It Va PRINTERDEVICE
 704 .Pq Vt str
 705 The default format for system documentation, depends on your
 706 printer.
 707 This can be set to
 708 .Dq Li ascii
 709 for simple printers or
 710 .Dq Li ps
 711 for postscript or graphics printers with a ghostscript
 712 filter.
 713 .El
 714 .Pp
 715 The following list provides a name and short description for variables
 716 that are used when building ports:
 717 .Bl -tag -width Ar
 718 .It Va FORCE_PKG_REGISTER
 719 .Pq Vt bool
 720 Set this to override any existing package registration.
 721 .It Va HAVE_MOTIF
 722 .Pq Vt bool
 723 Set this if you have Motif on your system.
 724 .It Va KRB5_HOME
 725 .Pq Vt str
 726 Set this if you want to install the MIT Kerberos5 port somewhere
 727 other than
 728 .Pa /usr/local .
 729 .It Va LOCALBASE
 730 .Pq Vt str
 731 Set this to the base directory that non\-X ports should be
 732 installed in.
 733 It provides the default for
 734 .Va PREFIX
 735 when building in
 736 .Pa /usr/ports .
 737 .It Va MASTER_SITE_AFTERSTEP
 738 .Pq Vt str
 739 Set this to change the master site for AfterStep ports.
 740 The last
 741 part of the path must be
 742 .Dq Li /%SUBDIR%/ .
 743 .It Va MASTER_SITE_BACKUP
 744 .Pq Vt str
 745 Controls the site location that ports check for distfiles if the
 746 locations listed in their
 747 .Pa Makefile
 748 do not work.
 749 The last part of the path must be
 750 .Dq Li /${DIST_SUBDIR}/ .
 751 .It Va MASTER_SITE_COMP_SOURCES
 752 .Pq Vt str
 753 Controls the master site location for
 754 .Pa comp.sources
 755 ports.
 756 The
 757 last part of the path must be
 758 .Dq Li %SUBDIR%/
 759 .It Va MASTER_SITE_GNOME
 760 .Pq Vt str
 761 Controls the master site location for GNOME ports.
 762 The
 763 last part of the path must be
 764 .Dq Li /%SUBDIR%/
 765 .It Va MASTER_SITE_GNU
 766 .Pq Vt str
 767 Controls the master site location for GNU ports.
 768 The
 769 last part of the path must be
 770 .Dq Li /%SUBDIR%/
 771 .It Va MASTER_SITE_KDE
 772 .Pq Vt str
 773 Controls the master site location for KDE ports.
 774 The
 775 last part of the path must be
 776 .Dq Li /%SUBDIR%/
 777 .It Va MASTER_SITE_FREEBSD
 778 .Pq Vt bool
 779 If set, go to the master
 780 .Fx
 781 site for all files.
 782 .It Va MASTER_SITE_MOZILLA
 783 .Pq Vt str
 784 Controls the master site location for Mozilla ports.
 785 The
 786 last part of the path must be
 787 .Dq Li /%SUBDIR%/
 788 .It Va MASTER_SITE_OVERRIDE
 789 .Pq Vt str
 790 If set, this site is checked before the sites listed in the ports
 791 .Pa Makefile .
 792 You can have it check the backup site first by like so:
 793 .Bd -literal -offset indent
 794 MASTER_SITE_OVERRIDE?=  ${MASTER_SITE_BACKUP}
 795 .Ed
 796 .It Va MASTER_SITE_PERL_CPAN
 797 .Pq Vt str
 798 Controls the master site location for Perl ports.
 799 The
 800 last part of the path must be
 801 .Bd -literal -offset indent
 802 /%SUBDIR%/
 803 .Ed
 804 .It Va MASTER_SORT_REGEX
 805 .Pq Vt str
 806 Set this to control the sort order for mirror sets.
 807 To set it to
 808 prefer mirrors in the
 809 .Pa .jp
 810 domain, use:
 811 .Bd -literal -offset indent
 812 MASTER_SORT_REGEX?=     ^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\.
 813 .Ed
 814 .Pp
 815 Users of other ccTLD domains should change the
 816 .Dq Li jp
 817 to the
 818 appropriate domain.
 819 .It Va MASTER_SITE_RINGSERVER
 820 .Pq Vt str
 821 Controls the master site location for Ringserver ports.
 822 The last
 823 part of the path must be
 824 .Dq Li /%SUBDIR%/ .
 825 .It Va MASTER_SITE_RUBY
 826 .Pq Vt str
 827 Controls the master site location for Ruby ports.
 828 The last
 829 part of the path must be
 830 .Dq Li /%SUBDIR%/ .
 831 .It Va MASTER_SITE_SUNSITE
 832 .Pq Vt str
 833 Controls the master site location for Sunsite ports.
 834 The last
 835 part of the path must be
 836 .Dq Li /%SUBDIR%/ .
 837 .It Va MASTER_SITE_TCLTK
 838 .Pq Vt str
 839 Controls the master site location for Tcl and Tk ports.
 840 The last
 841 part of the path must be
 842 .Dq Li /%SUBDIR%/ .
 843 .It Va MASTER_SITE_TEX_CTAN
 844 .Pq Vt str
 845 Controls the master site location for TeX ports.
 846 The last
 847 part of the path must be
 848 .Dq Li /%SUBDIR%/ .
 849 .It Va MASTER_SITE_WINDOWMAKER
 850 .Pq Vt str
 851 Controls the master site location for WindowMaker ports.
 852 The last
 853 part of the path must be
 854 .Dq Li /%SUBDIR%/ .
 855 .It Va MASTER_SITE_XCONTRIB
 856 .Pq Vt str
 857 Controls the master site location for contributed X ports.
 858 The last
 859 part of the path must be
 860 .Dq Li /%SUBDIR%/ .
 861 .It Va MASTER_SITE_XEMACS
 862 .Pq Vt str
 863 Controls the master site location for Xemacs ports.
 864 The last
 865 part of the path must be
 866 .Dq Li /%SUBDIR%/ .
 867 .It Va MASTER_SITE_XFREE
 868 .Pq Vt str
 869 Controls the master site location for XFree ports.
 870 The last
 871 part of the path must be
 872 .Dq Li /%SUBDIR%/ .
 873 .It Va MOTIFLIB
 874 .Pq Vt str
 875 Location of
 876 .Pa libXm.a
 877 and
 878 .Pa libXm.so .
 879 .It Va MOTIF_STATIC
 880 .Pq Vt bool
 881 Set this if you want ports that use Motif to be built so they
 882 can be run on systems without the Motif shared libraries.
 883 .It Va NOCLEANDEPENDS
 884 .Pq Vt bool
 885 Set this to prevent
 886 .Dq Li "make clean"
 887 from cleaning the ports that the one being cleaned depends on.
 888 .It Va NOPORTDOCS
 889 .Pq Vt bool
 890 Set this to disable installing additional documentation with ports.
 891 .It Va PACKAGES
 892 .Pq Vt str
 893 Used only for the package target; the directory for the package tree.
 894 .It Va PATCH_SITES
 895 .Pq Vt str
 896 Primary location(s) for the distribution of patch files.
 897 .It Va PORTSDIR
 898 .Pq Vt str
 899 The location of the ports tree.
 900 .It Va USA_RESIDENT
 901 .Pq Vt bool
 902 Set this if you are a resident of the USA so that ports that
 903 need to can attempt to comply with U.S. export regulations.
 904 .It Va WITHOUT_X11
 905 .Pq Vt bool
 906 Set this so that ports that can be built with or without X11
 907 support will build without X11 support by default.
 908 .It Va WRKDIRPREFIX
 909 .Pq Vt str
 910 Where to create temporary files used when building ports.
 911 .It Va X11BASE
 912 .Pq Vt str
 913 Should be set to where the X11 distribution has been
 914 installed if it is installed anywhere other than
 915 .Pa /usr/X11R6 .
 916 .El
 917 .Sh FILES
 918 .Bl -tag -width /etc/defaults/make.conf -compact
 919 .It Pa /etc/defaults/make.conf
 920 .It Pa /etc/make.conf
 921 .It Pa /usr/doc/Makefile
 922 .It Pa /usr/src/Makefile
 923 .It Pa /usr/src/Makefile.inc1
 924 .It Pa /usr/ports/Mk/bsd.port.mk
 925 .It Pa /usr/ports/Mk/bsd.sites.mk
 926 .El
 927 .Sh SEE ALSO
 928 .Xr gcc 1 ,
 929 .Xr install 1 ,
 930 .Xr make 1 ,
 931 .Xr ports 7 ,
 932 .Xr lpd 8 ,
 933 .Xr sendmail 8
 934 .Sh HISTORY
 935 The
 936 .Nm
 937 file appeared sometime before
 938 .Fx 4.0 .
 939 .Sh AUTHORS
 940 This
 941 manual page was written by
 942 .An Mike W. Meyer Aq mwm@mired.org .
 943 .Sh BUGS
 944 This manual page may occasionally be out of date with respect to
 945 the options currently available for use in
 946 .Nm .
 947 Please check the
 948 .Pa /etc/defaults/make.conf
 949 file for the latest options which are available.