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