Fix wording.
[dragonfly.git] / etc / defaults / make.conf
CommitLineData
984263bc 1# $FreeBSD: src/etc/defaults/make.conf,v 1.97.2.80 2003/02/15 16:34:56 trhodes Exp $
4eada58b 2# $DragonFly: src/etc/defaults/make.conf,v 1.16 2005/12/09 23:55:28 swildner Exp $
984263bc
MD
3#
4# NOTE: Please would any committer updating this file also update the
5# make.conf(5) manual page, if necessary, which is located in
6# src/share/man/man5/make.conf.5.
7#
8# This file, if present, will be read by make (see /usr/share/mk/sys.mk).
9# It allows you to override macro definitions to make without changing
10# your source tree, or anything the source tree installs.
11#
12# This file must be in valid Makefile syntax.
13#
14# You have to find the things you can put here in the Makefiles and
15# documentation of the source tree.
16#
984263bc
MD
17# The CPUTYPE variable controls which processor should be targeted for
18# generated code. This controls processor-specific optimizations in
19# certain code (currently only OpenSSL) as well as modifying the value
20# of CFLAGS to contain the appropriate optimization directive to gcc.
21# The automatic setting of CFLAGS may be overridden using the
22# NO_CPU_CFLAGS variable below.
23# Currently the following CPU types are recognized:
24# Intel x86 architecture:
25# (AMD CPUs) k7 k6-2 k6 k5
26# (Intel CPUs) p4 p3 p2 i686 i586/mmx i586 i486 i386
984263bc
MD
27#
28# If you experience any problems after setting this flag, please unset
29# it again before submitting a bug report or attempting to modify code.
30# It may be that certain types of software will become unstable after being
31# compiled with processor-specific (or higher - see below) optimization flags.
32# If in doubt, do not set CPUTYPE or CFLAGS to non-default values.
33#
34#CPUTYPE=i686
35#NO_CPU_CFLAGS= true # Don't add -march=<cpu> to CFLAGS automatically
36#NO_CPU_COPTFLAGS=true # Don't add -march=<cpu> to COPTFLAGS automatically
37#
dfa77fe6
MD
38# The CCVER variable controls which GCC-version to use by default. It
39# should be set using ?= so as not to interfere with CCVER overrides from
40# userland or the buildworld. We currently recommend that an override NOT
41# be set in /etc/make.conf and that gcc 3.4 not yet be used to build the boot
42# blocks, boot loader, or the kernel.
43#
cecff5c1
MD
44#CCVER?=gcc34 # (use GCC 3.4, default)
45#CCVER?=gcc40 # (use GCC 4.0, experimental, must define WANT_GCC40)
29d48e65
SS
46#
47# Build gcc40 with world. This won't make gcc40 the default compiler
29d48e65 48#WANT_GCC40=yes
dfa77fe6 49#
984263bc
MD
50# CFLAGS controls the compiler settings used when compiling C code.
51# Note that optimization settings above -O (-O2, ...) are not recommended
52# or supported for compiling the world or the kernel - please revert any
53# nonstandard optimization settings to "-O" before submitting bug reports
54# to the developers.
984263bc
MD
55#
56#CFLAGS= -O -pipe
57#
58# CXXFLAGS controls the compiler settings used when compiling C++ code.
59# Note that CXXFLAGS is initially set to the value of CFLAGS. If you wish
60# to add to CXXFLAGS value, "+=" must be used rather than "=". Using "="
61# alone will remove the often needed contents of CFLAGS from CXXFLAGS.
62#
63#CXXFLAGS+= -fmemoize-lookups -fsave-memoized
64#
65# BDECFLAGS are a set of gcc warning settings that Bruce Evans has suggested
66# for use in developing FreeBSD and testing changes. They can be used by
67# putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf. -Wconversion is not
68# included here due to compiler bugs, e.g., mkdir()'s mode_t argument.
69#
70BDECFLAGS= -W -Wall -ansi -pedantic -Wbad-function-cast -Wcast-align \
71 -Wcast-qual -Wchar-subscripts -Winline \
72 -Wmissing-prototypes -Wnested-externs -Wpointer-arith \
73 -Wredundant-decls -Wshadow -Wstrict-prototypes -Wwrite-strings
74#
75# WARNS_WERROR causes -Werror to be added when WARNS is in effect.
984263bc
MD
76#WARNS_WERROR= yes
77#
78# To compile just the kernel with special optimizations, you should use
79# this instead of CFLAGS (which is not applicable to kernel builds anyway).
80# There is very little to gain by using higher optimization levels, and doing
81# so can cause problems.
82#
83#COPTFLAGS= -O -pipe
84#
bb4f1f7e
JR
85# Strip the file before installing. Setting this to nothing will keep
86# the debugging symbols in the installed files.
87#STRIP= -s
88#
984263bc
MD
89# Compare before install
90#INSTALL=install -C
91#
984263bc
MD
92# To build ppp with normal permissions
93#PPP_NOSUID= true
94#
95# To enable installing ssh(1) with the setuid bit turned on
96#ENABLE_SUID_SSH= true
97#
98# To avoid building various parts of the base system:
984263bc 99#NO_BIND= true # do not build BIND
cecff5c1
MD
100#NO_CRYPT= true # do not build crypto code
101#NO_CVS= true # do not build CVS
984263bc 102#NO_FORTRAN= true # do not build g77 and related libraries
cecff5c1 103#NO_GAMES= true # do not enter the games subdirectory
984263bc
MD
104#NO_I4B= true # do not build isdn4bsd package
105#NO_IPFILTER= true # do not build IP Filter package
cecff5c1 106#NO_LIBC_R= true # do not build libc_r (re-entrant version of libc)
984263bc
MD
107#NO_LPR= true # do not build lpr and related programs
108#NO_MAILWRAPPER=true # do not build the mailwrapper(8) MTA selector
109#NO_MODULES= true # do not build modules with the kernel
110#NO_OBJC= true # do not build Objective C support
111#NO_OPENSSH= true # do not build OpenSSH
112#NO_OPENSSL= true # do not build OpenSSL (implies NO_OPENSSH)
2f62a144 113#NO_PKGTOOLS= true # do not build included package tools (for pkgsrc)
984263bc 114#NO_SENDMAIL= true # do not build sendmail and related programs
cecff5c1 115#NO_SHARE= true # do not enter the share subdirectory
984263bc 116#NO_X= true # do not compile in XWindows support (e.g. doscmd)
984263bc 117#NOINFO= true # do not make or install info files
cecff5c1 118#NOINFOCOMPRESS=true # do not compress info files
984263bc 119#NOMAN= true # do not build manual pages
cecff5c1 120#NOMANCOMPRESS= true # do not compress man pages
984263bc 121#NOPROFILE= true # Avoid compiling profiled libraries
984263bc 122#NOSHARE= true # do not go into the share subdir
984263bc
MD
123#
124# To build sys/modules when building the world (our old way of doing things)
125#MODULES_WITH_WORLD=true # do not build modules when building kernel
126#
127# The list of modules to build instead of all of them.
fdd814c0 128#MODULES_OVERRIDE= emulation/linux net/ipfw
984263bc 129#
cecff5c1
MD
130# To avoid running MAKEDEV all on /dev during install:
131#NO_MAKEDEV= true
132#
984263bc
MD
133# The following controls building optional IDEA code in libcrypto and
134# certain ports. Patents are involved - you must not use this unless
135# you either have a license or fall within patent 'fair use'
136# provisions.
137#
138# *** It is YOUR RESPONSIBILITY to determine if you can use this! ***
139#
140# IDEA is patented in the USA and many European countries - thought to
141# be OK to use for any non-commercial use. This is optional.
cecff5c1 142#WANT_IDEA= YES # IDEA (128 bit symmetric encryption)
984263bc
MD
143#
144# Default format for system documentation, depends on your printer.
145# Set this to "ascii" for simple printers or screen
146#
147#PRINTERDEVICE= ps
148#
984263bc
MD
149# By default, the system will always use the keyboard/video card as system
150# console. However, the boot blocks may be dynamically configured to use a
151# serial port in addition to or instead of the keyboard/video console.
152#
153# By default we use COM1 as our serial console port *if* we're going to use
154# a serial port as our console at all. Alter as necessary.
155#
156# COM1: = 0x3F8, COM2: = 0x2F8, COM3: = 0x3E8, COM4: = 0x2E8
157#
158#BOOT_COMCONSOLE_PORT= 0x3F8
159#
160# The default serial console speed is 9600. Set the speed to a larger value
161# for better interactive response.
162#
163#BOOT_COMCONSOLE_SPEED= 115200
164#
165# By default the 'pxeboot' loader retrieves the kernel via NFS. Defining
166# this and recompiling /usr/src/sys/boot will cause it to retrieve the kernel
167# via TFTP. This allows pxeboot to load a custom BOOTP diskless kernel yet
168# still mount the server's '/' (i.e. rather than load the server's kernel).
169#
170#LOADER_TFTP_SUPPORT= YES
171#
984263bc
MD
172# If you're behind a firewall and need FTP or HTTP proxy services for
173# ports collection fetching to work, the following examples give the
174# necessary syntax. See the fetch(3) man page for details.
175#
176#FETCH_ENV= FTP_PROXY=ftp://10.0.0.1:21
177#FETCH_ENV= HTTP_PROXY=http://10.0.0.1:80
178#
cecff5c1
MD
179# If you want Kerberos 5, define this.
180#WANT_KERBEROS= yes
984263bc 181#
984263bc
MD
182# If you want to use the k5su utility, define this to have it installed
183# set-user-ID.
184#ENABLE_SUID_K5SU= yes
185#
984263bc
MD
186# CVSup update flags. Edit SUPFILE settings to reflect whichever distribution
187# file(s) you use on your site (see /usr/share/examples/cvsup/README for more
188# information on CVSup and these files). To use, do "make update" in /usr/src.
189#
190#SUP_UPDATE= yes
984263bc
MD
191#SUP= /usr/local/bin/cvsup
192#SUPFLAGS= -g -L 2
cecff5c1
MD
193#SUPHOST= cvsup.dragonflybsd.org
194#SUPFILE= /usr/share/examples/cvsup/DragonFly-src-supfile
984263bc
MD
195#DOCSUPFILE= /usr/share/examples/cvsup/doc-supfile
196#
197# top(1) uses a hash table for the user names. The size of this hash
198# can be tuned to match the number of local users. The table size should
199# be a prime number approximately twice as large as the number of lines in
200# /etc/passwd. The default number is 20011.
201#
202#TOP_TABLE_SIZE= 101
203#
204# Documentation
205#
206# The list of languages and encodings to build and install
207#
208#DOC_LANG= en_US.ISO8859-1 ru_RU.KOI8-R
209#
984263bc
MD
210# sendmail
211#
212# The following sets the default m4 configuration file to use at
213# install time. Use with caution as a make install will overwrite
214# any existing /etc/mail/sendmail.cf. Note that SENDMAIL_CF is now
215# deprecated. The value should be a fully qualified path name.
216# Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
217# create /etc/mail/sendmail.cf before installworld installs an
218# updated sendmail binary.
219#
220#SENDMAIL_MC=/etc/mail/myconfig.mc
221#
222# The following sets the default m4 configuration file for mail
223# submission to use at install time. Use with caution as a make
224# install will overwrite any existing /etc/mail/submit.cf. The
225# value should be a fully qualified path name.
226# Avoid using a value of /etc/mail/submit.mc as a buildworld will
227# create /etc/mail/submit.cf before installworld installs an
228# updated sendmail binary.
229#
230#SENDMAIL_SUBMIT_MC=/etc/mail/mysubmit.mc
231#
232# If you need to build additional .cf files during a make buildworld,
233# include the full paths to the .mc files in SENDMAIL_ADDITIONAL_MC.
234# Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
235# create /etc/mail/sendmail.cf before installworld installs an
236# updated sendmail binary.
237#
238#SENDMAIL_ADDITIONAL_MC=/etc/mail/foo.mc /etc/mail/bar.mc
239#
240# Setting the following variable modifies the flags passed to m4 when
241# building a .cf file from a .mc file. It can be used to enable
242# features disabled by default.
243#
244#SENDMAIL_M4_FLAGS=
245#
246# Setting the following variables modifies the build environment for
247# sendmail and its related utilities. For example, SASL support can be
248# added with settings such as:
249#
250# with SASLv1:
251# SENDMAIL_CFLAGS=-I/usr/local/include/sasl1 -DSASL
252# SENDMAIL_LDFLAGS=-L/usr/local/lib
253# SENDMAIL_LDADD=-lsasl
254#
255# with SASLv2:
256# SENDMAIL_CFLAGS=-I/usr/local/include -DSASL=2
257# SENDMAIL_LDFLAGS=-L/usr/local/lib
258# SENDMAIL_LDADD=-lsasl2
259#
260# Note: If you are using Cyrus SASL with other applications which require
261# access to the sasldb file, you should add the following to your
262# sendmail.mc file:
263#
264# define(`confDONT_BLAME_SENDMAIL',`GroupReadableSASLDBFile')
265#
266#SENDMAIL_CFLAGS=
267#SENDMAIL_LDFLAGS=
268#SENDMAIL_LDADD=
269#SENDMAIL_DPADD=
270#
271# Setting SENDMAIL_SET_USER_ID will install the sendmail binary as a
272# set-user-ID root binary instead of a set-group-ID smmsp binary and will
273# prevent the installation of /etc/mail/submit.cf.
274# This is a deprecated mode of operation. See etc/mail/README for more
275# information.
276#
277#SENDMAIL_SET_USER_ID=
278#
279# The permissions to use on alias and map databases generated using
280# /etc/mail/Makefile. Defaults to 0640.
281#
282#SENDMAIL_MAP_PERMS=