Update default make.conf and its manpage:
[dragonfly.git] / etc / defaults / make.conf
1 # $FreeBSD: src/etc/defaults/make.conf,v 1.97.2.80 2003/02/15 16:34:56 trhodes Exp $
2 # $DragonFly: src/etc/defaults/make.conf,v 1.18 2006/09/10 20:53:21 swildner Exp $
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 #
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)      opteron athlon-fx athlon64 k8 k7 k6-3 k6-2 k6 k5
26 #       (Intel CPUs)    p4 p3 p2 i686 i586/mmx i586 i486
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 #
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.  Note that building world or the kernel using
41 # the experimental compiler might be broken at any time.  We currently
42 # recommend that an override NOT be set in /etc/make.conf.
43 #
44 #CCVER?=gcc34   # (use GCC 3.4, default)
45 #CCVER?=gcc40   # (use GCC 4.0, experimental, must define WANT_GCC40)
46 #
47 # Build gcc40 with world.  This won't make gcc40 the default compiler
48 #WANT_GCC40=yes
49
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.
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 #
70 BDECFLAGS=      -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.
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 #
85 # Strip the file before installing.  Setting this to nothing will keep
86 # the debugging symbols in the installed files.
87 #STRIP= -s
88 #
89 # Compare before install
90 #INSTALL=install -C
91 #
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 use bsdtar as the standard tar.  The default is GNU tar.
99 #WITH_BSDTAR=   true
100 #
101 # To avoid building various parts of the base system:
102 #NO_BIND=       true    # do not build BIND
103 #NO_CRYPT=      true    # do not build crypto code
104 #NO_CVS=        true    # do not build CVS
105 #NO_FORTRAN=    true    # do not build g77 and related libraries
106 #NO_GAMES=      true    # do not enter the games subdirectory
107 #NO_GDB=        true    # do not build GDB
108 #NO_I4B=        true    # do not build isdn4bsd package
109 #NO_IPFILTER=   true    # do not build IP Filter package
110 #NO_LIBC_R=     true    # do not build libc_r (re-entrant version of libc)
111 #NO_LPR=        true    # do not build lpr and related programs
112 #NO_MAILWRAPPER=true    # do not build the mailwrapper(8) MTA selector
113 #NO_MODULES=    true    # do not build modules with the kernel
114 #NO_OBJC=       true    # do not build Objective C support
115 #NO_OPENSSH=    true    # do not build OpenSSH
116 #NO_OPENSSL=    true    # do not build OpenSSL (implies NO_OPENSSH)
117 #NO_PKGTOOLS=   true    # do not build included package tools (for pkgsrc)
118 #NO_SENDMAIL=   true    # do not build sendmail and related programs
119 #NO_SHARE=      true    # do not enter the share subdirectory
120 #NO_X=          true    # do not compile in XWindows support (e.g. doscmd)
121 #NOINFO=        true    # do not make or install info files
122 #NOINFOCOMPRESS=true    # do not compress info files
123 #NOMAN=         true    # do not build manual pages
124 #NOMANCOMPRESS= true    # do not compress man pages
125 #NOPROFILE=     true    # Avoid compiling profiled libraries
126 #
127 # To build sys/modules when building the world (our old way of doing things)
128 #MODULES_WITH_WORLD=true        # do not build modules when building kernel
129 #
130 # The list of modules to build instead of all of them.
131 #MODULES_OVERRIDE=      emulation/linux net/ipfw
132 #
133 # To avoid running MAKEDEV all on /dev during install:
134 #NO_MAKEDEV=    true
135 #
136 # The following controls building optional IDEA code in libcrypto.
137 # Patents are involved - you must not use this unless
138 # you either have a license or fall within patent 'fair use'
139 # provisions.
140 #
141 # *** It is YOUR RESPONSIBILITY to determine if you can use this! ***
142 #
143 # IDEA is patented in the USA and many European countries - thought to
144 # be OK to use for any non-commercial use.  This is optional.
145 #WANT_IDEA=     YES     # IDEA (128 bit symmetric encryption)
146 #
147 # Default format for system documentation, depends on your printer.
148 # Set this to "ascii" for simple printers or screen
149 #
150 #PRINTERDEVICE= ps
151 #
152 # By default, the system will always use the keyboard/video card as system
153 # console.  However, the boot blocks may be dynamically configured to use a
154 # serial port in addition to or instead of the keyboard/video console.
155 #
156 # By default we use COM1 as our serial console port *if* we're going to use
157 # a serial port as our console at all.  Alter as necessary.
158 #
159 #   COM1: = 0x3F8, COM2: = 0x2F8, COM3: = 0x3E8, COM4: = 0x2E8
160 #
161 #BOOT_COMCONSOLE_PORT=  0x3F8
162 #
163 # The default serial console speed is 9600.  Set the speed to a larger value
164 # for better interactive response.
165 #
166 #BOOT_COMCONSOLE_SPEED= 115200
167 #
168 # By default the 'pxeboot' loader retrieves the kernel via NFS.  Defining
169 # this and recompiling /usr/src/sys/boot will cause it to retrieve the kernel
170 # via TFTP.  This allows pxeboot to load a custom BOOTP diskless kernel yet
171 # still mount the server's '/' (i.e. rather than load the server's kernel).
172 #
173 #LOADER_TFTP_SUPPORT= YES
174 #
175 # If you want Kerberos 5, define this.
176 #WANT_KERBEROS= yes
177 #
178 # If you want to use the k5su utility, define this to have it installed
179 # set-user-ID.
180 #ENABLE_SUID_K5SU=      yes
181 #
182 # CVSup update flags.  Edit SUPFILE settings to reflect whichever distribution
183 # file(s) you use on your site (see /usr/share/examples/cvsup/README for more
184 # information on CVSup and these files).  To use, do "make update" in /usr/src.
185 #
186 # To enable building of lukemftpd, define this.
187 #WANT_LUKEMFTPD=        yes
188 #
189 #SUP_UPDATE=     yes
190 #SUP=            /usr/local/bin/cvsup
191 #SUPFLAGS=       -g -L 2
192 #SUPHOST=        cvsup.dragonflybsd.org
193 #SUPFILE=        /usr/share/examples/cvsup/DragonFly-src-supfile
194 #DOCSUPFILE=     /usr/share/examples/cvsup/doc-supfile
195 #
196 # top(1) uses a hash table for the user names.  The size of this hash
197 # can be tuned to match the number of local users.  The table size should
198 # be a prime number approximately twice as large as the number of lines in
199 # /etc/passwd.  The default number is 20011.
200 #
201 #TOP_TABLE_SIZE= 101
202 #
203 # Documentation
204 #
205 # The list of languages and encodings to build and install
206 #
207 #DOC_LANG=      en_US.ISO8859-1 ru_RU.KOI8-R
208 #
209 # sendmail
210 #
211 # The following sets the default m4 configuration file to use at
212 # install time.  Use with caution as a make install will overwrite
213 # any existing /etc/mail/sendmail.cf.  Note that SENDMAIL_CF is now
214 # deprecated.  The value should be a fully qualified path name.
215 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
216 # create /etc/mail/sendmail.cf before installworld installs an
217 # updated sendmail binary.
218 #
219 #SENDMAIL_MC=/etc/mail/myconfig.mc
220 #
221 # The following sets the default m4 configuration file for mail
222 # submission to use at install time.  Use with caution as a make
223 # install will overwrite any existing /etc/mail/submit.cf.  The
224 # value should be a fully qualified path name.
225 # Avoid using a value of /etc/mail/submit.mc as a buildworld will
226 # create /etc/mail/submit.cf before installworld installs an
227 # updated sendmail binary.
228 #
229 #SENDMAIL_SUBMIT_MC=/etc/mail/mysubmit.mc
230 #
231 # If you need to build additional .cf files during a make buildworld,
232 # include the full paths to the .mc files in SENDMAIL_ADDITIONAL_MC.
233 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
234 # create /etc/mail/sendmail.cf before installworld installs an
235 # updated sendmail binary.
236 #
237 #SENDMAIL_ADDITIONAL_MC=/etc/mail/foo.mc /etc/mail/bar.mc
238 #
239 # Setting the following variable modifies the flags passed to m4 when
240 # building a .cf file from a .mc file.  It can be used to enable
241 # features disabled by default.
242 #
243 #SENDMAIL_M4_FLAGS=
244 #
245 # Setting the following variables modifies the build environment for
246 # sendmail and its related utilities. For example, SASL support can be
247 # added with settings such as:
248 #
249 #    with SASLv1:
250 #       SENDMAIL_CFLAGS=-I/usr/local/include/sasl1 -DSASL
251 #       SENDMAIL_LDFLAGS=-L/usr/local/lib
252 #       SENDMAIL_LDADD=-lsasl
253 #
254 #    with SASLv2:
255 #       SENDMAIL_CFLAGS=-I/usr/local/include -DSASL=2
256 #       SENDMAIL_LDFLAGS=-L/usr/local/lib
257 #       SENDMAIL_LDADD=-lsasl2
258 #
259 # Note: If you are using Cyrus SASL with other applications which require
260 #       access to the sasldb file, you should add the following to your
261 #       sendmail.mc file:
262 #
263 #       define(`confDONT_BLAME_SENDMAIL',`GroupReadableSASLDBFile')
264 #
265 #SENDMAIL_CFLAGS=
266 #SENDMAIL_LDFLAGS=
267 #SENDMAIL_LDADD=
268 #SENDMAIL_DPADD=
269 #
270 # Setting SENDMAIL_SET_USER_ID will install the sendmail binary as a
271 # set-user-ID root binary instead of a set-group-ID smmsp binary and will
272 # prevent the installation of /etc/mail/submit.cf.
273 # This is a deprecated mode of operation.  See etc/mail/README for more
274 # information.
275 #
276 #SENDMAIL_SET_USER_ID=
277 #
278 # The permissions to use on alias and map databases generated using
279 # /etc/mail/Makefile.  Defaults to 0640.
280 #
281 #SENDMAIL_MAP_PERMS=