1 # Copyright 1999-2004 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Id: /var/cvsroot/gentoo-src/portage/cnf/make.conf,v 1.84.2.5 2005/04/13 15:28:38 jstubbs Exp $
4 # Contains local system settings for Portage system
6 # Please review 'man make.conf' for more information.
8 # Build-time functionality
9 # ========================
11 # The USE variable is used to enable optional build-time functionality. For
12 # example, quite a few packages have optional X, gtk or GNOME functionality
13 # that can only be enabled or disabled at compile-time. Gentoo Linux has a
14 # very extensive set of USE variables described in our USE variable HOWTO at
15 # http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1
17 # The available list of use flags with descriptions is in your portage tree.
18 # Use 'less' to view them: --> less /usr/portage/profiles/use.desc <--
20 # 'ufed' is an ncurses/dialog interface available in portage to make handling
21 # useflags for you. 'emerge app-portage/ufed'
24 #USE="X gtk gnome -alsa"
29 # DO NOT CHANGE THIS SETTING UNLESS YOU ARE USING STAGE1!
30 # Change this line as appropriate (i686, i586, i486 or i386).
31 # All modern systems (even Athlons) should use "i686-pc-linux-gnu".
33 CHOST="i686-pc-linux-gnu"
35 # Host and optimization settings
36 # ==============================
38 # For optimal performance, enable a CFLAGS setting appropriate for your CPU.
40 # Please note that if you experience strange issues with a package, it may be
41 # due to gcc's optimizations interacting in a strange way. Please test the
42 # package (and in some cases the libraries it uses) at default optimizations
43 # before reporting errors to developers.
45 # -mcpu=<cpu-type> means optimize code for the particular type of CPU without
46 # breaking compatibility with other CPUs.
48 # -march=<cpu-type> means to take full advantage of the ABI and instructions
49 # for the particular CPU; this will break compatibility with older CPUs (for
50 # example, -march=athlon-xp code will not run on a regular Athlon, and
51 # -march=i686 code will not run on a Pentium Classic.
53 # CPU types supported in gcc-3.2 and higher: athlon-xp, athlon-mp,
54 # athlon-tbird, athlon, k6, k6-2, k6-3, i386, i486, i586 (Pentium), i686
55 # (PentiumPro), pentium, pentium-mmx, pentiumpro, pentium2 (Celeron),
56 # pentium3, and pentium4.
58 # Note that Gentoo Linux 1.4 and higher include at least gcc-3.2.
60 # CPU types supported in gcc-2.95*: k6, i386, i486, i586 (Pentium), i686
61 # (Pentium Pro), pentium, pentiumpro Gentoo Linux 1.2 and below use gcc-2.95*
63 # CRITICAL WARNINGS: ****************************************************** #
64 # K6 markings are deceptive. Avoid setting -march for them. See Bug #24379. #
65 # Pentium-M CPU's should not enable sse2 until at least gcc-3.4. Bug 50616. #
66 # ************************************************************************* #
70 #CFLAGS="-mcpu=athlon-xp -O3 -pipe"
71 #CFLAGS="-march=pentium3 -O3 -pipe"
73 # If you set a CFLAGS above, then this line will set your default C++ flags to
80 # Gentoo is using a new masking system to allow for easier stability testing
81 # on packages. KEYWORDS are used in ebuilds to mask and unmask packages based
82 # on the platform they are set for. A special form has been added that
83 # indicates packages and revisions that are expected to work, but have not yet
84 # been approved for the stable set. '~arch' is a superset of 'arch' which
85 # includes the unstable, in testing, packages. Users of the 'x86' architecture
86 # would add '~x86' to ACCEPT_KEYWORDS to enable unstable/testing packages.
87 # '~ppc', '~sparc' are the unstable KEYWORDS for their respective platforms.
89 # Please note that this is not for development, alpha, beta, nor cvs release
90 # packages. "Broken" packages will not be added to testing and should not be
91 # requested to be added. Alternative routes are available to developers
92 # for experimental packages, and it is at their discretion to use them.
94 # DO NOT PUT ANYTHING BUT YOUR SPECIFIC ~ARCHITECTURE IN THE LIST.
95 # IF YOU ARE UNSURE OF YOUR ARCH, OR THE IMPLICATIONS, DO NOT MODIFY THIS.
97 #ACCEPT_KEYWORDS="~arch"
100 # ===================
102 # Each of these settings controls an aspect of portage's storage and file
103 # system usage. If you change any of these, be sure it is available when
104 # you try to use portage. *** DO NOT INCLUDE A TRAILING "/" ***
106 # PORTAGE_TMPDIR is the location portage will use for compilations and
107 # temporary storage of data. This can get VERY large depending upon
108 # the application being installed.
109 #PORTAGE_TMPDIR=/var/tmp
111 # PORTDIR is the location of the portage tree. This is the repository
112 # for all profile information as well as all ebuilds. If you change
113 # this, you must update your /etc/make.profile symlink accordingly.
114 #PORTDIR=/usr/portage
116 # DISTDIR is where all of the source code tarballs will be placed for
117 # emerges. The source code is maintained here unless you delete
118 # it. The entire repository of tarballs for gentoo is 9G. This is
119 # considerably more than any user will ever download. 2-3G is
121 #DISTDIR=${PORTDIR}/distfiles
123 # PKGDIR is the location of binary packages that you can have created
124 # with '--buildpkg' or '-b' while emerging a package. This can get
125 # upto several hundred megs, or even a few gigs.
126 #PKGDIR=${PORTDIR}/packages
128 # PORT_LOGDIR is the location where portage will store all the logs it
129 # creates from each individual merge. They are stored as NNNN-$PF.log
130 # in the directory specified. This is disabled until you enable it by
131 # providing a directory. Permissions will be modified as needed IF the
132 # directory exists, otherwise logging will be disabled. NNNN is the
133 # increment at the time the log is created. Logs are thus sequential.
134 #PORT_LOGDIR=/var/log/portage
136 # PORTDIR_OVERLAY is a directory where local ebuilds may be stored without
137 # concern that they will be deleted by rsync updates. Default is not
139 #PORTDIR_OVERLAY=/usr/local/portage
144 # If you need to set a proxy for wget or lukemftp, add the appropriate "export
145 # ftp_proxy=<proxy>" and "export http_proxy=<proxy>" lines to /etc/profile if
146 # all users on your system should use them.
148 # Portage uses wget by default. Here are some settings for some alternate
149 # downloaders -- note that you need to merge these programs first before they
152 # Default fetch command (5 tries, passive ftp for firewall compatibility)
153 #FETCHCOMMAND="/usr/bin/wget -t 5 --passive-ftp \${URI} -P \${DISTDIR}"
154 #RESUMECOMMAND="/usr/bin/wget -c -t 5 --passive-ftp \${URI} -P \${DISTDIR}"
156 # Using wget, ratelimiting downloads
157 #FETCHCOMMAND="/usr/bin/wget -t 5 --passive-ftp --limit-rate=200k \${URI} -P \${DISTDIR}"
158 #RESUMECOMMAND="/usr/bin/wget -c -t 5 --passive-ftp --limit-rate=200k \${URI} -P \${DISTDIR}"
160 # Lukemftp (BSD ftp):
161 #FETCHCOMMAND="/usr/bin/lukemftp -s -a -o \${DISTDIR}/\${FILE} \${URI}"
162 #RESUMECOMMAND="/usr/bin/lukemftp -s -a -R -o \${DISTDIR}/\${FILE} \${URI}"
164 # Portage uses GENTOO_MIRRORS to specify mirrors to use for source retrieval.
165 # The list is a space separated list which is read left to right. If you use
166 # another mirror we highly recommend leaving the default mirror at the end of
167 # the list so that portage will fall back to it if the files cannot be found
168 # on your specified mirror. We _HIGHLY_ recommend that you change this setting
169 # to a nearby mirror by merging and using the 'mirrorselect' tool.
170 #GENTOO_MIRRORS="<your_mirror_here> http://distfiles.gentoo.org http://www.ibiblio.org/pub/Linux/distributions/gentoo"
172 # Portage uses PORTAGE_BINHOST to specify mirrors for prebuilt-binary packages.
173 # The list is a single entry specifying the full address of the directory
174 # serving the tbz2's for your system. Running emerge with either '--getbinpkg'
175 # or '--getbinpkgonly' will cause portage to retrieve the metadata from all
176 # packages in the directory specified, and use that data to determine what will
177 # be downloaded and merged. '-g' or '-gK' are the recommend parameters. Please
178 # consult the man pages and 'emerge --help' for more information. For FTP, the
179 # default connection is passive -- If you require an active connection, affix
180 # an asterisk (*) to the end of the host:port string before the path.
181 #PORTAGE_BINHOST="http://grp.mirror.site/gentoo/grp/1.4/i686/athlon-xp/"
182 # This ftp connection is passive ftp.
183 #PORTAGE_BINHOST="ftp://login:pass@grp.mirror.site/pub/grp/i686/athlon-xp/"
184 # This ftp connection is active ftp.
185 #PORTAGE_BINHOST="ftp://login:pass@grp.mirror.site:21*/pub/grp/i686/athlon-xp/"
187 # Synchronizing Portage
188 # =====================
190 # Each of these settings affects how Gentoo synchronizes your Portage tree.
191 # Synchronization is handled by rsync and these settings allow some control
192 # over how it is done.
195 # SYNC is the server used by rsync to retrieve a localized rsync mirror
196 # rotation. This allows you to select servers that are geographically
197 # close to you, yet still distribute the load over a number of servers.
198 # Please do not single out specific rsync mirrors. Doing so places undue
199 # stress on particular mirrors. Instead you may use one of the following
200 # continent specific rotations:
202 # Default: "rsync://rsync.gentoo.org/gentoo-portage"
203 # North America: "rsync://rsync.namerica.gentoo.org/gentoo-portage"
204 # South America: "rsync://rsync.samerica.gentoo.org/gentoo-portage"
205 # Europe: "rsync://rsync.europe.gentoo.org/gentoo-portage"
206 # Asia: "rsync://rsync.asia.gentoo.org/gentoo-portage"
207 # Australia: "rsync://rsync.au.gentoo.org/gentoo-portage"
208 #SYNC="rsync://rsync.gentoo.org/gentoo-portage"
210 # RSYNC_RETRIES sets the number of times portage will attempt to retrieve
211 # a current portage tree before it exits with an error. This allows
212 # for a more successful retrieval without user intervention most times.
215 # RSYNC_TIMEOUT sets the length of time rsync will wait before it times out
216 # on a connection. Most users will benefit from this setting as it will
217 # reduce the amount of 'dead air' they experience when they run across
218 # the occasional, unreachable mirror. Dialup users might want to set this
219 # value up around the 300 second mark.
225 # EMERGE_DEFAULT_OPTS allows emerge to act as if certain options are
226 # specified on every run. Useful options include --ask, --verbose,
227 # --usepkg and many others. Options that are not useful, such as --help,
229 #EMERGE_DEFAULT_OPTS=""
231 # MAKEOPTS provides extra options that may be passed to 'make' when a
232 # program is compiled. Presently the only use is for specifying
233 # the number of parallel makes (-j) to perform. The suggested number
234 # for parallel makes is CPUs+1.
237 # PORTAGE_NICENESS provides a default increment to emerge's niceness level.
238 # Note: This is an increment. Running emerge in a niced environment will
239 # reduce it further. Default is unset.
242 # AUTOCLEAN enables portage to automatically clean out older or overlapping
243 # packages from the system after every successful merge. This is the
244 # same as running 'emerge -c' after every merge. Set with: "yes" or "no".
245 # This does not affect the unpacked source. See 'noclean' below.
248 # PORTAGE_TMPFS is a location where portage may create temporary files.
249 # If specified, portage will use this directory whenever possible
250 # for all rapid operations such as lockfiles and transient data.
251 # It is _highly_ recommended that this be a tmpfs or ramdisk. Do not
252 # set this to anything that does not give a significant performance
253 # enhancement and proper FS compliance for locks and read/write.
254 # /dev/shm is a glibc mandated tmpfs, and should be a reasonable
255 # setting for all linux kernel+glibc based systems.
256 #PORTAGE_TMPFS="/dev/shm"
258 # FEATURES are settings that affect the functionality of portage. Most of
259 # these settings are for developer use, but some are available to non-
260 # developers as well.
262 # 'autoaddcvs' causes portage to automatically try to add files to cvs
263 # that will have to be added later. Done at generation times
264 # and only has an effect when 'cvs' is also set.
265 # 'buildpkg' causes binary packages to be created of all packages that
267 # 'ccache' enables ccache support via CC.
268 # 'confcache' enable confcache support; speeds up autotool based configure
270 # 'collision-protect'
271 # prevents packages from overwriting files that are owned by
272 # another package or by no package at all.
273 # 'cvs' causes portage to enable all cvs features (commits, adds),
274 # and to apply all USE flags in SRC_URI for digests -- for
276 # 'digest' causes digests to be generated for all packages being merged.
277 # 'distcc' enables distcc support via CC.
278 # 'distlocks' enables distfiles locking using fcntl or hardlinks. This
279 # is enabled by default. Tools exist to help clean the locks
280 # after crashes: /usr/lib/portage/bin/clean_locks.
281 # 'fixpackages' allows portage to fix binary packages that are stored in
282 # PKGDIR. This can consume a lot of time. 'fixpackages' is
283 # also a script that can be run at any given time to force
285 # 'gpg' enables basic verification of Manifest files using gpg.
286 # This features is UNDER DEVELOPMENT and reacts to features
287 # of strict and severe. Heavy use of gpg sigs is coming.
288 # 'keeptemp' prevents the clean phase from deleting the temp files ($T)
290 # 'keepwork' prevents the clean phase from deleting the WORKDIR.
291 # 'test' causes ebuilds to perform testing phases if they are capable
292 # of it. Some packages support this automaticaly via makefiles.
293 # 'metadata-transfer'
294 # automatically perform a metadata transfer when `emerge --sync`
296 # 'noauto' causes ebuild to perform only the action requested and
297 # not any other required actions like clean or unpack -- for
298 # debugging purposes only.
299 # 'noclean' prevents portage from removing the source and temporary files
300 # after a merge -- for debugging purposes only.
301 # 'nostrip' prevents the stripping of binaries.
302 # 'notitles' disables xterm titlebar updates (which contain status info).
304 # do fetching in parallel to compilation
305 # 'sandbox' enables sandboxing when running emerge and ebuild.
306 # 'strict' causes portage to react strongly to conditions that are
307 # potentially dangerous, like missing/incorrect Manifest files.
308 # 'userpriv' allows portage to drop root privileges while it is compiling,
309 # as a security measure. As a side effect this can remove
310 # sandbox access violations for users.
311 # 'usersandbox' enables sandboxing while portage is running under userpriv.
312 #FEATURES="sandbox buildpkg ccache distcc userpriv usersandbox notitles noclean noauto cvs keeptemp keepwork autoaddcvs"
313 #FEATURES="sandbox ccache distcc distlocks autoaddcvs"
315 # CCACHE_SIZE sets the space use limitations for ccache. The default size is
316 # 2G, and will be set if not defined otherwise and ccache is in features.
317 # Portage will set the default ccache dir if it is not present in the
318 # user's environment, for userpriv it sets: ${PORTAGE_TMPDIR}/ccache
319 # (/var/tmp/ccache), and for regular use the default is /root/.ccache.
320 # Sizes are specified with 'G' 'M' or 'K'.
321 # '2G' for 2 gigabytes, '2048M' for 2048 megabytes (same as 2G).
324 # DISTCC_DIR sets the temporary space used by distcc.
325 #DISTCC_DIR="${PORTAGE_TMPDIR}/.distcc"
327 # RSYNC_EXCLUDEFROM is a file that portage will pass to rsync when it updates
328 # the portage tree. Specific chunks of the tree may be excluded from
329 # consideration. This may cause dependency failures if you are not careful.
330 # The file format is one pattern per line, blanks and ';' or '#' lines are
331 # comments. See 'man rsync' for more details on the exclude-from format.
332 #RSYNC_EXCLUDEFROM=/etc/portage/rsync_excludes
334 # logging related variables:
335 # PORTAGE_ELOG_CLASSES: selects messages to be logged, possible values are:
336 # info, warn, error, log
337 # Warning: commenting this will disable elog
338 PORTAGE_ELOG_CLASSES="warn error log"
340 # PORTAGE_ELOG_SYSTEM: selects the module(s) to process the log messages. Modules
341 # included in portage are (empty means logging is disabled):
342 # save (saves one log per package in $PORTAGE_TMPDIR/elogs)
343 # custom (passes all messages to $PORTAGE_LOG_COMMAND)
344 # syslog (sends all messages to syslog)
345 # mail (send all messages to the mailserver defined
346 # in $PORTAGE_LOG_MAILURI)
347 # To use elog you should enable at least one module
348 #PORTAGE_ELOG_SYSTEM="save mail"
350 # PORTAGE_ELOG_COMMAND: only used with the "custom" logging module. Specifies a command
351 # to process log messages. Two variables are expanded:
352 # ${PACKAGE} - expands to the cpv entry of the processed
353 # package (see $PVR in ebuild(5))
354 # ${LOGFILE} - absolute path to the logfile
355 # Both variables have to be quoted with single quotes
356 #PORTAGE_ELOG_COMMAND="/path/to/logprocessor -p '${PACKAGE}' -f '${LOGFILE}'"
358 # PORTAGE_ELOG_MAILURI: this variable holds all important settings for the mail
359 # module. In most cases listing the recipient address and
360 # the receiving mailserver should be sufficient, but you can
361 # also use advanced settings like authentication or TLS. The
363 # address [[user:passwd@]mailserver[:port]]
365 # address: recipient address
366 # user: username for smtp auth (defaults to none)
367 # passwd: password for smtp auth (defaults to none)
368 # mailserver: smtp server that should be used to deliver the mail (defaults to localhost)
369 # port: port to use on the given smtp server (defaults to 25, values > 100000 indicate that starttls should be used on (port-100000))
371 #PORTAGE_ELOG_MAILURI="root@localhost localhost" (this is also the default setting)
372 #PORTAGE_ELOG_MAILURI="user@some.domain mail.some.domain" (sends mails to user@some.domain using the mailserver mail.some.domain)
373 #PORTAGE_ELOG_MAILURI="user@some.domain user:secret@mail.some.domain:100465" (this is left uncommented as a reader excercise ;)