7 Release date: 2011-08-21
10 New features and improvements
11 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13 - Rewrite argument to --sysroot if CCACHE_BASEDIR is used.
19 - Don't crash if getcwd() fails.
20 - Fixed alignment of "called for preprocessing" counter.
25 Release date: 2011-05-29
28 New features and improvements
29 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31 - Added a new statistics counter named ``called for preprocessing''.
32 - The original command line is now logged to the file specified with
34 - Improved error logging when system calls fail.
35 - Added support for rewriting absolute paths in `-F`/`-iframework` GCC
37 - Improved order of statistics counters in `ccache -s` output.
43 - The `-MF`/`-MT`/`-MQ` options with concatenated argument are now handled
44 correctly when they are last on the command line.
45 - ccache is now bug compatible with GCC for the `-MT`/`-MQ` options with
46 concatenated arguments.
47 - Fixed a minor memory leak.
48 - Systems that lack (and don't need to be linked with) libm are now
54 Release date: 2011-01-09
60 - Made a work-around for a bug in gzputc() in zlib 1.2.5.
62 - Corrupt manifest files are now removed so that they won't block direct
65 - ccache now copes with file systems that don't know about symbolic links.
67 - The file handle in now correctly closed on write error when trying to
68 create a cache dir tag.
73 Release date: 2010-11-28
79 - The -MFarg, -MTarg and -MQarg compiler options (i.e, without space
80 between option and argument) are now handled correctly.
86 - Portability fixes for HP-UX 11.00 and other esoteric systems.
91 Release date: 2010-11-21
97 - Bail out on too hard compiler options `-fdump-*`.
99 - NULL return values from malloc/calloc of zero bytes are now handled
102 - Fixed issue when parsing precompiler output on AIX.
108 - Improved documentation on which information is included in the hash sum.
110 - Made the ``too new header file'' test case work on file systems with
111 unsynchronized clocks.
113 - The test suite now also works on systems that lack a /dev/zero.
118 Release date: 2010-11-07
124 - ccache now falls back to preprocessor mode when a non-regular include
125 file (device, socket, etc) has been detected so that potential hanging
126 due to blocking reads is avoided.
128 - CRC errors are now detected when decompressing compressed files in the
131 - Fixed potential object file corruption race on NFS.
133 - Minor documentation corrections.
135 - Fixed configure detection of ar.
137 - ccache development version (set by dev.mk) now works with gits whose
138 `describe` command doesn't understand `--dirty`.
144 - Minor debug log message improvements.
149 Release date: 2010-09-16
151 New features and improvements
152 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
154 - Added support for hashing the output of a custom command (e.g.
155 `%compiler% --version`) to identify the compiler instead of stat-ing or
156 hashing the compiler binary. This can improve robustness when the
157 compiler (as seen by ccache) actually isn't the real compiler but another
160 - Added support for caching compilations that use precompiled headers. (See
161 the manual for important instructions regarding this.)
163 - Locking of the files containing statistics counters is now done using
164 symlinks instead of POSIX locks. This should make ccache behave a lot
165 better on file systems where POSIX locks are slow or broken (e.g. NFS on
168 - Manifest files are now updated without the need of taking locks.
170 - Updates of statistics counters are now always done in one of the
171 sub-level statistics files. This reduces lock contention, which
172 especially improves performance on slow NFS mounts.
174 - Reading and writing of statistics counters has been made
175 forward-compatible (unknown counters are retained).
177 - Files are now read without using mmap(). This has two benefits: it's more
178 robust against file changes during reading and it improves performance on
179 poor systems where mmap() doesn't use the disk cache.
181 - Added `.cp` and `.CP` as known C++ suffixes.
185 - Added `-install_name` as an option known to take an argument. (This
186 improves statistics when using the Darwin linker.)
192 - Non-fatal error messages are now never printed to stderr but logged
195 - Fixed a bug affecting failing commands when `--ccache-skip` is used.
197 - Made `--ccache-skip` work for all options.
199 - EINTR is now handled correctly.
205 - Work on porting ccache to win32 (native), mostly done by Ramiro Polla.
206 The port is not yet finished, but will hopefully be complete in some
209 - Added a `--nostats` flag to the performance benchmark program.
211 - Made the performance benchmark program more accurate when measuring cache
214 - Added a new test framework for unit tests written in C.
216 - Got rid of `configure-dev`; dev mode is now given by `dev.mk.in`
219 - Improved documentation on how to combine ccache with other compiler
220 wrappers (like `distcc`).
222 - New `LICENSE.txt` file with licensing and copyright details about bundled
225 - New `AUTHORS.txt` file with a list of ccache contributors.
227 - New `HACKING.txt` file with some notes about ccache code conventions.
232 Release date: 2010-07-15
237 - The statistics counter ``called for link'' is now correctly updated when
238 linking with a single object file.
239 - Fixed a problem with out-of-source builds.
244 Release date: 2010-06-20
249 - ccache is now licensed under the GNU General Public License (GPL) version
256 - The way the hashes are calculated has changed, so you won't get cache
257 hits for compilation results stored by older ccache versions. Because of
258 this, you might as well clear the old cache directory with `ccache
259 --clear` if you want, unless you plan to keep using an older ccache
263 New features and improvements
264 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
266 - ccache now has a ``direct mode'' where it computes a hash of the source
267 code (including all included files) and compiler options without
268 running the preprocessor. By not running the preprocessor, CPU usage is
269 reduced; the speed is somewhere between 1 and 5 times that of ccache
270 running in traditional mode, depending on the circumstances. The speedup
271 will be higher when I/O is fast (e.g., when files are in the disk cache).
272 The direct mode can be disabled by setting +CCACHE_NODIRECT+.
274 - Support has been added for rewriting absolute paths to relative paths
275 when hashing, in order to increase cache hit rate when building the same
276 source code in different directories even when compiling with `-g` and
277 when using absolute include directory paths. This is done by setting the
278 `CCACHE_BASEDIR` environment variable to an absolute path that specifies
279 which paths to rewrite.
281 - Object files are now optionally stored compressed in the cache. The
282 runtime cost is negligible, and more files will fit in the ccache
283 directory and in the disk cache. Set `CCACHE_COMPRESS` to enable object
284 file compression. Note that you can't use compression in combination with
285 the hard link feature.
287 - A `CCACHE_COMPILERCHECK` option has been added. This option tells ccache
288 what compiler-identifying information to hash to ensure that results
289 retrieved from the cache are accurate. Possible values are: none (don't
290 hash anything), mtime (hash the compiler's mtime and size) and content
291 (hash the content of the compiler binary). The default is mtime.
293 - It is now possible to specify extra files whose contents should be
294 included in the hash sum by setting the `CCACHE_EXTRAFILES` option.
296 - Added support for Objective-C and Objective-C\+\+. The statistics counter
297 ``not a C/C++ file'' has been renamed to ``unsupported source language''.
299 - Added support for the `-x` compiler option.
301 - Added support for long command-line options.
303 - A `CACHEDIR.TAG` file is now created in the cache directory. See
304 <http://www.brynosaurus.com/cachedir/>.
306 - Messages printed to the debug log (specified by `CCACHE_LOGFILE`) have
309 - You can relax some checks that ccache does in direct mode by setting
310 `CCACHE_SLOPPINESS`. See the manual for more information.
312 - `CCACHE_TEMPDIR` no longer needs to be on the same filesystem as
315 - The default value of `CCACHE_TEMPDIR` has been changed to
316 `$CCACHE_DIR/tmp` to avoid cluttering the top directory.
318 - Temporary files that later will be moved into the cache are now created
319 in the cache directory they will end up in. This makes ccache more
320 friendly to Linux's directory layout.
322 - Improved the test suite and added tests for most of the new
323 functionality. It's now also possible to specify a subset of tests to
326 - Standard error output from the compiler is now only stored in the cache
329 - If the compiler produces no object file or an empty object file, but
330 gives a zero exit status (could be due to a file system problem, a buggy
331 program specified by `CCACHE_PREFIX`, etc.), ccache copes with it
334 - Added `installcheck` and `distcheck` make targets.
336 - Clarified cache size limit options' and cleanup semantics.
338 - Improved display of cache max size values.
340 - The following options are no longer hashed in the preprocessor mode:
341 `-imacros`, `-imultilib`, `-iprefix`, `-iquote`, `-isysroot`,
342 `-iwithprefix`, `-iwithprefixbefore`, `-nostdinc`, `-nostdinc++` and
349 - Various portability improvements.
351 - Improved detection of home directory.
353 - User-defined `CPPFLAGS` and `LDFLAGS` are now respected in the Makefile.
357 - Computation of the hash sum has been improved to decrease the risk of
358 hash collisions. For instance, the compiler options `-X -Y` and `-X-Y`
359 previously contributed equally to the hash sum.
361 - Bail out on too hard compiler options `--coverage`, `-fprofile-arcs`,
362 `-fprofile-generate`, `-fprofile-use`, `-frepo`, `-ftest-coverage` and
363 `-save-temps`. Also bail out on `@file` style options.
365 - Errors when using multiple `-arch` compiler options are now noted as
366 ``unsupported compiler option''.
368 - `-MD`/`-MMD` options without `-MT`/`-MF` are now handled correctly.
370 - The `-finput-charset` option is now handled correctly.
372 - Added support for `-Wp,-MD` and `-Wp,-MMD` options.
374 - The compiler options `-Xassembler`, `-b`, `-G` and `-V` are now correctly
375 recognized as taking an argument.
377 - Debug information containing line numbers of predefined and command-line
378 macros (enabled with the compiler option `-g3`) will now be correct.
380 - Corrected LRU cleanup handling of object files.
382 - `utimes()` is now used instead of `utime()` when available.
384 - Non-writable cache directories are now handled gracefully.
386 - Corrected documentation about sharing the cache directory.
388 - Fixed compilation warnings from GCC 4.3.
390 - The command specified by `CCACHE_PREFIX` is no longer part of the hash.
392 - Fixed bad memory access spotted by Valgrind.
394 - Fixed a bug in `x_realloc`.
396 - Freed memory is no longer referenced when compiling a `.i`/`.ii` file and
397 falling back to running the real compiler.
399 - The test suite is now immune to external values of the `CCACHE_*`
400 environment variables.
402 - Improved detection of recursive invocation.
404 - The ccache binary is now not unconditionally stripped when installing.
406 - Statistics counters are now correctly updated for -E option failures and