Rename the modules subpkg to targets, to better reflect what it contains.
[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 # bindist = enables the bindist USE flag, please see package specific definition,
53 #       however, it is suggested to enable this if redistributing builds.
54 # ccache = enables build time ccache support
55 # distcc = enable distcc support for building. You have to set distcc_hosts in
56 #       your spec file.
57 # icecream = enables icecream compiler cluster support for building
58 # kerncache = keeps a tbz2 of your built kernel and modules (useful if your
59 #       build stops in livecd-stage2)
60 # pkgcache = keeps a tbz2 of every built package (useful if your build stops
61 #       prematurely)
62 # preserve_libs = enables portage to preserve used libs when unmerging packages
63 #   (used on installcd-stage2 and stage4 targets)
64 # seedcache = use the build output of a previous target if it exists to speed up
65 #       the copy
66 # snapcache = cache the snapshot so that it can be bind-mounted into the chroot.
67 #       WARNING: moving parts of the portage tree from within fsscript *will* break
68 #       your cache. The cache is unlinked before any empty or rm processing, though.
69 #
70 # (These options can be used together)
71 options="autoresume bindist kerncache pkgcache seedcache snapcache"
72
73 # portdir specifies the source portage tree used by the snapshot target.
74 portdir="/usr/portage"
75
76 # sharedir specifies where all of the catalyst runtime executables are. Most
77 # users do not need to change this.
78 sharedir="/usr/lib/catalyst"
79
80 # snapshot_cache specifies where the snapshots will be cached to if snapcache is
81 # enabled in the options.
82 snapshot_cache="/var/tmp/catalyst/snapshot_cache"
83
84 # storedir specifies where catalyst will store everything that it builds, and
85 # also where it will put its temporary files and caches.
86 storedir="/var/tmp/catalyst"
87
88 # port_logdir is where all build logs will be kept. This dir will be automatically cleaned
89 # of all logs over 30 days old. If left undefined the logs will remain in the build directory
90 # as usual and get cleaned every time a stage build is restarted.
91 # port_logdir="/var/tmp/catalyst/tmp"
92
93 # var_tmpfs_portage will mount a tmpfs for /var/tmp/portage so building takes place in RAM
94 # this feature requires a pretty large tmpfs ({open,libre}office needs ~8GB to build)
95 # WARNING: If you use too much RAM everything will fail horribly and it is not our fault.
96 # set size of /var/tmp/portage tmpfs in gigabytes
97 # var_tmpfs_portage=16