Remove UUCP support. Note: /usr/src/gnu/libexec/uucp and /usr/src/libexec/uucpd
[dragonfly.git] / 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.3 2003/06/17 05:15:13 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 PERL_THREADED
560 .Pq Vt bool
561 Set to enable the building and installation of
562 .Xr perl 1
563 with thread
564 support.
565 .It Va PPP_NOSUID
566 .Pq Vt bool
567 Set to disable the installation of
568 .Xr ppp 8
569 as an suid root program.
570 .It Va SENDMAIL_MC
571 .Pq Vt str
572 The default m4 configuration file to use at install time.
573 The value should include the full path to the
574 .Pa .mc
575 file, e.g.,
576 .Pa /etc/mail/myconfig.mc .
577 Use with caution as a make install will overwrite any existing
578 .Pa /etc/mail/sendmail.cf .
579 Note that
580 .Va SENDMAIL_CF
581 is now deprecated.
582 Avoid using a value of
583 .Pa /etc/mail/sendmail.mc
584 as a buildworld will create
585 .Pa /etc/mail/sendmail.cf
586 before installworld installs an updated
587 .Xr sendmail 8
588 binary.
589 .It Va SENDMAIL_SUBMIT_MC
590 .Pq Vt str
591 The default m4 configuration file for mail submission
592 to use at install time.
593 The value should include the full path to the
594 .Pa .mc
595 file, e.g.,
596 .Pa /etc/mail/mysubmit.mc .
597 Use with caution as a make install will overwrite any existing
598 .Pa /etc/mail/submit.cf .
599 Avoid using a value of
600 .Pa /etc/mail/submit.mc
601 as a buildworld will create
602 .Pa /etc/mail/submit.cf
603 before installworld installs an updated
604 .Xr sendmail 8
605 binary.
606 .It Va SENDMAIL_ADDITIONAL_MC
607 .Pq Vt str
608 Additional
609 .Pa .mc
610 files which should be built into
611 .Pa .cf
612 files at build time.
613 The value should include the full path to the
614 .Pa .mc
615 file(s), e.g.,
616 .Pa /etc/mail/foo.mc
617 .Pa /etc/mail/bar.mc .
618 Avoid using a value of
619 .Pa /etc/mail/sendmail.mc
620 as a buildworld will create
621 .Pa /etc/mail/sendmail.cf
622 before installworld installs an updated
623 .Xr sendmail 8
624 binary.
625 .It Va SENDMAIL_M4_FLAGS
626 .Pq Vt str
627 Flags passed to m4 when building a
628 .Pa .cf
629 file from a
630 .Pa .mc
631 file.
632 .It Va SENDMAIL_CFLAGS
633 .Pq Vt str
634 Flags to pass to the compile command when building
635 .Xr sendmail 8 .
636 The
637 .Va SENDMAIL_*
638 flags can be used to provide SASL support with setting such as:
639 .Bd -literal -offset indent
640 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
641 SENDMAIL_LDFLAGS=-L/usr/local/lib
642 SENDMAIL_LDADD=-lsasl
643 .Ed
644 .It Va SENDMAIL_LDFLAGS
645 .Pq Vt str
646 Flags to pass to the
647 .Xr ld 1
648 command when building
649 .Xr sendmail 8 .
650 .It Va SENDMAIL_LDADD
651 .Pq Vt str
652 Flags to add to the end of the
653 .Xr ld 1
654 command when building
655 .Xr sendmail 8 .
656 .It Va SENDMAIL_DPADD
657 .Pq Vt str
658 Extra dependencies to add when building
659 .Xr sendmail 8 .
660 .It Va SENDMAIL_SET_USER_ID
661 .Pq Vt bool
662 If set, install
663 .Xr sendmail 8
664 as a set-user-ID root binary instead of a set-group-ID binary
665 and do not install
666 .Pa /etc/mail/submit.{cf,mc} .
667 Use of this flag is not recommended and the alternative advice in
668 .Pa /etc/mail/README
669 should be followed instead of at all possible.
670 .It Va SENDMAIL_MAP_PERMS
671 .Pq Vt str
672 Mode to use when generating alias and map database files using
673 .Pa /etc/mail/Makefile .
674 The default value is 0640.
675 .It Va TOP_TABLE_SIZE
676 .Pq Vt int
677 .Xr top 1
678 uses a hash table for the user names.  The size of this hash can be tuned
679 to match the number of local users.  The table size should be a prime number
680 approximately twice as large as the number of lines in
681 .Pa /etc/passwd .
682 The default number is 20011.
683 .El
684 .Pp
685 The following list provides a name and short description for variables
686 that are used when building documentation.
687 .Bl -tag -width Ar
688 .It Va DISTDIR
689 .Pq Vt str
690 Where distfiles are kept.
691 Normally, this is
692 .Pa distfiles
693 in
694 .Va PORTSDIR .
695 .It Va DOC_LANG
696 .Pq Vt str
697 The list of languages and encodings to build and install.
698 .It Va PRINTERDEVICE
699 .Pq Vt str
700 The default format for system documentation, depends on your
701 printer.
702 This can be set to
703 .Dq Li ascii
704 for simple printers or
705 .Dq Li ps
706 for postscript or graphics printers with a ghostscript
707 filter.
708 .El
709 .Pp
710 The following list provides a name and short description for variables
711 that are used when building ports:
712 .Bl -tag -width Ar
713 .It Va FORCE_PKG_REGISTER
714 .Pq Vt bool
715 Set this to override any existing package registration.
716 .It Va HAVE_MOTIF
717 .Pq Vt bool
718 Set this if you have Motif on your system.
719 .It Va KRB5_HOME
720 .Pq Vt str
721 Set this if you want to install the MIT Kerberos5 port somewhere
722 other than
723 .Pa /usr/local .
724 .It Va LOCALBASE
725 .Pq Vt str
726 Set this to the base directory that non\-X ports should be
727 installed in.
728 It provides the default for
729 .Va PREFIX
730 when building in
731 .Pa /usr/ports .
732 .It Va MASTER_SITE_AFTERSTEP
733 .Pq Vt str
734 Set this to change the master site for AfterStep ports.
735 The last
736 part of the path must be
737 .Dq Li /%SUBDIR%/ .
738 .It Va MASTER_SITE_BACKUP
739 .Pq Vt str
740 Controls the site location that ports check for distfiles if the
741 locations listed in their
742 .Pa Makefile
743 do not work.
744 The last part of the path must be
745 .Dq Li /${DIST_SUBDIR}/ .
746 .It Va MASTER_SITE_COMP_SOURCES
747 .Pq Vt str
748 Controls the master site location for
749 .Pa comp.sources
750 ports.
751 The
752 last part of the path must be
753 .Dq Li %SUBDIR%/
754 .It Va MASTER_SITE_GNOME
755 .Pq Vt str
756 Controls the master site location for GNOME ports.
757 The
758 last part of the path must be
759 .Dq Li /%SUBDIR%/
760 .It Va MASTER_SITE_GNU
761 .Pq Vt str
762 Controls the master site location for GNU ports.
763 The
764 last part of the path must be
765 .Dq Li /%SUBDIR%/
766 .It Va MASTER_SITE_KDE
767 .Pq Vt str
768 Controls the master site location for KDE ports.
769 The
770 last part of the path must be
771 .Dq Li /%SUBDIR%/
772 .It Va MASTER_SITE_FREEBSD
773 .Pq Vt bool
774 If set, go to the master
775 .Fx
776 site for all files.
777 .It Va MASTER_SITE_MOZILLA
778 .Pq Vt str
779 Controls the master site location for Mozilla ports.
780 The
781 last part of the path must be
782 .Dq Li /%SUBDIR%/
783 .It Va MASTER_SITE_OVERRIDE
784 .Pq Vt str
785 If set, this site is checked before the sites listed in the ports
786 .Pa Makefile .
787 You can have it check the backup site first by like so:
788 .Bd -literal -offset indent
789 MASTER_SITE_OVERRIDE?=  ${MASTER_SITE_BACKUP}
790 .Ed
791 .It Va MASTER_SITE_PERL_CPAN
792 .Pq Vt str
793 Controls the master site location for Perl ports.
794 The
795 last part of the path must be
796 .Bd -literal -offset indent
797 /%SUBDIR%/
798 .Ed
799 .It Va MASTER_SORT_REGEX
800 .Pq Vt str
801 Set this to control the sort order for mirror sets.
802 To set it to
803 prefer mirrors in the
804 .Pa .jp
805 domain, use:
806 .Bd -literal -offset indent
807 MASTER_SORT_REGEX?=     ^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\.
808 .Ed
809 .Pp
810 Users of other ccTLD domains should change the
811 .Dq Li jp
812 to the
813 appropriate domain.
814 .It Va MASTER_SITE_RINGSERVER
815 .Pq Vt str
816 Controls the master site location for Ringserver ports.
817 The last
818 part of the path must be
819 .Dq Li /%SUBDIR%/ .
820 .It Va MASTER_SITE_RUBY
821 .Pq Vt str
822 Controls the master site location for Ruby ports.
823 The last
824 part of the path must be
825 .Dq Li /%SUBDIR%/ .
826 .It Va MASTER_SITE_SUNSITE
827 .Pq Vt str
828 Controls the master site location for Sunsite ports.
829 The last
830 part of the path must be
831 .Dq Li /%SUBDIR%/ .
832 .It Va MASTER_SITE_TCLTK
833 .Pq Vt str
834 Controls the master site location for Tcl and Tk ports.
835 The last
836 part of the path must be
837 .Dq Li /%SUBDIR%/ .
838 .It Va MASTER_SITE_TEX_CTAN
839 .Pq Vt str
840 Controls the master site location for TeX ports.
841 The last
842 part of the path must be
843 .Dq Li /%SUBDIR%/ .
844 .It Va MASTER_SITE_WINDOWMAKER
845 .Pq Vt str
846 Controls the master site location for WindowMaker ports.
847 The last
848 part of the path must be
849 .Dq Li /%SUBDIR%/ .
850 .It Va MASTER_SITE_XCONTRIB
851 .Pq Vt str
852 Controls the master site location for contributed X ports.
853 The last
854 part of the path must be
855 .Dq Li /%SUBDIR%/ .
856 .It Va MASTER_SITE_XEMACS
857 .Pq Vt str
858 Controls the master site location for Xemacs ports.
859 The last
860 part of the path must be
861 .Dq Li /%SUBDIR%/ .
862 .It Va MASTER_SITE_XFREE
863 .Pq Vt str
864 Controls the master site location for XFree ports.
865 The last
866 part of the path must be
867 .Dq Li /%SUBDIR%/ .
868 .It Va MOTIFLIB
869 .Pq Vt str
870 Location of
871 .Pa libXm.a
872 and
873 .Pa libXm.so .
874 .It Va MOTIF_STATIC
875 .Pq Vt bool
876 Set this if you want ports that use Motif to be built so they
877 can be run on systems without the Motif shared libraries.
878 .It Va NOCLEANDEPENDS
879 .Pq Vt bool
880 Set this to prevent
881 .Dq Li "make clean"
882 from cleaning the ports that the one being cleaned depends on.
883 .It Va NOPORTDOCS
884 .Pq Vt bool
885 Set this to disable installing additional documentation with ports.
886 .It Va PACKAGES
887 .Pq Vt str
888 Used only for the package target; the directory for the package tree.
889 .It Va PATCH_SITES
890 .Pq Vt str
891 Primary location(s) for the distribution of patch files.
892 .It Va PORTSDIR
893 .Pq Vt str
894 The location of the ports tree.
895 .It Va USA_RESIDENT
896 .Pq Vt bool
897 Set this if you are a resident of the USA so that ports that
898 need to can attempt to comply with U.S. export regulations.
899 .It Va WITHOUT_X11
900 .Pq Vt bool
901 Set this so that ports that can be built with or without X11
902 support will build without X11 support by default.
903 .It Va WRKDIRPREFIX
904 .Pq Vt str
905 Where to create temporary files used when building ports.
906 .It Va X11BASE
907 .Pq Vt str
908 Should be set to where the X11 distribution has been
909 installed if it is installed anywhere other than
910 .Pa /usr/X11R6 .
911 .El
912 .Sh FILES
913 .Bl -tag -width /etc/defaults/make.conf -compact
914 .It Pa /etc/defaults/make.conf
915 .It Pa /etc/make.conf
916 .It Pa /usr/doc/Makefile
917 .It Pa /usr/src/Makefile
918 .It Pa /usr/src/Makefile.inc1
919 .It Pa /usr/ports/Mk/bsd.port.mk
920 .It Pa /usr/ports/Mk/bsd.sites.mk
921 .El
922 .Sh SEE ALSO
923 .Xr gcc 1 ,
924 .Xr install 1 ,
925 .Xr make 1 ,
926 .Xr ports 7 ,
927 .Xr lpd 8 ,
928 .Xr sendmail 8
929 .Sh HISTORY
930 The
931 .Nm
932 file appeared sometime before
933 .Fx 4.0 .
934 .Sh AUTHORS
935 This
936 manual page was written by
937 .An Mike W. Meyer Aq mwm@mired.org .
938 .Sh BUGS
939 This manual page may occasionally be out of date with respect to
940 the options currently available for use in
941 .Nm .
942 Please check the
943 .Pa /etc/defaults/make.conf
944 file for the latest options which are available.