View source for Package:CCache

{{Ebuild
|Summary=CCACHE is an application that caches compilation results and reuses it in future compilations in order to achieve faster compile times.
|CatPkg=dev-util/ccache
|Maintainer=
|Repository=
}}
{{fancynote| '''CCACHE can cause build failures'''. If it does, please try to compile the application without CCACHE enabled. Bug reports reported with CCACHE enabled will be closed.}}

== Installing CCACHE ==
To emerge {{Package|dev-util/ccache}}, run the following:
<console>
# ##i##emerge ccache
</console>

Once it finishes emerging, enable it in portage. This is very easy. Just open up <code>/etc/portage/make.conf</code> with your favorite text editor and add the following:

<pre>
FEATURES="ccache"
</pre>

That's it. If you want to check how much the cache is taking up on your disk and other info, you can run the following command:
<console>
###i## CCACHE_DIR="/var/tmp/ccache" ccache -s
</console>

You must pass the <code>CCACHE_DIR</code> option since ccache normally defaults to the user's home directory, and portage uses <code>/var/tmp/ccache</code>.

== Tweaking CCACHE ==

=== Disabling the CACHE limit ===

If you want to let the cache have the flexibility to grow to whatever size it needs to (unlimited size cache), just do the following:
<console>
###i## CCACHE_DIR="/var/tmp/ccache" ccache -M 0
</console>

This will let the cache grow to whatever size it needs to grow to over time.

== Tricks ==
===  Using CCACHE to compile your kernel faster ===
In order to do this you need to change a few variables, you probably only want to change these variables temporarily, but you could change them permanently if you want to. Since we just want to do this temporarily for this example, make a new file called <code>build.sh</code> and put the following inside of it:

<pre>
#!/bin/bash

export CCACHE_DIR="/var/tmp/ccache"
export PATH="/usr/lib/ccache/bin:${PATH}"

cd /usr/src/linux
time make bzImage modules
</pre>

Give the file execute permission:

<console>
###i## chmod u+x build.sh
</console>

This will temporarily export the variables neccessary, then go into the <code>/usr/src/linux</code> folder (whatever you declared with 'eselect kernel') and then compile the kernel.[[Category:HOWTO]]

{{EbuildFooter}}
[[Category:Ebuilds]]