xref: /freebsd/share/examples/etc/make.conf (revision d056fa046c6a91b90cd98165face0e42a33a5173)
1# $FreeBSD$
2#
3# NOTE:  Please would any committer updating this file also update the
4# make.conf(5) manual page, if necessary, which is located in
5# src/share/man/man5/make.conf.5.
6#
7# /etc/make.conf, if present, will be read by make (see
8# /usr/share/mk/sys.mk).  It allows you to override macro definitions
9# to make without changing your source tree, or anything the source
10# tree installs.
11#
12# This file must be in valid Makefile syntax.
13#
14# There are additional things you can put into /etc/make.conf.
15# You have to find those in the Makefiles and documentation of
16# the source tree.
17#
18# Note, that you should not set MAKEOBJDIRPREFIX or MAKEOBJDIR
19# from make.conf (or as command line variables to make).
20# Both variables are environment variables for make and must be used as:
21#
22# env MAKEOBJDIRPREFIX=/big/directory make
23#
24#
25# The CPUTYPE variable controls which processor should be targeted for
26# generated code.  This controls processor-specific optimizations in
27# certain code (currently only OpenSSL) as well as modifying the value
28# of CFLAGS to contain the appropriate optimization directive to gcc.
29# The automatic setting of CFLAGS may be overridden using the
30# NO_CPU_CFLAGS variable below.
31# Currently the following CPU types are recognized:
32#   Intel x86 architecture:
33#       (AMD CPUs)	opteron athlon64 athlon-mp athlon-xp athlon-4
34#			athlon-tbird athlon k8 k6-3 k6-2 k6 k5
35#       (Intel CPUs)	nocona pentium4[m] prescott pentium3[m] pentium-m
36#			pentium2 pentiumpro pentium-mmx pentium i486 i386
37#   Alpha/AXP architecture: ev67 ev6 pca56 ev56 ev5 ev45 ev4
38#   AMD64 architecture: opteron, athlon64, nocona
39#   Intel ia64 architecture: itanium2, itanium
40#
41# (?= allows to buildworld for a different CPUTYPE.)
42#
43#CPUTYPE?=pentium3
44#NO_CPU_CFLAGS=		# Don't add -march=<cpu> to CFLAGS automatically
45#NO_CPU_COPTFLAGS=	# Don't add -march=<cpu> to COPTFLAGS automatically
46#
47# CFLAGS controls the compiler settings used when compiling C code.
48# Note that optimization settings other than -O and -O2 are not recommended
49# or supported for compiling the world or the kernel - please revert any
50# nonstandard optimization settings to "-O" or -O2 before submitting bug
51# reports without patches to the developers.
52#
53#CFLAGS= -O -pipe
54#
55# CXXFLAGS controls the compiler settings used when compiling C++ code.
56# Note that CXXFLAGS is initially set to the value of CFLAGS.  If you wish
57# to add to CXXFLAGS value, "+=" must be used rather than "=".  Using "="
58# alone will remove the often needed contents of CFLAGS from CXXFLAGS.
59#
60#CXXFLAGS+= -fconserve-space
61#
62# MAKE_SHELL controls the shell used internally by make(1) to process the
63# command scripts in makefiles.  Three shells are supported, sh, ksh, and
64# csh.  Using sh is most common, and advised.  Using ksh *may* work, but is
65# not guaranteed to.  Using csh is absurd.  The default is to use sh.
66#
67#MAKE_SHELL?=sh
68#
69# BDECFLAGS are a set of gcc warning settings that Bruce Evans has suggested
70# for use in developing FreeBSD and testing changes.  They can be used by
71# putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf.  -Wconversion is not
72# included here due to compiler bugs, e.g., mkdir()'s mode_t argument.
73#
74#BDECFLAGS=	-W -Wall -ansi -pedantic -Wbad-function-cast -Wcast-align \
75#		-Wcast-qual -Wchar-subscripts -Winline \
76#		-Wmissing-prototypes -Wnested-externs -Wpointer-arith \
77#		-Wredundant-decls -Wshadow -Wstrict-prototypes -Wwrite-strings
78#
79# To compile just the kernel with special optimizations, you should use
80# this instead of CFLAGS (which is not applicable to kernel builds anyway).
81# There is very little to gain by using higher optimization levels, and doing
82# so can cause problems.
83#
84#COPTFLAGS= -O -pipe
85#
86# Compare before install
87#INSTALL=install -C
88#
89# Mtree will follow symlinks
90#MTREE_FOLLOWS_SYMLINKS= -L
91#
92# To enable installing ssh(1) with the setuid bit turned on
93#ENABLE_SUID_SSH=
94#
95# To enable installing newgrp(1) with the setuid bit turned on.
96# Without the setuid bit, newgrp cannot change users' groups.
97#ENABLE_SUID_NEWGRP=
98#
99# To avoid building various parts of the base system:
100#NO_MODULES=		# do not build modules with the kernel
101#NO_SHARE=		# do not go into the share subdir
102#NO_SHARED= 		# build /bin and /sbin statically linked (bad idea)
103#
104# Variables that control how ppp(8) is built.
105#PPP_NO_NAT= 		# do not build with NAT support (see make.conf(5))
106#PPP_NO_NETGRAPH= 	# do not build with Netgraph support
107#PPP_NO_RADIUS= 	# do not build with RADIUS support
108#PPP_NO_SUID=		# build with normal permissions
109#
110#TRACEROUTE_NO_IPSEC= 	# do not build traceroute(8) with IPSEC support
111#
112# To build sys/modules when building the world (our old way of doing things)
113#MODULES_WITH_WORLD=	# do not build modules when building kernel
114#
115# The list of modules to build instead of all of them.
116#MODULES_OVERRIDE=	linux ipfw
117#
118# The list of modules to never build, applied *after* MODULES_OVERRIDE.
119#WITHOUT_MODULES=	bktr plip
120#
121# If you do not want unformatted manual pages to be compressed
122# when they are installed:
123#
124#NO_MANCOMPRESS=
125#
126#
127# Default format for system documentation, depends on your printer.
128# Set this to "ascii" for simple printers or screen
129#
130#PRINTERDEVICE=	ps
131#
132#
133# How long to wait for a console keypress before booting the default kernel.
134# This value is approximately in milliseconds. Keypresses are accepted by the
135# BIOS before booting from disk, making it possible to give custom boot
136# parameters even when this is set to 0.
137#
138#BOOTWAIT=0
139#BOOTWAIT=30000
140#
141# By default, the system will always use the keyboard/video card as system
142# console.  However, the boot blocks may be dynamically configured to use a
143# serial port in addition to or instead of the keyboard/video console.
144#
145# By default we use COM1 as our serial console port *if* we're going to use
146# a serial port as our console at all.  Alter as necessary.
147#
148#   COM1: = 0x3F8, COM2: = 0x2F8, COM3: = 0x3E8, COM4: = 0x2E8
149#
150#BOOT_COMCONSOLE_PORT=	0x3F8
151#
152# The default serial console speed is 9600.  Set the speed to a larger value
153# for better interactive response.
154#
155#BOOT_COMCONSOLE_SPEED=	115200
156#
157# By default the 'pxeboot' loader retrieves the kernel via NFS.  Defining
158# this and recompiling /usr/src/sys/boot will cause it to retrieve the kernel
159# via TFTP.  This allows pxeboot to load a custom BOOTP diskless kernel yet
160# still mount the server's '/' (i.e. rather than load the server's kernel).
161#
162#LOADER_TFTP_SUPPORT= YES
163#
164#
165# Kerberos 5 su (k5su)
166# If you want to use the k5su utility, define this to have it installed
167# set-user-ID.
168#ENABLE_SUID_K5SU=
169#
170#
171# CVSup update flags.  Edit SUPFILE settings to reflect whichever distribution
172# file(s) you use on your site (see /usr/share/examples/cvsup/README for more
173# information on CVSup and these files).  To use, do "make update" in /usr/src.
174#
175#SUP_UPDATE=
176#
177#SUP=            /usr/bin/csup
178#SUPFLAGS=       -g -L 2
179#SUPHOST=        cvsup.uk.FreeBSD.org
180#SUPFILE=        /usr/share/examples/cvsup/standard-supfile
181#PORTSSUPFILE=   /usr/share/examples/cvsup/ports-supfile
182#DOCSUPFILE=     /usr/share/examples/cvsup/doc-supfile
183#
184# top(1) uses a hash table for the user names.  The size of this hash
185# can be tuned to match the number of local users.  The table size should
186# be a prime number approximately twice as large as the number of lines in
187# /etc/passwd.  The default number is 20011.
188#
189#TOP_TABLE_SIZE= 101
190#
191# Documentation
192#
193# The list of languages and encodings to build and install
194#
195#DOC_LANG=	en_US.ISO8859-1 ru_RU.KOI8-R
196#
197#
198# sendmail
199#
200# The following sets the default m4 configuration file to use at
201# install time.  Use with caution as a make install will overwrite
202# any existing /etc/mail/sendmail.cf.  Note that SENDMAIL_CF is now
203# deprecated.  The value should be a fully qualified path name.
204#
205#SENDMAIL_MC=/etc/mail/myconfig.mc
206#
207# The following sets the default m4 configuration file for mail
208# submission to use at install time.  Use with caution as a make
209# install will overwrite any existing /etc/mail/submit.cf.  The
210# value should be a fully qualified path name.
211#
212#SENDMAIL_SUBMIT_MC=/etc/mail/mysubmit.mc
213#
214# If you need to build additional .cf files during a make buildworld,
215# include the full paths to the .mc files in SENDMAIL_ADDITIONAL_MC.
216#
217#SENDMAIL_ADDITIONAL_MC=/etc/mail/foo.mc /etc/mail/bar.mc
218#
219# The following overrides the default location for the m4 configuration
220# files used to build a .cf file from a .mc file.
221#
222#SENDMAIL_CF_DIR=/usr/local/share/sendmail/cf
223#
224# Setting the following variable modifies the flags passed to m4 when
225# building a .cf file from a .mc file.  It can be used to enable
226# features disabled by default.
227#
228#SENDMAIL_M4_FLAGS=
229#
230# Setting the following variables modifies the build environment for
231# sendmail and its related utilities. For example, SASL support can be
232# added with settings such as:
233#
234#    with SASLv1:
235#	SENDMAIL_CFLAGS=-I/usr/local/include/sasl1 -DSASL
236#	SENDMAIL_LDFLAGS=-L/usr/local/lib
237#	SENDMAIL_LDADD=-lsasl
238#
239#    with SASLv2:
240#	SENDMAIL_CFLAGS=-I/usr/local/include -DSASL=2
241#	SENDMAIL_LDFLAGS=-L/usr/local/lib
242#	SENDMAIL_LDADD=-lsasl2
243#
244# Note: If you are using Cyrus SASL with other applications which require
245#	access to the sasldb file, you should add the following to your
246#	sendmail.mc file:
247#
248#	define(`confDONT_BLAME_SENDMAIL',`GroupReadableSASLDBFile')
249#
250#SENDMAIL_CFLAGS=
251#SENDMAIL_LDFLAGS=
252#SENDMAIL_LDADD=
253#SENDMAIL_DPADD=
254#
255# Setting SENDMAIL_SET_USER_ID will install the sendmail binary as a
256# set-user-ID root binary instead of a set-group-ID smmsp binary and will
257# prevent the installation of /etc/mail/submit.cf.
258# This is a deprecated mode of operation.  See etc/mail/README for more
259# information.
260#
261#SENDMAIL_SET_USER_ID=
262#
263# The permissions to use on alias and map databases generated using
264# /etc/mail/Makefile.  Defaults to 0640.
265#
266#SENDMAIL_MAP_PERMS=
267