mdoc(7) police:
Use proper macros for variables and their types, removed hard sentence breaks, added a bunch of cross references.
This commit is contained in:
parent
2c69cab2ed
commit
b99317af38
@ -29,12 +29,15 @@
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm make.conf
|
||||
.Nd system build information.
|
||||
.Nd system build information
|
||||
.Sh DESCRIPTION
|
||||
The file
|
||||
.Nm
|
||||
contains settings that control the compilation of the FreeBSD sources
|
||||
and ported applications. The file
|
||||
contains settings that control the compilation of the
|
||||
.Fx
|
||||
sources
|
||||
and ported applications.
|
||||
The file
|
||||
.Nm
|
||||
is generally created by the system administrator when the values need
|
||||
to be changed from their defaults.
|
||||
@ -42,9 +45,10 @@ to be changed from their defaults.
|
||||
The purpose of
|
||||
.Nm
|
||||
is not to run commands or perform compilation actions
|
||||
directly. Instead, it is included by the
|
||||
directly.
|
||||
Instead, it is included by the
|
||||
various makefiles in
|
||||
.Pa /usr/src,
|
||||
.Pa /usr/src ,
|
||||
.Pa /usr/ports
|
||||
and
|
||||
.Pa /usr/doc
|
||||
@ -53,149 +57,211 @@ internal actions according to the settings found there.
|
||||
.Pp
|
||||
The
|
||||
.Pa /etc/make.conf
|
||||
file is included from the the appropriate Makefile
|
||||
file is included from the the appropriate
|
||||
.Pa Makefile
|
||||
which specifies the default settings for all the available options.
|
||||
Options need only be specified in
|
||||
Options need only be specified in
|
||||
.Pa /etc/make.conf
|
||||
when the system administrator wishes to override these defaults.
|
||||
.Pp
|
||||
The build procedures occur in four broad areas: the world, the kernel,
|
||||
documentations and ports. Variables set in
|
||||
documentations and ports.
|
||||
Variables set in
|
||||
.Nm
|
||||
may be applicable during builds in one, two, or all four of these
|
||||
areas. They may be specified for a particular build via the
|
||||
.Op -D
|
||||
areas.
|
||||
They may be specified for a particular build via the
|
||||
.Fl D
|
||||
option of
|
||||
.Xr make 1 .
|
||||
.Pp
|
||||
The following lists provides a name and short description for each
|
||||
variable you can use during the indicated builds. The values of
|
||||
The following lists provide a name and short description for each
|
||||
variable you can use during the indicated builds.
|
||||
The values of
|
||||
variables flagged as
|
||||
bool
|
||||
.Vt bool
|
||||
are ignored; the variable being
|
||||
set at all (even to
|
||||
.Li Dq FALSE
|
||||
.Dq Li FALSE
|
||||
or
|
||||
.Li Dq NO )
|
||||
.Dq Li NO )
|
||||
cause it to
|
||||
be treated as if it were set.
|
||||
.Pp
|
||||
The following list provides a name and short description for variables
|
||||
that are used for all builds, or are used by the
|
||||
makefiles for things other than builds.
|
||||
.Pa makefiles
|
||||
for things other than builds.
|
||||
.Bl -tag -width Ar
|
||||
.It Ar CFLAGS
|
||||
(str) Controls the compiler setting when compiling C code.
|
||||
.It Va CFLAGS
|
||||
.Vt ( str )
|
||||
Controls the compiler setting when compiling C code.
|
||||
Optimization levels above
|
||||
.Op -O ( -O2 , ...\& )
|
||||
are not supported. BDECFLAGS
|
||||
is provided as a set of gcc settings suggested by Bruce Evans
|
||||
for developing and testing changes. They can be used by:
|
||||
.Oo Fl O ( O2 , No ...\& ) Oc
|
||||
are not supported.
|
||||
.Va BDECFLAGS
|
||||
is provided as a set of
|
||||
.Xr gcc 1
|
||||
settings suggested by
|
||||
.An "Bruce Evans" Aq bde@FreeBSD.org
|
||||
for developing and testing changes.
|
||||
They can be used by:
|
||||
.Pp
|
||||
.Bd -literal -offset indent
|
||||
CXFLAGS+=${BDECFLAGS}
|
||||
.Ed
|
||||
.It Ar CVS_UPDATE
|
||||
(bool) Set this to use cvs to update your ports with
|
||||
.Cm "make update" .
|
||||
.It Ar CXXFLAGS
|
||||
(str) Controls the compiler settings when compiling C++ code.
|
||||
CXXFLAGS is initially set to the value of CFLAGS. If you want to
|
||||
add to the CXXFLAGS value, use
|
||||
.It Va CVS_UPDATE
|
||||
.Vt ( bool )
|
||||
Set this to use
|
||||
.Xr cvs 1
|
||||
to update your ports with
|
||||
.Dq Li "make update" .
|
||||
.It Va CXXFLAGS
|
||||
.Vt ( str )
|
||||
Controls the compiler settings when compiling C++ code.
|
||||
.Va CXXFLAGS
|
||||
is initially set to the value of
|
||||
.Va CFLAGS .
|
||||
If you want to
|
||||
add to the
|
||||
.Va CXXFLAGS
|
||||
value, use
|
||||
.Dq Li +=
|
||||
instead of
|
||||
.Dq Li = .
|
||||
.It Ar INSTALL
|
||||
(str) the default install command. To have commands compared before doing
|
||||
.It Va INSTALL
|
||||
.Vt ( str )
|
||||
the default install command.
|
||||
To have commands compared before doing
|
||||
the install, use
|
||||
.Bd -literal -offset indent
|
||||
INSTALL="install -C"
|
||||
.Ed
|
||||
.It Ar LOCAL_DIRS
|
||||
(str) List any directories that should be entered when doing
|
||||
.It Va LOCAL_DIRS
|
||||
.Vt ( str )
|
||||
List any directories that should be entered when doing
|
||||
make's in
|
||||
.Pa /usr/src
|
||||
.Pa /usr/src
|
||||
in this variable.
|
||||
.It Ar MTREE_FOLLOWS_SYMLINKS
|
||||
(str) Set this to
|
||||
.Dq Li -L
|
||||
to cause mtree to follow symlinks.
|
||||
.It Ar NO_DOCUPDATE
|
||||
(bool) Set this to not update the doc tree during
|
||||
.Cm "make update" .
|
||||
.It Ar NO_PORTSUPDATE
|
||||
(bool) Set this to not update the ports tree during
|
||||
.Cm "make update" .
|
||||
.It Ar SUP_UPDATE
|
||||
(bool) Set this to use cvsup to update your ports with
|
||||
.Cm "make update" .
|
||||
.It Ar SUP
|
||||
(str) The location of the cvsup command for
|
||||
.Cm "make update" .
|
||||
.It Ar SUPFLAGS
|
||||
(str) The flag for the sup command when doing
|
||||
.Cm "make update" .
|
||||
This defaults to
|
||||
.Op "-g -L 2" .
|
||||
.It Ar SUPHOST
|
||||
(str) The hostname of the sup server to use when doing
|
||||
.Cm "make update" .
|
||||
.It Ar SUPFILE
|
||||
(str) The first supfile to use when doing a
|
||||
.Cm "make update" .
|
||||
.It Va MTREE_FOLLOWS_SYMLINKS
|
||||
.Vt ( str )
|
||||
Set this to
|
||||
.Dq Fl L
|
||||
to cause
|
||||
.Xr mtree 8
|
||||
to follow symlinks.
|
||||
.It Va NO_DOCUPDATE
|
||||
.Vt ( bool )
|
||||
Set this to not update the doc tree during
|
||||
.Dq Li "make update" .
|
||||
.It Va NO_PORTSUPDATE
|
||||
.Vt ( bool )
|
||||
Set this to not update the ports tree during
|
||||
.Dq Li "make update" .
|
||||
.It Va SUP_UPDATE
|
||||
.Vt ( bool )
|
||||
Set this to use
|
||||
.Xr cvsup 1
|
||||
to update your ports with
|
||||
.Dq Li "make update" .
|
||||
.It Va SUP
|
||||
.Vt ( str )
|
||||
The location of the
|
||||
.Xr cvsup 1
|
||||
command for
|
||||
.Dq Li "make update" .
|
||||
.It Va SUPFLAGS
|
||||
.Vt ( str )
|
||||
The flag for the
|
||||
.Xr sup 1
|
||||
command when doing
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/standard-supfile .
|
||||
.It Ar SUPFILE1
|
||||
(str) The second supfile to use when doing a
|
||||
.Cm "make update" .
|
||||
.Op Fl g L Ar 2 .
|
||||
.It Va SUPHOST
|
||||
.Vt ( str )
|
||||
The hostname of the sup server to use when doing
|
||||
.Dq Li "make update" .
|
||||
.It Va SUPFILE
|
||||
.Vt ( str )
|
||||
The first
|
||||
.Ar supfile
|
||||
to use when doing a
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/secure-supfile .
|
||||
.It Ar SUPFILE2
|
||||
(str) The third supfile to use when doing a
|
||||
.Cm "make update" .
|
||||
.Pa /usr/share/examples/cvsup/standard\-supfile .
|
||||
.It Va SUPFILE1
|
||||
.Vt ( str )
|
||||
The second
|
||||
.Ar supfile
|
||||
to use when doing a
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/secure-supfile .
|
||||
.It Ar PORTSSUPFILE
|
||||
(str) The ports supfile to use when doing a
|
||||
.Cm "make update" .
|
||||
.Pa /usr/share/examples/cvsup/secure\-supfile .
|
||||
.It Va SUPFILE2
|
||||
.Vt ( str )
|
||||
The third
|
||||
.Ar supfile
|
||||
to use when doing a
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/ports-supfile .
|
||||
.It Ar DOCSUPFILE
|
||||
(str) The documentation supfile to use when doing a
|
||||
.Cm "make update" .
|
||||
.Pa /usr/share/examples/cvsup/secure\-supfile .
|
||||
.It Va PORTSSUPFILE
|
||||
.Vt ( str )
|
||||
The ports
|
||||
.Ar supfile
|
||||
to use when doing a
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/doc-supfile .
|
||||
.Pa /usr/share/examples/cvsup/ports\-supfile .
|
||||
.It Va DOCSUPFILE
|
||||
.Vt ( str )
|
||||
The documentation
|
||||
.Ar supfile
|
||||
to use when doing a
|
||||
.Dq Li "make update" .
|
||||
This defaults to
|
||||
.Pa /usr/share/examples/cvsup/doc\-supfile .
|
||||
.El
|
||||
.Pp
|
||||
The following list provides a name and short description for variables
|
||||
that are only used doing a kernel build:
|
||||
.Bl -tag -width Ar
|
||||
.It Ar BOOT_COMCONSOLE_PORT
|
||||
(str) The port address to use for the console if the boot blocks have
|
||||
.It Va BOOT_COMCONSOLE_PORT
|
||||
.Vt ( str )
|
||||
The port address to use for the console if the boot blocks have
|
||||
been configured to use a serial console instead of the keyboard/video card.
|
||||
.It Ar BOOT_COMCONSOLE_SPEED
|
||||
(int) The baud rate to use for the console if the boot blocks have
|
||||
.It Va BOOT_COMCONSOLE_SPEED
|
||||
.Vt ( int )
|
||||
The baud rate to use for the console if the boot blocks have
|
||||
been configured to use a serial console instead of the keyboard/video card.
|
||||
.It Ar BOOTWAIT
|
||||
(int) Controls the amount of time the kernel waits for a console keypress
|
||||
before booting the default kernel. The value is approximately
|
||||
milliseconds. Keypresses are accepted by the BIOS before booting from disk,
|
||||
.It Va BOOTWAIT
|
||||
.Vt ( int )
|
||||
Controls the amount of time the kernel waits for a console keypress
|
||||
before booting the default kernel.
|
||||
The value is approximately milliseconds.
|
||||
Keypresses are accepted by the BIOS before booting from disk,
|
||||
making it possible to give custom boot parameters even when this is
|
||||
set to 0.
|
||||
.It Ar COPTFLAGS
|
||||
(str) Controls the compiler settings when building the
|
||||
kernel. Optimization levels above
|
||||
.Op -O ( -O2 , ...\& )
|
||||
.It Va COPTFLAGS
|
||||
.Vt ( str )
|
||||
Controls the compiler settings when building the
|
||||
kernel.
|
||||
Optimization levels above
|
||||
.Oo Fl O ( O2 , No ...\& ) Oc
|
||||
are not supported.
|
||||
.It Ar KERNEL
|
||||
(str) Controls which kernel configurations will be
|
||||
.It Va KERNEL
|
||||
.Vt ( str )
|
||||
Controls which kernel configurations will be
|
||||
built by
|
||||
.Cm "${MAKE} buildkernel"
|
||||
and installed by
|
||||
.Cm "${MAKE} installkernel" .
|
||||
.Dq Li "${MAKE} buildkernel"
|
||||
and installed by
|
||||
.Dq Li "${MAKE} installkernel" .
|
||||
For example,
|
||||
.Bd -literal -offset indent
|
||||
KERNEL=MINE DEBUG GENERIC OTHERMACHINE
|
||||
.Ed
|
||||
.Pp
|
||||
will build the the kernels specified by the config files
|
||||
.Pa MINE , DEBUG , GENERIC ,
|
||||
and
|
||||
@ -204,151 +270,251 @@ and install the kernel specified by the config file
|
||||
.Pa MINE .
|
||||
It defaults to
|
||||
.Pa GENERIC .
|
||||
.It Ar NO_KERNELCONFIG
|
||||
(bool) Set this to skip running
|
||||
.It Va NO_KERNELCONFIG
|
||||
.Vt ( bool )
|
||||
Set this to skip running
|
||||
.Xr config 8
|
||||
during
|
||||
.Cm "${MAKE} buildkernel" .
|
||||
.It Ar NO_KERNELDEPEND
|
||||
(bool) Set this to skip running
|
||||
.Cm "${MAKE} depend"
|
||||
.Dq Li "${MAKE} buildkernel" .
|
||||
.It Va NO_KERNELDEPEND
|
||||
.Vt ( bool )
|
||||
Set this to skip running
|
||||
.Dq Li "${MAKE} depend"
|
||||
during
|
||||
.Cm "${MAKE} buildkernel" .
|
||||
.It Ar NO_MODULES
|
||||
(bool) Set to not build modules with the kernel.
|
||||
.Dq Li "${MAKE} buildkernel" .
|
||||
.It Va NO_MODULES
|
||||
.Vt ( bool )
|
||||
Set to not build modules with the kernel.
|
||||
.El
|
||||
.Pp
|
||||
The following list provides a name and short description for variables
|
||||
that are used during the world build:
|
||||
.Bl -tag -width Ar
|
||||
.It Ar COMPAT1X
|
||||
(bool) Set to install the
|
||||
.It Va COMPAT1X
|
||||
.Vt ( bool )
|
||||
Set to install the
|
||||
.Fx
|
||||
1 compatibility libraries.
|
||||
.It Ar COMPAT20
|
||||
(bool) Set to install the
|
||||
.It Va COMPAT20
|
||||
.Vt ( bool )
|
||||
Set to install the
|
||||
.Fx 2.0
|
||||
compatibility libraries.
|
||||
.It Ar COMPAT21
|
||||
(bool) Set to install the
|
||||
.It Va COMPAT21
|
||||
.Vt ( bool )
|
||||
Set to install the
|
||||
.Fx 2.1
|
||||
compatibility libraries.
|
||||
.It Ar COMPAT22
|
||||
(bool) Set to install the
|
||||
.It Va COMPAT22
|
||||
.Vt ( bool )
|
||||
Set to install the
|
||||
.Fx 2.2
|
||||
compatibility libraries.
|
||||
.It Ar COMPAT3X
|
||||
(bool) Set to install the
|
||||
.It Va COMPAT3X
|
||||
.Vt ( bool )
|
||||
Set to install the
|
||||
.Fx
|
||||
3 compatibility libraries.
|
||||
.It Ar ENABLE_SUIDPERL
|
||||
(bool) Set to enable the installation of an suid perl binary.
|
||||
.It Ar FETCH_CMD
|
||||
(str) Command to use to fetch files. Normally
|
||||
3
|
||||
compatibility libraries.
|
||||
.It Va ENABLE_SUIDPERL
|
||||
.Vt ( bool )
|
||||
Set to enable the installation of an suid
|
||||
.Xr perl 1
|
||||
binary.
|
||||
.It Va FETCH_CMD
|
||||
.Vt ( str )
|
||||
Command to use to fetch files.
|
||||
Normally
|
||||
.Xr fetch 1 .
|
||||
.It Ar MAKE_IDEA
|
||||
(bool) Set to build the IDEA encryption code. This code is patented in
|
||||
the USA and many european countries. It is
|
||||
.It Va MAKE_IDEA
|
||||
.Vt ( bool )
|
||||
Set to build the IDEA encryption code.
|
||||
This code is patented in the USA and many European countries.
|
||||
It is
|
||||
.Em "YOUR RESPONSIBILITY"
|
||||
to determine if you can legally use IDEA.
|
||||
.It Ar MAKE_KERBEROS4
|
||||
(bool) Set this to build KerberosIV (KTH eBones).
|
||||
.It Ar MAKE_KERBEROS5
|
||||
(bool) Set this to build Kerberos5 (KTH Heimdal).
|
||||
.It Va MAKE_KERBEROS4
|
||||
.Vt ( bool )
|
||||
Set this to build KerberosIV (KTH eBones).
|
||||
.It Va MAKE_KERBEROS5
|
||||
.Vt ( bool )
|
||||
Set this to build Kerberos5 (KTH Heimdal).
|
||||
.Em WARNING!
|
||||
This is still experimental code. If you need stable Kerberos5, use the
|
||||
This is still experimental code.
|
||||
If you need stable Kerberos5, use the
|
||||
port(s).
|
||||
.It Ar MODULES_WITH_WORLD
|
||||
(bool) Set to build modules with the system instead of the kernel.
|
||||
.It Ar NO_CVS
|
||||
(bool) Set to not build CVS.
|
||||
.It Ar NO_BIND
|
||||
(bool) Set to not build BIND.
|
||||
.It Ar NO_FORTRAN
|
||||
(bool) Set to not build g77 and related libraries.
|
||||
.It Ar NO_LPR
|
||||
(bool) Set to not build lpr and related programs.
|
||||
.It Ar NO_MAILWRAPPER
|
||||
(bool) Set to not build the mailwrapper(8) MTA selector.
|
||||
.It Ar NO_MAKEDEV
|
||||
(bool) Set to avoid running MAKEDEV all on /dev during install.
|
||||
.It Ar NO_OBJC
|
||||
(bool) Set to not build Objective C support.
|
||||
.It Ar NO_OPENSSH
|
||||
(bool) Set to not build OpenSSH.
|
||||
.It Ar NO_OPENSSL
|
||||
(bool) Set to not build OpenSSL (implies NO_OPENSSH).
|
||||
.It Ar NO_SENDMAIL
|
||||
(bool) Set to not build sendmail and related programs.
|
||||
.It Ar NO_SHAREDOCS
|
||||
(bool) Set to not build the 4.4BSD legacy docs.
|
||||
.It Ar NO_TCSH
|
||||
(bool) Set to not build and install /bin/csh (which is tcsh).
|
||||
.It Ar NO_X
|
||||
(bool) Set to not compile in XWindows support (e.g. doscmd).
|
||||
.It Ar NOCLEAN
|
||||
(bool) Set this to disable cleaning during
|
||||
.Cm "make buildworld" .
|
||||
.It Va MODULES_WITH_WORLD
|
||||
.Vt ( bool )
|
||||
Set to build modules with the system instead of the kernel.
|
||||
.It Va NO_CVS
|
||||
.Vt ( bool )
|
||||
Set to not build CVS.
|
||||
.It Va NO_BIND
|
||||
.Vt ( bool )
|
||||
Set to not build BIND.
|
||||
.It Va NO_FORTRAN
|
||||
.Vt ( bool )
|
||||
Set to not build
|
||||
.Xr g77 1
|
||||
and related libraries.
|
||||
.It Va NO_LPR
|
||||
.Vt ( bool )
|
||||
Set to not build
|
||||
.Xr lpr 1
|
||||
and related programs.
|
||||
.It Va NO_MAILWRAPPER
|
||||
.Vt ( bool )
|
||||
Set to not build the
|
||||
.Xr mailwrapper 8
|
||||
MTA selector.
|
||||
.It Va NO_MAKEDEV
|
||||
.Vt ( bool )
|
||||
Set to avoid running
|
||||
.Dq Li "MAKEDEV all"
|
||||
on
|
||||
.Pa /dev
|
||||
during install.
|
||||
.It Va NO_OBJC
|
||||
.Vt ( bool )
|
||||
Set to not build Objective C support.
|
||||
.It Va NO_OPENSSH
|
||||
.Vt ( bool )
|
||||
Set to not build OpenSSH.
|
||||
.It Va NO_OPENSSL
|
||||
.Vt ( bool )
|
||||
Set to not build OpenSSL (implies
|
||||
.Va NO_OPENSSH ) .
|
||||
.It Va NO_SENDMAIL
|
||||
.Vt ( bool )
|
||||
Set to not build
|
||||
.Xr sendmail 8
|
||||
and related programs.
|
||||
.It Va NO_SHAREDOCS
|
||||
.Vt ( bool )
|
||||
Set to not build the
|
||||
.Bx 4.4
|
||||
legacy docs.
|
||||
.It Va NO_TCSH
|
||||
.Vt ( bool )
|
||||
Set to not build and install
|
||||
.Pa /bin/csh
|
||||
(which is
|
||||
.Xr tcsh 1 ) .
|
||||
.It Va NO_X
|
||||
.Vt ( bool )
|
||||
Set to not compile in X\-Windows support (e.g.\&
|
||||
.Xr doscmd 1 ) .
|
||||
.It Va NOCLEAN
|
||||
.Vt ( bool )
|
||||
Set this to disable cleaning during
|
||||
.Dq Li "make buildworld" .
|
||||
This should not be set unless you know what you are doing.
|
||||
.It Ar NOCLEANDIR
|
||||
(bool) Set this to run
|
||||
.Cm "${MAKE} clean"
|
||||
.It Va NOCLEANDIR
|
||||
.Vt ( bool )
|
||||
Set this to run
|
||||
.Dq Li "${MAKE} clean"
|
||||
instead of
|
||||
.Cm "${MAKE} cleandir" .
|
||||
.It Ar NOCRYPT
|
||||
(bool) Set to not build any crypto code.
|
||||
.It Ar NOGAMES
|
||||
(bool) Set to not build games.
|
||||
.It Ar NOINFO
|
||||
(bool) Set to not make or install info files.
|
||||
.It Ar NOLIBC_R
|
||||
(bool) Set to not build libc_r (re-entrant version of libc).
|
||||
.It Ar NOMANCOMPRESS
|
||||
(bool) Set to install man pages uncompressed.
|
||||
.It Ar NOPERL
|
||||
(bool) Set to avoid building perl.
|
||||
.It Ar NOPROFILE
|
||||
(bool) Set to avoid compiling profiled libraries.
|
||||
.It Ar NOSECURE
|
||||
(bool) set to not build crypto code in secure subdir.
|
||||
.It Ar NOSHARE
|
||||
(bool) Set to not build in the share subdir.
|
||||
.It Ar NOUUCP
|
||||
(bool) Set to not build uucp related programs.
|
||||
.It Ar PERL_THREADED
|
||||
(bool) Set to enable the building and installation of perl with thread
|
||||
.Dq Li "${MAKE} cleandir" .
|
||||
.It Va NOCRYPT
|
||||
.Vt ( bool )
|
||||
Set to not build any crypto code.
|
||||
.It Va NOGAMES
|
||||
.Vt ( bool )
|
||||
Set to not build games.
|
||||
.It Va NOINFO
|
||||
.Vt ( bool )
|
||||
Set to not make or install
|
||||
.Xr info 5
|
||||
files.
|
||||
.It Va NOLIBC_R
|
||||
.Vt ( bool )
|
||||
Set to not build
|
||||
.Nm libc_r
|
||||
(reentrant version of
|
||||
.Nm libc ) .
|
||||
.It Va NOMANCOMPRESS
|
||||
.Vt ( bool )
|
||||
Set to install man pages uncompressed.
|
||||
.It Va NOPERL
|
||||
.Vt ( bool )
|
||||
Set to avoid building
|
||||
.Xr perl 1 .
|
||||
.It Va NOPROFILE
|
||||
.Vt ( bool )
|
||||
Set to avoid compiling profiled libraries.
|
||||
.It Va NOSECURE
|
||||
.Vt ( bool )
|
||||
set to not build crypto code in
|
||||
.Pa secure
|
||||
subdir.
|
||||
.It Va NOSHARE
|
||||
.Vt ( bool )
|
||||
Set to not build in the
|
||||
.Pa share
|
||||
subdir.
|
||||
.It Va NOUUCP
|
||||
.Vt ( bool )
|
||||
Set to not build
|
||||
.Xr uucp 1
|
||||
related programs.
|
||||
.It Va PERL_THREADED
|
||||
.Vt ( bool )
|
||||
Set to enable the building and installation of
|
||||
.Xr perl 1
|
||||
with thread
|
||||
support.
|
||||
.It Ar PPP_NOSUID
|
||||
(bool) Set to disable the installation of ppp as an suid root program.
|
||||
.It Ar SENDMAIL_CFLAGS
|
||||
(str) Flags to pass to the compile command when building sendmail. The
|
||||
sendmail flags can be used to provide SASL support with setting such as:
|
||||
.It Va PPP_NOSUID
|
||||
.Vt ( bool )
|
||||
Set to disable the installation of
|
||||
.Xr ppp 8
|
||||
as an suid root program.
|
||||
.It Va SENDMAIL_CFLAGS
|
||||
.Vt ( str )
|
||||
Flags to pass to the compile command when building
|
||||
.Xr sendmail 8 .
|
||||
The
|
||||
.Va SENDMAIL_*
|
||||
flags can be used to provide SASL support with setting such as:
|
||||
.Bd -literal -offset indent
|
||||
SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
|
||||
SENDMAIL_LDFLAGS=-L/usr/local/lib
|
||||
SENDMAIL_LDADD=-lsasl
|
||||
.Ed
|
||||
.It Ar SENDMAIL_LDFLAGS
|
||||
(str) Flags to pass to the ld command when building sendmail.
|
||||
.It Ar SENDMAIL_LDADD
|
||||
(str) Flags to add to the end of the ld command when building sendmail.
|
||||
.It Ar SENDMAIL_DPADD
|
||||
(str) This variable is undocumented.
|
||||
.It Va SENDMAIL_LDFLAGS
|
||||
.Vt ( str )
|
||||
Flags to pass to the
|
||||
.Xr ld 1
|
||||
command when building
|
||||
.Xr sendmail 8 .
|
||||
.It Va SENDMAIL_LDADD
|
||||
.Vt ( str )
|
||||
Flags to add to the end of the
|
||||
.Xr ld 1
|
||||
command when building
|
||||
.Xr sendmail 8 .
|
||||
.It Va SENDMAIL_DPADD
|
||||
.Vt ( str )
|
||||
This variable is undocumented.
|
||||
.El
|
||||
.Pp
|
||||
The following list provides a name and short description for variables
|
||||
that are used when building documentation.
|
||||
.Bl -tag -width Ar
|
||||
.It Ar DISTDIR
|
||||
(str) Where distfiles are kept. Normally, this is
|
||||
.It Va DISTDIR
|
||||
.Vt ( str )
|
||||
Where distfiles are kept.
|
||||
Normally, this is
|
||||
.Pa distfiles
|
||||
in
|
||||
.Ev PORTSDIR .
|
||||
.It Ar DOC_LANG
|
||||
(str) The list of languages and encodings to build and install.
|
||||
.It Ar PRINTERDEVICE
|
||||
(str) The default format for system documentation, depends on your
|
||||
printer. This can be set to
|
||||
.Va PORTSDIR .
|
||||
.It Va DOC_LANG
|
||||
.Vt ( str )
|
||||
The list of languages and encodings to build and install.
|
||||
.It Va PRINTERDEVICE
|
||||
.Vt ( str )
|
||||
The default format for system documentation, depends on your
|
||||
printer.
|
||||
This can be set to
|
||||
.Dq Li ascii
|
||||
for simple printers or
|
||||
.Dq Li ps
|
||||
@ -359,139 +525,200 @@ filter.
|
||||
The following list provides a name and short description for variables
|
||||
that are used when building ports:
|
||||
.Bl -tag -width Ar
|
||||
.It Ar FORCE_PKG_RESIDENT
|
||||
(bool) Set this to override any existing package registration.
|
||||
.It Ar HAVE_MOTIF
|
||||
(bool) Set this if you have Motif on your system.
|
||||
.It Ar KRB5_HOME
|
||||
(str) Set this if you want to install the MIT Kerberos5 port somewhere
|
||||
.It Va FORCE_PKG_RESIDENT
|
||||
.Vt ( bool )
|
||||
Set this to override any existing package registration.
|
||||
.It Va HAVE_MOTIF
|
||||
.Vt ( bool )
|
||||
Set this if you have Motif on your system.
|
||||
.It Va KRB5_HOME
|
||||
.Vt ( str )
|
||||
Set this if you want to install the MIT Kerberos5 port somewhere
|
||||
other than
|
||||
.Pa /usr/local .
|
||||
.It Ar LOCALBASE
|
||||
(str) Set this to the base directory that non-X ports should be
|
||||
installed in. It provides the default for PREFIX when building in
|
||||
.It Va LOCALBASE
|
||||
.Vt ( str )
|
||||
Set this to the base directory that non\-X ports should be
|
||||
installed in.
|
||||
It provides the default for
|
||||
.Va PREFIX
|
||||
when building in
|
||||
.Pa /usr/ports .
|
||||
.It Ar MASTER_SITE_AFTERSTEP
|
||||
(str) Set this to change the master site for AfterStep ports. The last
|
||||
.It Va MASTER_SITE_AFTERSTEP
|
||||
.Vt ( str )
|
||||
Set this to change the master site for AfterStep ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_BACKUP
|
||||
(str) Controls the site location that ports check for distfiles if the
|
||||
locations listed in their
|
||||
.It Va MASTER_SITE_BACKUP
|
||||
.Vt ( str )
|
||||
Controls the site location that ports check for distfiles if the
|
||||
locations listed in their
|
||||
.Pa Makefile
|
||||
do not work. The last part of the path must be
|
||||
do not work.
|
||||
The last part of the path must be
|
||||
.Dq Li /${DIST_SUBDIR}/ .
|
||||
.It Ar MASTER_SITE_COMP_SOURCES
|
||||
(str) Controls the master site location for comp.sources ports. The
|
||||
.It Va MASTER_SITE_COMP_SOURCES
|
||||
.Vt ( str )
|
||||
Controls the master site location for
|
||||
.Pa comp.sources
|
||||
ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Dq Li %SUBDIR%/
|
||||
.It Ar MASTER_SITE_GNOME
|
||||
(str) Controls the master site location for GNOME ports. The
|
||||
.It Va MASTER_SITE_GNOME
|
||||
.Vt ( str )
|
||||
Controls the master site location for GNOME ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Dq Li /%SUBDIR%/
|
||||
.It Ar MASTER_SITE_GNU
|
||||
(str) Controls the master site location for GNU ports. The
|
||||
.It Va MASTER_SITE_GNU
|
||||
.Vt ( str )
|
||||
Controls the master site location for GNU ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Dq Li /%SUBDIR%/
|
||||
.It Ar MASTER_SITE_KDE
|
||||
(str) Controls the master site location for KDE ports. The
|
||||
.It Va MASTER_SITE_KDE
|
||||
.Vt ( str )
|
||||
Controls the master site location for KDE ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Dq Li /%SUBDIR%/
|
||||
.It Ar MASTER_SITE_FREEBSD
|
||||
(bool) If set, go to the master
|
||||
.It Va MASTER_SITE_FREEBSD
|
||||
.Vt ( bool )
|
||||
If set, go to the master
|
||||
.Fx
|
||||
site for all files.
|
||||
.It Ar MASTER_SITE_MOZILLA
|
||||
(str) Controls the master site location for Mozilla ports. The
|
||||
.It Va MASTER_SITE_MOZILLA
|
||||
.Vt ( str )
|
||||
Controls the master site location for Mozilla ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Dq Li /%SUBDIR%/
|
||||
.It Ar MASTER_SITE_OVERRIDE
|
||||
(str) If set, this site is checked before the sites listed in the ports
|
||||
.It Va MASTER_SITE_OVERRIDE
|
||||
.Vt ( str )
|
||||
If set, this site is checked before the sites listed in the ports
|
||||
.Pa Makefile .
|
||||
You can have it check the backup site first by like so:
|
||||
.Bd -literal -offset indent
|
||||
MASTER_SITE_OVERRIDE?= ${MASTER_SITE_BACKUP}
|
||||
.Ed
|
||||
.It Ar MASTER_SITE_PERL_CPAN
|
||||
(str) Controls the master site location for Perl ports. The
|
||||
.It Va MASTER_SITE_PERL_CPAN
|
||||
.Vt ( str )
|
||||
Controls the master site location for Perl ports.
|
||||
The
|
||||
last part of the path must be
|
||||
.Bd -literal -offset indent
|
||||
/%SUBDIR%/
|
||||
.Ed
|
||||
.It Ar MASTER_SORT_REGEX
|
||||
(str) Set this to control the sort order for mirror sets. To set it to
|
||||
prefer mirrors in the .jp domain, use:
|
||||
.It Va MASTER_SORT_REGEX
|
||||
.Vt ( str )
|
||||
Set this to control the sort order for mirror sets.
|
||||
To set it to
|
||||
prefer mirrors in the
|
||||
.Pa .jp
|
||||
domain, use:
|
||||
.Bd -literal -offset indent
|
||||
MASTER_SORT_REGEX?= ^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\.
|
||||
.Ed
|
||||
Users of other ccTLD domins should change the
|
||||
.Pp
|
||||
Users of other ccTLD domains should change the
|
||||
.Dq Li jp
|
||||
to the
|
||||
appropriate domain.
|
||||
.It Ar MASTER_SITE_RINGSERVER
|
||||
(str) Controls the master site location for Ringserver ports. The last
|
||||
.It Va MASTER_SITE_RINGSERVER
|
||||
.Vt ( str )
|
||||
Controls the master site location for Ringserver ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_RUBY
|
||||
(str) Controls the master site location for Ruby ports. The last
|
||||
.It Va MASTER_SITE_RUBY
|
||||
.Vt ( str )
|
||||
Controls the master site location for Ruby ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_SUNSITE
|
||||
(str) Controls the master site location for Sunsite ports. The last
|
||||
.It Va MASTER_SITE_SUNSITE
|
||||
.Vt ( str )
|
||||
Controls the master site location for Sunsite ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_TCLTK
|
||||
(str) Controls the master site location for Tcl and Tk ports. The last
|
||||
.It Va MASTER_SITE_TCLTK
|
||||
.Vt ( str )
|
||||
Controls the master site location for Tcl and Tk ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_TEX_CTAN
|
||||
(str) Controls the master site location for TeX ports. The last
|
||||
.It Va MASTER_SITE_TEX_CTAN
|
||||
.Vt ( str )
|
||||
Controls the master site location for TeX ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_WINDOWMAKER
|
||||
(str) Controls the master site location for WindowMaker ports. The last
|
||||
.It Va MASTER_SITE_WINDOWMAKER
|
||||
.Vt ( str )
|
||||
Controls the master site location for WindowMaker ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_XCONTRIB
|
||||
(str) Controls the master site location for contributed X ports. The last
|
||||
.It Va MASTER_SITE_XCONTRIB
|
||||
.Vt ( str )
|
||||
Controls the master site location for contributed X ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_XEMACS
|
||||
(str) Controls the master site location for Xemacs ports. The last
|
||||
.It Va MASTER_SITE_XEMACS
|
||||
.Vt ( str )
|
||||
Controls the master site location for Xemacs ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MASTER_SITE_XFREE
|
||||
(str) Controls the master site location for XFree ports. The last
|
||||
.It Va MASTER_SITE_XFREE
|
||||
.Vt ( str )
|
||||
Controls the master site location for XFree ports.
|
||||
The last
|
||||
part of the path must be
|
||||
.Dq Li /%SUBDIR%/ .
|
||||
.It Ar MOTIFLIB
|
||||
(str) Location of
|
||||
.It Va MOTIFLIB
|
||||
.Vt ( str )
|
||||
Location of
|
||||
.Pa libXm.a
|
||||
and
|
||||
.Pa libXm.so .
|
||||
.It Ar MOTIF_STATIC
|
||||
(bool) Set this if you want ports that use Motif to be built so they
|
||||
.It Va MOTIF_STATIC
|
||||
.Vt ( bool )
|
||||
Set this if you want ports that use Motif to be built so they
|
||||
can be run on systems without the Motif shared libraries.
|
||||
.It Ar NOCLEANDEPENDS
|
||||
(bool) Set this to prevent
|
||||
.Cm "make clean"
|
||||
.It Va NOCLEANDEPENDS
|
||||
.Vt ( bool )
|
||||
Set this to prevent
|
||||
.Dq Li "make clean"
|
||||
from cleaning the ports that the one being cleaned depends on.
|
||||
.It Ar NOPORTDOCS
|
||||
(bool) Set this to disable installing additional documentation with ports.
|
||||
.It Ar PACKAGES
|
||||
(str) Used only for the package target; the directory for the package tree.
|
||||
.It Ar PATCH_SITES
|
||||
(str) Primary location(s) for the distribution of patch files.
|
||||
.It Ar PORTSDIR
|
||||
(str) The location of the ports tree.
|
||||
.It Ar USA_RESIDENT
|
||||
(bool) Set this if you are a resident of the USA so that ports that
|
||||
need to can attemp to comply with U.S. export regulations.
|
||||
.It Ar WRKDIRPREFIX
|
||||
(str) Where to create temporary files used when building ports.
|
||||
.It Ar X11BASE
|
||||
(str) Should be set to where the X11 distribution has been
|
||||
installed if it is installed anywhere other than /usr/X11R6.
|
||||
.It Va NOPORTDOCS
|
||||
.Vt ( bool )
|
||||
Set this to disable installing additional documentation with ports.
|
||||
.It Va PACKAGES
|
||||
.Vt ( str )
|
||||
Used only for the package target; the directory for the package tree.
|
||||
.It Va PATCH_SITES
|
||||
.Vt ( str )
|
||||
Primary location(s) for the distribution of patch files.
|
||||
.It Va PORTSDIR
|
||||
.Vt ( str )
|
||||
The location of the ports tree.
|
||||
.It Va USA_RESIDENT
|
||||
.Vt ( bool )
|
||||
Set this if you are a resident of the USA so that ports that
|
||||
need to can attempt to comply with U.S. export regulations.
|
||||
.It Va WRKDIRPREFIX
|
||||
.Vt ( str )
|
||||
Where to create temporary files used when building ports.
|
||||
.It Va X11BASE
|
||||
.Vt ( str )
|
||||
Should be set to where the X11 distribution has been
|
||||
installed if it is installed anywhere other than
|
||||
.Pa /usr/X11R6 .
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width /etc/defaults/make.conf -compact
|
||||
@ -517,6 +744,8 @@ The
|
||||
file appeared sometime before
|
||||
.Fx 4.0 .
|
||||
.Sh AUTHORS
|
||||
This
|
||||
manual page was written by
|
||||
.An Mike W. Meyer Aq mwm@mired.org .
|
||||
.Sh BUGS
|
||||
This manual page may occasionally be out of date with respect to
|
||||
|
Loading…
x
Reference in New Issue
Block a user