compilercache - a caching wrapper around compilers to speed up compilations

/usr/lib/compilercache/cc [options] files...

/usr/lib/compilercache/gcc [options] files...

/usr/lib/compilercache/c++ [options] files...

/usr/lib/compilercache/g++ [options] files...

Compilercache is a set of wrappers around C and C++ compilers. Each time you compile something, the wrapper puts the result of the compilation into a cache. And once you compile the same thing again, the result will be picked from the cache instead of being recompiled.

There are three design criteria in compilercache, shown in descending order of priority:

1)

the compilercache may NEVER return an output file that is not bitwise the same as if the original compiler would have been run.

2)

the compilercache shall do exactly the same thing as the original compiler, only the time consumption is sometimes much less.

3)

the compilercache shall use the files from the cache as often as possible and not unnecessarily recompile.

It is absolutely top priority that 1) and 2) are ALWAYS met under ALL circumstances.

To use compilercache you should call the commands in /usr/lib/compilercache instead of the regular compilers. The easiest way to do so, is to add /usr/lib/compilercache to the PATH variable. For Bourne-Shell variants this is done with a command like PATH=" /usr/lib/compilercache:$PATH" To hook new compilers into the compilercache system, just add the corresponding link in /usr/lib/compilercache (or in $COMPILERCACHEBINDIR if this ist set). Example: to add gcc-3.2 support you could use the commands cd /usr/lib/compilercache

ln -s compilercache gcc-3.2

ln -s compilercache g++-3.2

/etc/compilercacherc

system wide configuration file.

$HOME/.compilercacherc

per user configuration file.

$(HOME)/.compilercache/cache/

default cache location. If it grows too large, you may remove files from this directory without ill effects.

$(HOME)/.compilercache/temp/

default location for temporary files.

If you set the NOCOMPILERCACHE environment variable, the cache will not be used. This helps to temporarily disable compilercache without modifying the configuration file.

/usr/share/doc/compilercache/README.gz

Compilercache was written by Erik Thiele <erikyyy@erikyyy.de>.

This manual page was written by Jochen Voss <voss@debian.org>.