initial support for /var/tmp/portage in tmpfs
[catalyst.git] / files / catalyst.conf
1 # /etc/catalyst/catalyst.conf
2
3 # Simple desriptions of catalyst settings. Please refer to the online
4 # documentation for more information.
5
6 # Creates a .DIGESTS file containing the hash output from any of the supported
7 # options below.  Adding them all may take a long time.
8 # Supported hashes:
9 # adler32, crc32, crc32b, gost, haval128, haval160, haval192, haval224,
10 # haval256, md2, md4, md5, ripemd128, ripemd160, ripemd256, ripemd320, sha1,
11 # sha224, sha256, sha384, sha512, snefru128, snefru256, tiger, tiger128,
12 # tiger160, whirlpool
13 digests="md5 sha1 sha512 whirlpool"
14
15 # Creates a .CONTENTS file listing the contents of the file. Pick from any of
16 # the supported options below:
17 # auto          - strongly recommended
18 # tar-tv        - does 'tar tvf FILE'
19 # tar-tvz       - does 'tar tvzf FILE'
20 # tar-tvy       - does 'tar tvyf FILE'
21 # isoinfo-l     - does 'isoinfo -l -i FILE'
22 # isoinfo-f     - does 'isoinfo -f -i FILE'
23 # 'isoinfo-f' is the only option not chosen by the automatic algorithm.
24 # If this variable is empty, no .CONTENTS will be generated at all.
25 contents="auto"
26
27 # distdir specifies where your distfiles are located. This setting should
28 # work fine for most default installations.
29 distdir="/usr/portage/distfiles"
30
31 # envscript allows users to set options such as http proxies, MAKEOPTS,
32 # GENTOO_MIRRORS, or any other environment variables needed for building.
33 # The envscript file sets environment variables like so:
34 # export FOO="bar"
35 envscript="/etc/catalyst/catalystrc"
36
37 # Internal hash function catalyst should use for things like autoresume, 
38 # seedcache, etc.  The default and fastest is crc32.  You should not ever need
39 # to change this unless your OS does not support it.
40 # Supported hashes:
41 # adler32, crc32, crc32b, gost, haval128, haval160, haval192, haval224,
42 # haval256, md2, md4, md5, ripemd128, ripemd160, ripemd256, ripemd320, sha1,
43 # sha224, sha256, sha384, sha512, snefru128, snefru256, tiger, tiger128,
44 # tiger160, whirlpool
45 hash_function="crc32"
46
47 # options set different build-time options for catalyst. Some examples are:
48 # autoresume = Attempt to resume a failed build, clear the autoresume flags with
49 #       the -a option to the catalyst cmdline.  -p will clear the autoresume flags
50 #       as well as your pkgcache and kerncache
51 #       ( This option is not fully tested, bug reports welcome )
52 # ccache = enables build time ccache support (highly recommended)
53 # distcc = enable distcc support for building. You have to set distcc_hosts in
54 #       your spec file.
55 # icecream = enables icecream compiler cluster support for building
56 # kerncache = keeps a tbz2 of your built kernel and modules (useful if your
57 #       build stops in livecd-stage2)
58 # pkgcache = keeps a tbz2 of every built package (useful if your build stops
59 #       prematurely)
60 # seedcache = use the build output of a previous target if it exists to speed up
61 #       the copy
62 # snapcache = cache the snapshot so that it can be bind-mounted into the chroot.
63 #       WARNING: moving parts of the portage tree from within fsscript *will* break
64 #       your cache. The cache is unlinked before any empty or rm processing, though.
65 #
66 # (These options can be used together)
67 options="autoresume kerncache pkgcache seedcache snapcache"
68
69 # portdir specifies the source portage tree used by the snapshot target.
70 portdir="/usr/portage"
71
72 # sharedir specifies where all of the catalyst runtime executables are. Most
73 # users do not need to change this.
74 sharedir="/usr/lib/catalyst"
75
76 # snapshot_cache specifies where the snapshots will be cached to if snapcache is
77 # enabled in the options.
78 snapshot_cache="/var/tmp/catalyst/snapshot_cache"
79
80 # storedir specifies where catalyst will store everything that it builds, and
81 # also where it will put its temporary files and caches.
82 storedir="/var/tmp/catalyst"
83
84 # var_tmpfs_portage will mount a tmpfs for /var/tmp/portage so building takes place in RAM
85 # this feature requires a pretty large tmpfs ({open,libre}office needs ~8GB to build)
86 # WARNING: If you use too much RAM everything will fail horribly and it is not our fault.
87 # set size of /var/tmp/portage tmpfs in gigabytes
88 # var_tmpfs_portage=16