1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.6.9" />
\r
7 <title>ccache news</title>
\r
8 <style type="text/css">
\r
9 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
\r
13 font-family: Georgia,serif;
\r
17 h1, h2, h3, h4, h5, h6,
\r
18 div.title, caption.title,
\r
19 thead, p.table.header,
\r
21 #author, #revnumber, #revdate, #revremark,
\r
23 font-family: Arial,Helvetica,sans-serif;
\r
27 margin: 1em 5% 1em 5%;
\r
32 text-decoration: underline;
\r
48 h1, h2, h3, h4, h5, h6 {
\r
51 margin-bottom: 0.5em;
\r
56 border-bottom: 2px solid silver;
\r
76 border: 1px solid silver;
\r
81 margin-bottom: 0.5em;
\r
87 ul > li { color: #aaa; }
\r
88 ul > li > * { color: black; }
\r
90 .monospaced, code, pre {
\r
91 font-family: "Courier New", Courier, monospace;
\r
98 white-space: pre-wrap;
\r
108 #revnumber, #revdate, #revremark {
\r
113 border-top: 2px solid silver;
\r
114 padding-top: 0.5em;
\r
119 padding-bottom: 0.5em;
\r
123 padding-bottom: 0.5em;
\r
128 margin-bottom: 1.5em;
\r
130 div.imageblock, div.exampleblock, div.verseblock,
\r
131 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
132 div.admonitionblock {
\r
134 margin-bottom: 1.5em;
\r
136 div.admonitionblock {
\r
138 margin-bottom: 2.0em;
\r
143 div.content { /* Block element content. */
\r
147 /* Block element titles. */
\r
148 div.title, caption.title {
\r
153 margin-bottom: 0.5em;
\r
159 td div.title:first-child {
\r
162 div.content div.title:first-child {
\r
165 div.content + div.title {
\r
169 div.sidebarblock > div.content {
\r
170 background: #ffffee;
\r
171 border: 1px solid #dddddd;
\r
172 border-left: 4px solid #f0f0f0;
\r
176 div.listingblock > div.content {
\r
177 border: 1px solid #dddddd;
\r
178 border-left: 5px solid #f0f0f0;
\r
179 background: #f8f8f8;
\r
183 div.quoteblock, div.verseblock {
\r
184 padding-left: 1.0em;
\r
185 margin-left: 1.0em;
\r
187 border-left: 5px solid #f0f0f0;
\r
191 div.quoteblock > div.attribution {
\r
192 padding-top: 0.5em;
\r
196 div.verseblock > pre.content {
\r
197 font-family: inherit;
\r
198 font-size: inherit;
\r
200 div.verseblock > div.attribution {
\r
201 padding-top: 0.75em;
\r
204 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
205 div.verseblock + div.attribution {
\r
209 div.admonitionblock .icon {
\r
210 vertical-align: top;
\r
213 text-decoration: underline;
\r
215 padding-right: 0.5em;
\r
217 div.admonitionblock td.content {
\r
218 padding-left: 0.5em;
\r
219 border-left: 3px solid #dddddd;
\r
222 div.exampleblock > div.content {
\r
223 border-left: 3px solid #dddddd;
\r
224 padding-left: 0.5em;
\r
227 div.imageblock div.content { padding-left: 0; }
\r
228 span.image img { border-style: none; vertical-align: text-bottom; }
\r
229 a.image:visited { color: white; }
\r
233 margin-bottom: 0.8em;
\r
238 font-style: normal;
\r
241 dd > *:first-child {
\r
246 list-style-position: outside;
\r
249 list-style-type: decimal;
\r
252 list-style-type: lower-alpha;
\r
255 list-style-type: upper-alpha;
\r
258 list-style-type: lower-roman;
\r
261 list-style-type: upper-roman;
\r
264 div.compact ul, div.compact ol,
\r
265 div.compact p, div.compact p,
\r
266 div.compact div, div.compact div {
\r
268 margin-bottom: 0.1em;
\r
280 margin-bottom: 0.8em;
\r
283 padding-bottom: 15px;
\r
285 dt.hdlist1.strong, td.hdlist1.strong {
\r
289 vertical-align: top;
\r
290 font-style: normal;
\r
291 padding-right: 0.8em;
\r
295 vertical-align: top;
\r
297 div.hdlist.compact tr {
\r
303 background: yellow;
\r
306 .footnote, .footnoteref {
\r
310 span.footnote, span.footnoteref {
\r
311 vertical-align: super;
\r
315 margin: 20px 0 20px 0;
\r
316 padding: 7px 0 0 0;
\r
319 #footnotes div.footnote {
\r
325 border-top: 1px solid silver;
\r
334 padding-right: 0.5em;
\r
335 padding-bottom: 0.3em;
\r
336 vertical-align: top;
\r
338 div.colist td img {
\r
343 #footer-badges { display: none; }
\r
347 margin-bottom: 2.5em;
\r
355 margin-bottom: 0.1em;
\r
358 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
375 span.aqua { color: aqua; }
\r
376 span.black { color: black; }
\r
377 span.blue { color: blue; }
\r
378 span.fuchsia { color: fuchsia; }
\r
379 span.gray { color: gray; }
\r
380 span.green { color: green; }
\r
381 span.lime { color: lime; }
\r
382 span.maroon { color: maroon; }
\r
383 span.navy { color: navy; }
\r
384 span.olive { color: olive; }
\r
385 span.purple { color: purple; }
\r
386 span.red { color: red; }
\r
387 span.silver { color: silver; }
\r
388 span.teal { color: teal; }
\r
389 span.white { color: white; }
\r
390 span.yellow { color: yellow; }
\r
392 span.aqua-background { background: aqua; }
\r
393 span.black-background { background: black; }
\r
394 span.blue-background { background: blue; }
\r
395 span.fuchsia-background { background: fuchsia; }
\r
396 span.gray-background { background: gray; }
\r
397 span.green-background { background: green; }
\r
398 span.lime-background { background: lime; }
\r
399 span.maroon-background { background: maroon; }
\r
400 span.navy-background { background: navy; }
\r
401 span.olive-background { background: olive; }
\r
402 span.purple-background { background: purple; }
\r
403 span.red-background { background: red; }
\r
404 span.silver-background { background: silver; }
\r
405 span.teal-background { background: teal; }
\r
406 span.white-background { background: white; }
\r
407 span.yellow-background { background: yellow; }
\r
409 span.big { font-size: 2em; }
\r
410 span.small { font-size: 0.6em; }
\r
412 span.underline { text-decoration: underline; }
\r
413 span.overline { text-decoration: overline; }
\r
414 span.line-through { text-decoration: line-through; }
\r
416 div.unbreakable { page-break-inside: avoid; }
\r
426 margin-bottom: 1.5em;
\r
428 div.tableblock > table {
\r
429 border: 3px solid #527bbd;
\r
431 thead, p.table.header {
\r
438 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
439 div.tableblock > table[frame="void"] {
\r
440 border-style: none;
\r
442 div.tableblock > table[frame="hsides"] {
\r
443 border-left-style: none;
\r
444 border-right-style: none;
\r
446 div.tableblock > table[frame="vsides"] {
\r
447 border-top-style: none;
\r
448 border-bottom-style: none;
\r
459 margin-bottom: 1.5em;
\r
461 thead, p.tableblock.header {
\r
470 border-spacing: 0px;
\r
471 border-style: solid;
\r
472 border-color: #527bbd;
\r
473 border-collapse: collapse;
\r
475 th.tableblock, td.tableblock {
\r
478 border-style: solid;
\r
479 border-color: #527bbd;
\r
482 table.tableblock.frame-topbot {
\r
483 border-left-style: hidden;
\r
484 border-right-style: hidden;
\r
486 table.tableblock.frame-sides {
\r
487 border-top-style: hidden;
\r
488 border-bottom-style: hidden;
\r
490 table.tableblock.frame-none {
\r
491 border-style: hidden;
\r
494 th.tableblock.halign-left, td.tableblock.halign-left {
\r
497 th.tableblock.halign-center, td.tableblock.halign-center {
\r
498 text-align: center;
\r
500 th.tableblock.halign-right, td.tableblock.halign-right {
\r
504 th.tableblock.valign-top, td.tableblock.valign-top {
\r
505 vertical-align: top;
\r
507 th.tableblock.valign-middle, td.tableblock.valign-middle {
\r
508 vertical-align: middle;
\r
510 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
\r
511 vertical-align: bottom;
\r
521 padding-top: 0.5em;
\r
522 padding-bottom: 0.5em;
\r
523 border-top: 2px solid silver;
\r
524 border-bottom: 2px solid silver;
\r
527 border-style: none;
\r
529 body.manpage div.sectionbody {
\r
534 body.manpage div#toc { display: none; }
\r
539 <script type="text/javascript">
\r
541 var asciidoc = { // Namespace.
\r
543 /////////////////////////////////////////////////////////////////////
\r
544 // Table Of Contents generator
\r
545 /////////////////////////////////////////////////////////////////////
\r
547 /* Author: Mihai Bazon, September 2002
\r
548 * http://students.infoiasi.ro/~mishoo
\r
550 * Table Of Content generator
\r
553 * Feel free to use this script under the terms of the GNU General Public
\r
554 * License, as long as you do not remove or alter this notice.
\r
557 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
558 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
560 // toclevels = 1..4.
\r
561 toc: function (toclevels) {
\r
563 function getText(el) {
\r
565 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
566 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
568 else if (i.firstChild != null)
\r
569 text += getText(i);
\r
574 function TocEntry(el, text, toclevel) {
\r
577 this.toclevel = toclevel;
\r
580 function tocEntries(el, toclevels) {
\r
581 var result = new Array;
\r
582 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
\r
583 // Function that scans the DOM tree for header elements (the DOM2
\r
584 // nodeIterator API would be a better technique but not supported by all
\r
586 var iterate = function (el) {
\r
587 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
588 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
589 var mo = re.exec(i.tagName);
\r
590 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
591 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
601 var toc = document.getElementById("toc");
\r
606 // Delete existing TOC entries in case we're reloading the TOC.
\r
607 var tocEntriesToRemove = [];
\r
609 for (i = 0; i < toc.childNodes.length; i++) {
\r
610 var entry = toc.childNodes[i];
\r
611 if (entry.nodeName.toLowerCase() == 'div'
\r
612 && entry.getAttribute("class")
\r
613 && entry.getAttribute("class").match(/^toclevel/))
\r
614 tocEntriesToRemove.push(entry);
\r
616 for (i = 0; i < tocEntriesToRemove.length; i++) {
\r
617 toc.removeChild(tocEntriesToRemove[i]);
\r
620 // Rebuild TOC entries.
\r
621 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
622 for (var i = 0; i < entries.length; ++i) {
\r
623 var entry = entries[i];
\r
624 if (entry.element.id == "")
\r
625 entry.element.id = "_toc_" + i;
\r
626 var a = document.createElement("a");
\r
627 a.href = "#" + entry.element.id;
\r
628 a.appendChild(document.createTextNode(entry.text));
\r
629 var div = document.createElement("div");
\r
630 div.appendChild(a);
\r
631 div.className = "toclevel" + entry.toclevel;
\r
632 toc.appendChild(div);
\r
634 if (entries.length == 0)
\r
635 toc.parentNode.removeChild(toc);
\r
639 /////////////////////////////////////////////////////////////////////
\r
640 // Footnotes generator
\r
641 /////////////////////////////////////////////////////////////////////
\r
643 /* Based on footnote generation code from:
\r
644 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
647 footnotes: function () {
\r
648 // Delete existing footnote entries in case we're reloading the footnodes.
\r
650 var noteholder = document.getElementById("footnotes");
\r
654 var entriesToRemove = [];
\r
655 for (i = 0; i < noteholder.childNodes.length; i++) {
\r
656 var entry = noteholder.childNodes[i];
\r
657 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
\r
658 entriesToRemove.push(entry);
\r
660 for (i = 0; i < entriesToRemove.length; i++) {
\r
661 noteholder.removeChild(entriesToRemove[i]);
\r
664 // Rebuild footnote entries.
\r
665 var cont = document.getElementById("content");
\r
666 var spans = cont.getElementsByTagName("span");
\r
669 for (i=0; i<spans.length; i++) {
\r
670 if (spans[i].className == "footnote") {
\r
672 var note = spans[i].getAttribute("data-note");
\r
674 // Use [\s\S] in place of . so multi-line matches work.
\r
675 // Because JavaScript has no s (dotall) regex flag.
\r
676 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
677 spans[i].innerHTML =
\r
678 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
679 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
680 spans[i].setAttribute("data-note", note);
\r
682 noteholder.innerHTML +=
\r
683 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
684 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
685 n + "</a>. " + note + "</div>";
\r
686 var id =spans[i].getAttribute("id");
\r
687 if (id != null) refs["#"+id] = n;
\r
691 noteholder.parentNode.removeChild(noteholder);
\r
693 // Process footnoterefs.
\r
694 for (i=0; i<spans.length; i++) {
\r
695 if (spans[i].className == "footnoteref") {
\r
696 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
697 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
699 spans[i].innerHTML =
\r
700 "[<a href='#_footnote_" + n +
\r
701 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
707 install: function(toclevels) {
\r
710 function reinstall() {
\r
711 asciidoc.footnotes();
\r
713 asciidoc.toc(toclevels);
\r
717 function reinstallAndRemoveTimer() {
\r
718 clearInterval(timerId);
\r
722 timerId = setInterval(reinstall, 500);
\r
723 if (document.addEventListener)
\r
724 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
\r
726 window.onload = reinstallAndRemoveTimer;
\r
730 asciidoc.install(2);
\r
734 <body class="article">
\r
736 <h1>ccache news</h1>
\r
737 <span id="revnumber">version 3.2.1</span>
\r
739 <div id="toctitle">Table of Contents</div>
740 <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
744 <div class="sect1">
\r
745 <h2 id="_ccache_3_2_1">ccache 3.2.1</h2>
\r
746 <div class="sectionbody">
\r
747 <div class="paragraph"><p>Release date: 2014-12-10</p></div>
\r
748 <div class="sect2">
\r
749 <h3 id="_bug_fixes">Bug fixes</h3>
\r
750 <div class="ulist"><ul>
\r
753 Fixed regression in temporary file handling, which lead to incorrect
\r
754 permissions for stats, manifest and ccache.conf files in the cache.
\r
759 <code>CACHEDIR.TAG</code> files are now created in the [0-9a-f] subdirectories so that
\r
760 ccache.conf is not lost in backups.
\r
765 Made the default cache size suffix <code>G</code>, as previously documented.
\r
770 <code>-fdiagnostics-color=auto</code> is now passed to the compiler even if stderr is
\r
771 redirected. This fixes a problem when, for instance, a configure test probes
\r
772 if the compiler (wrapped via ccache) supports <code>-fdiagnostics-color=auto</code>.
\r
777 Added missing documentation for <code>max_files</code> and <code>max_size</code> configuration
\r
785 <div class="sect1">
\r
786 <h2 id="_ccache_3_2">ccache 3.2</h2>
\r
787 <div class="sectionbody">
\r
788 <div class="paragraph"><p>Release date: 2014-11-17</p></div>
\r
789 <div class="sect2">
\r
790 <h3 id="_new_features_and_improvements">New features and improvements</h3>
\r
791 <div class="ulist"><ul>
\r
794 Added support for configuring ccache via one or several configuration files
\r
795 instead of via environment variables. Environment variables still have
\r
796 priority but are no longer the recommended way of customizing ccache
\r
797 behavior. See the manual for more information.
\r
802 Added support for compiler error/warning messages with color.
\r
807 Made creation of temporary directories and cache directories smarter to avoid
\r
808 unnecessary <code>stat</code> calls.
\r
813 Improved efficiency of the algorithm that scans for <code>__DATE_</code> and <code>__TIME__</code>
\r
814 tokens in the hashed source code.
\r
819 Added support for several binaries (separated by space) in <code>CCACHE_PREFIX</code>.
\r
824 The <code>-c</code> option is no longer passed to the preprocessor. This fixes problems
\r
825 with clang and Solaris’s C++ compiler.
\r
830 ccache no longer passes preprocessor options like <code>-D</code> and <code>-I</code> to the
\r
831 compiler when compiling preprocessed output. This fixes warnings emitted by
\r
837 Compiler options <code>-fprofile-generate</code>, <code>-fprofile-arcs</code>, <code>-fprofile-use</code> and
\r
838 <code>-fbranch-probabilities</code> are now handled without bailing.
\r
843 Added support for clang’s <code>--serialize-diagnostic</code> option, storing the
\r
844 diagnostic file (<code>.dia</code>) in the cache.
\r
849 Added support for precompiled headers when using clang.
\r
854 Added support for clang <code>.pth</code> (pretokenized header) files.
\r
859 Changed the <code>-x</code> language option to use the new objective C standard for GCC
\r
865 On a cache miss, ccache now instructs the compiler to create the object file
\r
866 at the real destination and then copies the file into the cache instead of
\r
867 the other way around. This is needed to support compiler options like
\r
868 <code>-fprofile-arcs</code> and <code>--serialize-diagnostics</code>.
\r
873 ccache now checks that included files' ctimes aren’t too new. This check can
\r
874 be turned off by adding <code>include_file_ctime</code> to the “ccache sloppiness”
\r
880 Added possibility to get cache hits based on filename, size, mtime and ctime
\r
881 only. On other words, source code files are not even read, only stat-ed. This
\r
882 operation mode is opt-in by adding <code>file_stat_matches</code> to the “ccache
\r
883 sloppiness” setting.
\r
888 The filename part of options like <code>-Wp,-MDfilename</code> is no longer included in
\r
889 the hash since the filename doesn’t have any bearing on the result.
\r
894 Added a “read-only direct” configuration setting, which is like the
\r
895 ordinary read-only setting except that ccache will only try to retrieve
\r
896 results from the cache using the direct mode, not the preprocessor mode.
\r
901 The display and interpretation of cache size has been changed to use SI
\r
907 Default cache size is now 5 GB (was previously 1 GiB).
\r
912 Added configuration option to set the compression level of compressed object
\r
913 files in the cache.
\r
918 Added support for <code>@file</code> and <code>-@file</code> arguments (reading options from a
\r
924 <code>-Wl,</code> options are no longer included in the hash since they don’t affect
\r
930 Bail out on too hard compiler option <code>-Wp,-P</code>.
\r
935 Optimized MD4 calculation code on little-endian systems.
\r
940 Various improvements and fixes on win32.
\r
945 Improved logging to the ccache log file.
\r
950 Added <code>--dump-manifest</code> command-line option for debugging purposes.
\r
955 Added <code>--with-bundled-zlib</code> configure option.
\r
960 Upgraded bundled zlib to version 1.2.8.
\r
965 Improved <code>dev.mk</code> to be more platform independent.
\r
970 Made the test suite work with clang and gcc-llvm on OS X.
\r
975 Various other improvements of the test suite.
\r
980 <div class="sect2">
\r
981 <h3 id="_bug_fixes_2">Bug fixes</h3>
\r
982 <div class="ulist"><ul>
\r
985 Any previous <code>.stderr</code> is now removed from the cache when recaching.
\r
990 Fixed an issue when handling the <code>-arch</code> compiler option with an argument.
\r
995 Fixed race condition when creating the initial cache directory.
\r
1000 Fixed test suite failures when <code>CC</code> is a ccache-wrapped compiler.
\r
1007 <div class="sect1">
\r
1008 <h2 id="_ccache_3_1_10">ccache 3.1.10</h2>
\r
1009 <div class="sectionbody">
\r
1010 <div class="paragraph"><p>Release date: 2014-10-19</p></div>
\r
1011 <div class="sect2">
\r
1012 <h3 id="_new_features_and_improvements_2">New features and improvements</h3>
\r
1013 <div class="ulist"><ul>
\r
1016 Added support for the <code>-Xclang</code> compiler option.
\r
1021 Improved handling of exit code of internally executed processes.
\r
1026 Zero length object files in the cache are now rejected as invalid.
\r
1031 Bail out on option <code>-gsplit-dwarf</code> (since it produces multiple output files).
\r
1036 Compiler option <code>-fdebug-prefix-map</code> is now ignored (not part of the hash).
\r
1037 (The <code>-fdebug-prefix-map</code> option may be used in combination with
\r
1038 <code>CCACHE_BASEDIR</code> to reuse results across different directories.)
\r
1043 Added note in documentation that <code>--ccache-skip</code> currently does not mean
\r
1044 “don’t hash the following option”.
\r
1049 To enable support for precompiled headers (PCH), <code>CCACHE_SLOPPINESS</code> now also
\r
1050 needs to include the new <code>pch_defines</code> sloppiness. This is because ccache
\r
1051 can’t detect changes in the source code when only defined macros have been
\r
1057 Stale files in the internal temporary directory (<code><ccache_dir>/tmp</code>) are now
\r
1058 cleaned up if they are older than one hour.
\r
1063 <div class="sect2">
\r
1064 <h3 id="_bug_fixes_3">Bug fixes</h3>
\r
1065 <div class="ulist"><ul>
\r
1068 Fixed path canonicalization in <code>make_relative_path()</code> when path doesn’t
\r
1074 Fixed bug in <code>common_dir_prefix_length()</code>. This corrects the <code>CCACHE_BASEDIR</code>
\r
1080 ccache no longer tries to create the cache directory when <code>CCACHE_DISABLE</code> is
\r
1086 Fixed bug when reading manifests with a very large number of file info
\r
1092 Fixed problem with logging of current working directory.
\r
1099 <div class="sect1">
\r
1100 <h2 id="_ccache_3_1_9">ccache 3.1.9</h2>
\r
1101 <div class="sectionbody">
\r
1102 <div class="paragraph"><p>Release date: 2013-01-06</p></div>
\r
1103 <div class="sect2">
\r
1104 <h3 id="_bug_fixes_4">Bug fixes</h3>
\r
1105 <div class="ulist"><ul>
\r
1108 The EAGAIN signal is now handled correctly when emitting cached stderr
\r
1109 output. This fixes a problem triggered by large error outputs from the
\r
1115 Subdirectories in the cache are no longer created in read-only mode.
\r
1120 Fixed so that ccache’s log file descriptor is not made available to the
\r
1126 Improved error reporting when failing to create temporary stdout/stderr files
\r
1127 when executing the compiler.
\r
1132 Disappearing temporary stdout/stderr files are now handled gracefully.
\r
1137 <div class="sect2">
\r
1138 <h3 id="_other">Other</h3>
\r
1139 <div class="ulist"><ul>
\r
1142 Fixed test suite to work on ecryptfs.
\r
1149 <div class="sect1">
\r
1150 <h2 id="_ccache_3_1_8">ccache 3.1.8</h2>
\r
1151 <div class="sectionbody">
\r
1152 <div class="paragraph"><p>Release date: 2012-08-11</p></div>
\r
1153 <div class="sect2">
\r
1154 <h3 id="_new_features_and_improvements_3">New features and improvements</h3>
\r
1155 <div class="ulist"><ul>
\r
1158 Made paths to dependency files relative in order to increase cache hits.
\r
1163 Added work-around to make ccache work with buggy GCC 4.1 when creating a
\r
1164 pre-compiled header.
\r
1169 Clang plugins are now hashed to catch plugin upgrades.
\r
1174 <div class="sect2">
\r
1175 <h3 id="_bug_fixes_5">Bug fixes</h3>
\r
1176 <div class="ulist"><ul>
\r
1179 Fixed crash when the current working directory has been removed.
\r
1184 Fixed crash when stderr is closed.
\r
1189 Corrected a corner case when parsing backslash escapes in string
\r
1195 Paths are now correctly canonicalized when computing paths relative to the
\r
1201 <div class="sect2">
\r
1202 <h3 id="_other_2">Other</h3>
\r
1203 <div class="ulist"><ul>
\r
1206 Made git version macro work when compiling outside of the source directory.
\r
1211 Fixed <code>static_assert</code> macro definition clash with GCC 4.7.
\r
1218 <div class="sect1">
\r
1219 <h2 id="_ccache_3_1_7">ccache 3.1.7</h2>
\r
1220 <div class="sectionbody">
\r
1221 <div class="paragraph"><p>Release date: 2012-01-08</p></div>
\r
1222 <div class="sect2">
\r
1223 <h3 id="_bug_fixes_6">Bug fixes</h3>
\r
1224 <div class="ulist"><ul>
\r
1227 Non-writable <code>CCACHE_DIR</code> is now handled gracefully when <code>CCACHE_READONLY</code> is
\r
1233 Made failure to create files (typically due to bad directory permissions) in
\r
1234 the cache directory fatal. Previously, such failures were silently and
\r
1235 erroneously flagged as "compiler produced stdout".
\r
1240 Both the <code>-specs=file</code> and <code>--specs=file</code> forms are now recognized.
\r
1245 Added recognition and hashing of GCC plugins specified with <code>-fplugin=file</code>.
\r
1250 <code>CCACHE_COMPILERCHECK</code> now also determines how to hash explicit specs files
\r
1251 (<code>-specs=file</code>).
\r
1256 Added <code>CPATH</code>, <code>C_INCLUDE_PATH</code> and similar environment variables to the hash
\r
1257 to avoid false cache hits when such variables have changed.
\r
1262 Corrected log message when unify mode is enabled.
\r
1267 Reverted the GCC bug compatibility introduced in ccache 3.1.5 for <code>-MT</code>/<code>-MQ</code>
\r
1268 options with concatenated arguments. (The bug is fixed in recent GCC
\r
1274 <div class="sect2">
\r
1275 <h3 id="_other_3">Other</h3>
\r
1276 <div class="ulist"><ul>
\r
1279 Corrected license header for <code>mdfour.c</code>.
\r
1284 Improved documentation on how to fix bad object files in the cache.
\r
1291 <div class="sect1">
\r
1292 <h2 id="_ccache_3_1_6">ccache 3.1.6</h2>
\r
1293 <div class="sectionbody">
\r
1294 <div class="paragraph"><p>Release date: 2011-08-21</p></div>
\r
1295 <div class="sect2">
\r
1296 <h3 id="_new_features_and_improvements_4">New features and improvements</h3>
\r
1297 <div class="ulist"><ul>
\r
1300 Rewrite argument to <code>--sysroot</code> if <code>CCACHE_BASEDIR</code> is used.
\r
1305 <div class="sect2">
\r
1306 <h3 id="_bug_fixes_7">Bug fixes</h3>
\r
1307 <div class="ulist"><ul>
\r
1310 Don’t crash if <code>getcwd()</code> fails.
\r
1315 Fixed alignment of “called for preprocessing” counter.
\r
1322 <div class="sect1">
\r
1323 <h2 id="_ccache_3_1_5">ccache 3.1.5</h2>
\r
1324 <div class="sectionbody">
\r
1325 <div class="paragraph"><p>Release date: 2011-05-29</p></div>
\r
1326 <div class="sect2">
\r
1327 <h3 id="_new_features_and_improvements_5">New features and improvements</h3>
\r
1328 <div class="ulist"><ul>
\r
1331 Added a new statistics counter named “called for preprocessing”.
\r
1336 The original command line is now logged to the file specified with
\r
1337 <code>CCACHE_LOGFILE</code>.
\r
1342 Improved error logging when system calls fail.
\r
1347 Added support for rewriting absolute paths in <code>-F</code>/<code>-iframework</code> GCC
\r
1353 Improved order of statistics counters in <code>ccache -s</code> output.
\r
1358 <div class="sect2">
\r
1359 <h3 id="_bug_fixes_8">Bug fixes</h3>
\r
1360 <div class="ulist"><ul>
\r
1363 The <code>-MF</code>/<code>-MT</code>/<code>-MQ</code> options with concatenated argument are now handled
\r
1364 correctly when they are last on the command line.
\r
1369 ccache is now bug compatible with GCC for the <code>-MT</code>/<code>-MQ</code> options with
\r
1370 concatenated arguments.
\r
1375 Fixed a minor memory leak.
\r
1380 Systems that lack (and don’t need to be linked with) libm are now supported.
\r
1387 <div class="sect1">
\r
1388 <h2 id="_ccache_3_1_4">ccache 3.1.4</h2>
\r
1389 <div class="sectionbody">
\r
1390 <div class="paragraph"><p>Release date: 2011-01-09</p></div>
\r
1391 <div class="sect2">
\r
1392 <h3 id="_bug_fixes_9">Bug fixes</h3>
\r
1393 <div class="ulist"><ul>
\r
1396 Made a work-around for a bug in <code>gzputc()</code> in zlib 1.2.5.
\r
1401 Corrupt manifest files are now removed so that they won’t block direct mode
\r
1407 ccache now copes with file systems that don’t know about symbolic links.
\r
1412 The file handle in now correctly closed on write error when trying to create
\r
1420 <div class="sect1">
\r
1421 <h2 id="_ccache_3_1_3">ccache 3.1.3</h2>
\r
1422 <div class="sectionbody">
\r
1423 <div class="paragraph"><p>Release date: 2010-11-28</p></div>
\r
1424 <div class="sect2">
\r
1425 <h3 id="_bug_fixes_10">Bug fixes</h3>
\r
1426 <div class="ulist"><ul>
\r
1429 The -MFarg, -MTarg and -MQarg compiler options (i.e, without space between
\r
1430 option and argument) are now handled correctly.
\r
1435 <div class="sect2">
\r
1436 <h3 id="_other_4">Other</h3>
\r
1437 <div class="ulist"><ul>
\r
1440 Portability fixes for HP-UX 11.00 and other esoteric systems.
\r
1447 <div class="sect1">
\r
1448 <h2 id="_ccache_3_1_2">ccache 3.1.2</h2>
\r
1449 <div class="sectionbody">
\r
1450 <div class="paragraph"><p>Release date: 2010-11-21</p></div>
\r
1451 <div class="sect2">
\r
1452 <h3 id="_bug_fixes_11">Bug fixes</h3>
\r
1453 <div class="ulist"><ul>
\r
1456 Bail out on too hard compiler options <code>-fdump-*</code>.
\r
1461 NULL return values from malloc/calloc of zero bytes are now handled
\r
1467 Fixed issue when parsing precompiler output on AIX.
\r
1472 <div class="sect2">
\r
1473 <h3 id="_other_5">Other</h3>
\r
1474 <div class="ulist"><ul>
\r
1477 Improved documentation on which information is included in the hash sum.
\r
1482 Made the “too new header file” test case work on file systems with
\r
1483 unsynchronized clocks.
\r
1488 The test suite now also works on systems that lack a /dev/zero.
\r
1495 <div class="sect1">
\r
1496 <h2 id="_ccache_3_1_1">ccache 3.1.1</h2>
\r
1497 <div class="sectionbody">
\r
1498 <div class="paragraph"><p>Release date: 2010-11-07</p></div>
\r
1499 <div class="sect2">
\r
1500 <h3 id="_bug_fixes_12">Bug fixes</h3>
\r
1501 <div class="ulist"><ul>
\r
1504 ccache now falls back to preprocessor mode when a non-regular include file
\r
1505 (device, socket, etc) has been detected so that potential hanging due to
\r
1506 blocking reads is avoided.
\r
1511 CRC errors are now detected when decompressing compressed files in the cache.
\r
1516 Fixed potential object file corruption race on NFS.
\r
1521 Minor documentation corrections.
\r
1526 Fixed configure detection of ar.
\r
1531 ccache development version (set by dev.mk) now works with gits whose
\r
1532 <code>describe</code> command doesn’t understand <code>--dirty</code>.
\r
1537 <div class="sect2">
\r
1538 <h3 id="_other_6">Other</h3>
\r
1539 <div class="ulist"><ul>
\r
1542 Minor debug log message improvements.
\r
1549 <div class="sect1">
\r
1550 <h2 id="_ccache_3_1">ccache 3.1</h2>
\r
1551 <div class="sectionbody">
\r
1552 <div class="paragraph"><p>Release date: 2010-09-16</p></div>
\r
1553 <div class="sect2">
\r
1554 <h3 id="_new_features_and_improvements_6">New features and improvements</h3>
\r
1555 <div class="ulist"><ul>
\r
1558 Added support for hashing the output of a custom command (e.g. <code>%compiler%
\r
1559 --version</code>) to identify the compiler instead of stat-ing or hashing the
\r
1560 compiler binary. This can improve robustness when the compiler (as seen by
\r
1561 ccache) actually isn’t the real compiler but another compiler wrapper.
\r
1566 Added support for caching compilations that use precompiled headers. (See the
\r
1567 manual for important instructions regarding this.)
\r
1572 Locking of the files containing statistics counters is now done using
\r
1573 symlinks instead of POSIX locks. This should make ccache behave a lot better
\r
1574 on file systems where POSIX locks are slow or broken (e.g. NFS on some
\r
1580 Manifest files are now updated without the need of taking locks.
\r
1585 Updates of statistics counters are now always done in one of the sub-level
\r
1586 statistics files. This reduces lock contention, which especially improves
\r
1587 performance on slow NFS mounts.
\r
1592 Reading and writing of statistics counters has been made forward-compatible
\r
1593 (unknown counters are retained).
\r
1598 Files are now read without using <code>mmap()</code>. This has two benefits: it’s more
\r
1599 robust against file changes during reading and it improves performance on
\r
1600 poor systems where <code>mmap()</code> doesn’t use the disk cache.
\r
1605 Added <code>.cp</code> and <code>.CP</code> as known C++ suffixes.
\r
1615 Added <code>-install_name</code> as an option known to take an argument. (This improves
\r
1616 statistics when using the Darwin linker.)
\r
1621 <div class="sect2">
\r
1622 <h3 id="_bug_fixes_13">Bug fixes</h3>
\r
1623 <div class="ulist"><ul>
\r
1626 Non-fatal error messages are now never printed to stderr but logged instead.
\r
1631 Fixed a bug affecting failing commands when <code>--ccache-skip</code> is used.
\r
1636 Made <code>--ccache-skip</code> work for all options.
\r
1641 EINTR is now handled correctly.
\r
1646 <div class="sect2">
\r
1647 <h3 id="_other_7">Other</h3>
\r
1648 <div class="ulist"><ul>
\r
1651 Work on porting ccache to win32 (native), mostly done by Ramiro Polla. The
\r
1652 port is not yet finished, but will hopefully be complete in some subsequent
\r
1658 Added a <code>--nostats</code> flag to the performance benchmark program.
\r
1663 Made the performance benchmark program more accurate when measuring cache
\r
1669 Added a new test framework for unit tests written in C.
\r
1674 Got rid of <code>configure-dev</code>; dev mode is now given by <code>dev.mk.in</code> presence.
\r
1679 Improved documentation on how to combine ccache with other compiler wrappers
\r
1680 (like <code>distcc</code>).
\r
1685 New <code>LICENSE.txt</code> file with licensing and copyright details about bundled
\r
1691 New <code>AUTHORS.txt</code> file with a list of ccache contributors.
\r
1696 New <code>HACKING.txt</code> file with some notes about ccache code conventions.
\r
1703 <div class="sect1">
\r
1704 <h2 id="_ccache_3_0_1">ccache 3.0.1</h2>
\r
1705 <div class="sectionbody">
\r
1706 <div class="paragraph"><p>Release date: 2010-07-15</p></div>
\r
1707 <div class="sect2">
\r
1708 <h3 id="_bug_fixes_14">Bug fixes</h3>
\r
1709 <div class="ulist"><ul>
\r
1712 The statistics counter “called for link” is now correctly updated when
\r
1713 linking with a single object file.
\r
1718 Fixed a problem with out-of-source builds.
\r
1725 <div class="sect1">
\r
1726 <h2 id="_ccache_3_0">ccache 3.0</h2>
\r
1727 <div class="sectionbody">
\r
1728 <div class="paragraph"><p>Release date: 2010-06-20</p></div>
\r
1729 <div class="sect2">
\r
1730 <h3 id="_general">General</h3>
\r
1731 <div class="ulist"><ul>
\r
1734 ccache is now licensed under the GNU General Public License (GPL) version 3
\r
1740 <div class="sect2">
\r
1741 <h3 id="_upgrade_notes">Upgrade notes</h3>
\r
1742 <div class="ulist"><ul>
\r
1745 The way the hashes are calculated has changed, so you won’t get cache hits
\r
1746 for compilation results stored by older ccache versions. Because of this, you
\r
1747 might as well clear the old cache directory with <code>ccache --clear</code> if you
\r
1748 want, unless you plan to keep using an older ccache version.
\r
1753 <div class="sect2">
\r
1754 <h3 id="_new_features_and_improvements_7">New features and improvements</h3>
\r
1755 <div class="ulist"><ul>
\r
1758 ccache now has a “direct mode” where it computes a hash of the source code
\r
1759 (including all included files) and compiler options without running the
\r
1760 preprocessor. By not running the preprocessor, CPU usage is reduced; the
\r
1761 speed is somewhere between 1 and 5 times that of ccache running in
\r
1762 traditional mode, depending on the circumstances. The speedup will be higher
\r
1763 when I/O is fast (e.g., when files are in the disk cache). The direct mode
\r
1764 can be disabled by setting <code>CCACHE_NODIRECT</code>.
\r
1769 Support has been added for rewriting absolute paths to relative paths when
\r
1770 hashing, in order to increase cache hit rate when building the same source
\r
1771 code in different directories even when compiling with <code>-g</code> and when using
\r
1772 absolute include directory paths. This is done by setting the
\r
1773 <code>CCACHE_BASEDIR</code> environment variable to an absolute path that specifies
\r
1774 which paths to rewrite.
\r
1779 Object files are now optionally stored compressed in the cache. The runtime
\r
1780 cost is negligible, and more files will fit in the ccache directory and in
\r
1781 the disk cache. Set <code>CCACHE_COMPRESS</code> to enable object file compression. Note
\r
1782 that you can’t use compression in combination with the hard link feature.
\r
1787 A <code>CCACHE_COMPILERCHECK</code> option has been added. This option tells ccache what
\r
1788 compiler-identifying information to hash to ensure that results retrieved
\r
1789 from the cache are accurate. Possible values are: none (don’t hash anything),
\r
1790 mtime (hash the compiler’s mtime and size) and content (hash the content of
\r
1791 the compiler binary). The default is mtime.
\r
1796 It is now possible to specify extra files whose contents should be included
\r
1797 in the hash sum by setting the <code>CCACHE_EXTRAFILES</code> option.
\r
1802 Added support for Objective-C and Objective-C++. The statistics counter
\r
1803 “not a C/C++ file” has been renamed to “unsupported source language”.
\r
1808 Added support for the <code>-x</code> compiler option.
\r
1813 Added support for long command-line options.
\r
1818 A <code>CACHEDIR.TAG</code> file is now created in the cache directory. See
\r
1819 <a href="http://www.brynosaurus.com/cachedir/">http://www.brynosaurus.com/cachedir/</a>.
\r
1824 Messages printed to the debug log (specified by <code>CCACHE_LOGFILE</code>) have been
\r
1830 You can relax some checks that ccache does in direct mode by setting
\r
1831 <code>CCACHE_SLOPPINESS</code>. See the manual for more information.
\r
1836 <code>CCACHE_TEMPDIR</code> no longer needs to be on the same filesystem as
\r
1837 <code>CCACHE_DIR</code>.
\r
1842 The default value of <code>CCACHE_TEMPDIR</code> has been changed to <code>$CCACHE_DIR/tmp</code>
\r
1843 to avoid cluttering the top directory.
\r
1848 Temporary files that later will be moved into the cache are now created in
\r
1849 the cache directory they will end up in. This makes ccache more friendly to
\r
1850 Linux’s directory layout.
\r
1855 Improved the test suite and added tests for most of the new functionality.
\r
1856 It’s now also possible to specify a subset of tests to run.
\r
1861 Standard error output from the compiler is now only stored in the cache if
\r
1862 it’s non-empty.
\r
1867 If the compiler produces no object file or an empty object file, but gives a
\r
1868 zero exit status (could be due to a file system problem, a buggy program
\r
1869 specified by <code>CCACHE_PREFIX</code>, etc.), ccache copes with it properly.
\r
1874 Added <code>installcheck</code> and <code>distcheck</code> make targets.
\r
1879 Clarified cache size limit options' and cleanup semantics.
\r
1884 Improved display of cache max size values.
\r
1889 The following options are no longer hashed in the preprocessor mode:
\r
1890 <code>-imacros</code>, <code>-imultilib</code>, <code>-iprefix</code>, <code>-iquote</code>, <code>-isysroot</code>, <code>-iwithprefix</code>,
\r
1891 <code>-iwithprefixbefore</code>, <code>-nostdinc</code>, <code>-nostdinc++</code> and <code>-U</code>.
\r
1896 <div class="sect2">
\r
1897 <h3 id="_bug_fixes_15">Bug fixes</h3>
\r
1898 <div class="ulist"><ul>
\r
1901 Various portability improvements.
\r
1906 Improved detection of home directory.
\r
1911 User-defined <code>CPPFLAGS</code> and <code>LDFLAGS</code> are now respected in the Makefile.
\r
1921 Computation of the hash sum has been improved to decrease the risk of hash
\r
1922 collisions. For instance, the compiler options <code>-X -Y</code> and <code>-X-Y</code> previously
\r
1923 contributed equally to the hash sum.
\r
1928 Bail out on too hard compiler options <code>--coverage</code>, <code>-fprofile-arcs</code>,
\r
1929 <code>-fprofile-generate</code>, <code>-fprofile-use</code>, <code>-frepo</code>, <code>-ftest-coverage</code> and
\r
1930 <code>-save-temps</code>. Also bail out on <code>@file</code> style options.
\r
1935 Errors when using multiple <code>-arch</code> compiler options are now noted as
\r
1936 “unsupported compiler option”.
\r
1941 <code>-MD</code>/<code>-MMD</code> options without <code>-MT</code>/<code>-MF</code> are now handled correctly.
\r
1946 The <code>-finput-charset</code> option is now handled correctly.
\r
1951 Added support for <code>-Wp,-MD</code> and <code>-Wp,-MMD</code> options.
\r
1956 The compiler options <code>-Xassembler</code>, <code>-b</code>, <code>-G</code> and <code>-V</code> are now correctly
\r
1957 recognized as taking an argument.
\r
1962 Debug information containing line numbers of predefined and command-line
\r
1963 macros (enabled with the compiler option <code>-g3</code>) will now be correct.
\r
1968 Corrected LRU cleanup handling of object files.
\r
1973 <code>utimes()</code> is now used instead of <code>utime()</code> when available.
\r
1978 Non-writable cache directories are now handled gracefully.
\r
1983 Corrected documentation about sharing the cache directory.
\r
1988 Fixed compilation warnings from GCC 4.3.
\r
1993 The command specified by <code>CCACHE_PREFIX</code> is no longer part of the hash.
\r
1998 Fixed bad memory access spotted by Valgrind.
\r
2003 Fixed a bug in <code>x_realloc</code>.
\r
2008 Freed memory is no longer referenced when compiling a <code>.i</code>/<code>.ii</code> file and
\r
2009 falling back to running the real compiler.
\r
2014 The test suite is now immune to external values of the <code>CCACHE_*</code> environment
\r
2020 Improved detection of recursive invocation.
\r
2025 The ccache binary is now not unconditionally stripped when installing.
\r
2030 Statistics counters are now correctly updated for -E option failures and
\r
2039 <div id="footnotes"><hr /></div>
\r
2041 <div id="footer-text">
\r
2042 Version 3.2.1<br />
\r
2043 Last updated 2014-12-10 20:38:47 CET
\r