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