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.4</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_4">ccache 3.4</h2>
\r
746 <div class="sectionbody">
\r
747 <div class="paragraph"><p>Release date: 2018-02-11</p></div>
\r
748 <div class="sect2">
\r
749 <h3 id="_new_features_and_enhancements">New features and enhancements</h3>
\r
750 <div class="ulist"><ul>
\r
753 The compiler option form <code>--sysroot arg</code> is now handled like the documented
\r
754 <code>--sysroot=arg</code> form.
\r
759 Added support for caching <code>.su</code> files generated by GCC flag <code>-fstack-usage</code>.
\r
764 ccache should now work with distcc’s “pump” wrapper.
\r
769 The optional unifier is no longer disabled when the direct mode is enabled.
\r
774 Added support for nvcc compiler options <code>--compiler-bindir/-ccbin</code>,
\r
775 <code>--output-directory/-odir</code> and <code>--libdevice-directory/-ldir</code>.
\r
780 Boolean environment variable settings no longer accept the following
\r
781 (case-insensitive) values: <code>0</code>, <code>false</code>, <code>disable</code> and <code>no</code>. All other values
\r
782 are accepted and taken to mean “true”. This is to stop users from setting
\r
783 e.g. <code>CCACHE_DISABLE=0</code> and then expect the cache to be used.
\r
788 Improved support for <code>run_second_cpp = false</code>: If combined with passing
\r
789 <code>-fdirectives-only</code> (GCC) or <code>frewrite-includes</code> (Clang) to the compiler,
\r
790 diagnostics warnings and similar will be correct.
\r
795 An implicit <code>-MQ</code> is now passed to the preprocessor only if the object file
\r
796 extension is non-standard. This should make it easier to use EDG-based
\r
797 compilers (e.g. GHS) which don’t understand <code>-MQ</code>.
\r
802 ccache now treats an unreadable configuration file just like a missing
\r
803 configuration file.
\r
808 Documented more pitfalls with enabling <code>hard_links</code> (<code>CCACHE_HARDLINK</code>).
\r
813 Documented caveats related to colored warnings from compilers.
\r
818 <div class="sect2">
\r
819 <h3 id="_bug_fixes">Bug fixes</h3>
\r
820 <div class="ulist"><ul>
\r
823 File size and number counters are now updated correctly when files are
\r
824 overwritten in the cache, e.g. when using <code>CCACHE_RECACHE</code>.
\r
829 <code>run_second_cpp</code> is now forced for nvcc.
\r
834 Fixed how the nvcc options <code>-optf</code> and <code>-odir</code> are handled.
\r
841 <div class="sect1">
\r
842 <h2 id="_ccache_3_3_6">ccache 3.3.6</h2>
\r
843 <div class="sectionbody">
\r
844 <div class="paragraph"><p>Release date: 2018-01-28</p></div>
\r
845 <div class="sect2">
\r
846 <h3 id="_new_features_and_enhancements_2">New features and enhancements</h3>
\r
847 <div class="ulist"><ul>
\r
850 Improved instructions on how to get cache hits between different working
\r
856 <div class="sect2">
\r
857 <h3 id="_bug_fixes_2">Bug fixes</h3>
\r
858 <div class="ulist"><ul>
\r
861 Fixed regression in ccache 3.3.5 related to the <code>UNCACHED_ERR_FD</code> feature.
\r
868 <div class="sect1">
\r
869 <h2 id="_ccache_3_3_5">ccache 3.3.5</h2>
\r
870 <div class="sectionbody">
\r
871 <div class="paragraph"><p>Release date: 2018-01-13</p></div>
\r
872 <div class="sect2">
\r
873 <h3 id="_new_features_and_enhancements_3">New features and enhancements</h3>
\r
874 <div class="ulist"><ul>
\r
877 Documented how automatic cache cleanup works.
\r
882 <div class="sect2">
\r
883 <h3 id="_bug_fixes_3">Bug fixes</h3>
\r
884 <div class="ulist"><ul>
\r
887 Fixed a regression where the original order of debug options could be lost.
\r
888 This reverts the “Improved parsing of <code>-g*</code> options” feature in ccache 3.3.
\r
893 Multiple <code>-fdebug-prefix-map</code> options should now be handled correctly.
\r
898 Fixed matching of directories in the <code>ignore_headers_in_manifest</code>
\r
899 configuration option.
\r
904 Fixed detection of missing argument to <code>-opt</code>/<code>--options-file</code>.
\r
909 ccache now bails out when building a precompiled header if any of the
\r
910 corresponding header files have an updated timestamp. This fixes complaints
\r
916 Fixed a bug related to erroneously storing a dependency file with absolute
\r
917 paths in the cache on a preprocessed hit.
\r
922 <code>ccache -c/--cleanup</code> now works like documented: it just recalculates size
\r
923 counters and trims the cache to not exceed the max size and file number
\r
924 limits. Previously, the forced cleanup took “limit_multiple” into account,
\r
925 so that <code>ccache -c/--cleanup</code> by default would trim the cache to 80% of the
\r
931 ccache no longer ignores linker arguments for clang since clang warns about
\r
937 Plugged a couple of file descriptor leaks.
\r
942 Fixed a bug where ccache would skip hashing the compiler argument following a
\r
943 <code>-fno-working-directory</code>, <code>-fworking-directory</code>, <code>-nostdinc</code>, <code>-nostdinc++</code>,
\r
944 <code>-remap</code> or <code>-trigraphs</code> option in preprocessor mode.
\r
951 <div class="sect1">
\r
952 <h2 id="_ccache_3_3_4">ccache 3.3.4</h2>
\r
953 <div class="sectionbody">
\r
954 <div class="paragraph"><p>Release date: 2017-02-17</p></div>
\r
955 <div class="sect2">
\r
956 <h3 id="_new_features_and_enhancements_4">New features and enhancements</h3>
\r
957 <div class="ulist"><ul>
\r
960 Documented the different cache statistics counters.
\r
965 <div class="sect2">
\r
966 <h3 id="_bug_fixes_4">Bug fixes</h3>
\r
967 <div class="ulist"><ul>
\r
970 Fixed a regression in ccache 3.3 related to potentially bad content of
\r
971 dependency files when compiling identical source code but with different
\r
972 source paths. This was only partially fixed in 3.3.2 and reverts the new
\r
973 “Names of included files are no longer included in the hash of the
\r
974 compiler’s preprocessed output” feature in 3.3.
\r
979 Corrected statistics counter for <code>-optf</code>/<code>--options-file</code> failure.
\r
984 Fixed undefined behavior warnings in ccache found by <code>-fsanitize=undefined</code>.
\r
991 <div class="sect1">
\r
992 <h2 id="_ccache_3_3_3">ccache 3.3.3</h2>
\r
993 <div class="sectionbody">
\r
994 <div class="paragraph"><p>Release date: 2016-10-26</p></div>
\r
995 <div class="sect2">
\r
996 <h3 id="_bug_fixes_5">Bug fixes</h3>
\r
997 <div class="ulist"><ul>
\r
1000 ccache now detects usage of <code>.incbin</code> assembler directives in the source code
\r
1001 and avoids caching such compilations.
\r
1008 <div class="sect1">
\r
1009 <h2 id="_ccache_3_3_2">ccache 3.3.2</h2>
\r
1010 <div class="sectionbody">
\r
1011 <div class="paragraph"><p>Release date: 2016-09-28</p></div>
\r
1012 <div class="sect2">
\r
1013 <h3 id="_bug_fixes_6">Bug fixes</h3>
\r
1014 <div class="ulist"><ul>
\r
1017 Fixed a regression in ccache 3.3 related to potentially bad content of
\r
1018 dependency files when compiling identical source code but with different
\r
1024 Fixed a regression in ccache 3.3.1: ccache could get confused when using the
\r
1025 compiler option <code>-Wp,</code> to pass multiple options to the preprocessor,
\r
1026 resulting in missing dependency files from direct mode cache hits.
\r
1033 <div class="sect1">
\r
1034 <h2 id="_ccache_3_3_1">ccache 3.3.1</h2>
\r
1035 <div class="sectionbody">
\r
1036 <div class="paragraph"><p>Release date: 2016-09-07</p></div>
\r
1037 <div class="sect2">
\r
1038 <h3 id="_bug_fixes_7">Bug fixes</h3>
\r
1039 <div class="ulist"><ul>
\r
1042 Fixed a problem in the “multiple <code>-arch</code> options” support introduced in
\r
1043 3.3. When using the direct mode (the default), different combinations of
\r
1044 <code>-arch</code> options were not detected properly.
\r
1049 Fixed an issue when compiler option <code>-Wp,-MT,path</code> is used instead of <code>-MT
\r
1050 path</code> (and similar for <code>-MF</code>, <code>-MP</code> and <code>-MQ</code>) and <code>run_second_cpp</code>
\r
1051 (<code>CCACHE_CPP2</code>) is enabled.
\r
1058 <div class="sect1">
\r
1059 <h2 id="_ccache_3_3">ccache 3.3</h2>
\r
1060 <div class="sectionbody">
\r
1061 <div class="paragraph"><p>Release date: 2016-08-27</p></div>
\r
1062 <div class="sect2">
\r
1063 <h3 id="_notes">Notes</h3>
\r
1064 <div class="ulist"><ul>
\r
1067 A C99-compatible compiler is now required to build ccache.
\r
1072 <div class="sect2">
\r
1073 <h3 id="_new_features_and_enhancements_5">New features and enhancements</h3>
\r
1074 <div class="ulist"><ul>
\r
1077 The configuration option <code>run_second_cpp</code> (<code>CCACHE_CPP2</code>) now defaults to
\r
1078 true. This improves ccache’s out-of-the-box experience for compilers that
\r
1079 can’t compile their own preprocessed output with the same outcome as if they
\r
1080 compiled the real source code directly, e.g. newer versions of GCC and Clang.
\r
1085 The configuration option <code>hash_dir</code> (<code>CCACHE_HASHDIR</code>) now defaults to true.
\r
1090 Added a new <code>ignore_headers_in_manifest</code> configuration option, which
\r
1091 specifies headers that should be ignored in the direct mode.
\r
1096 Added a new <code>prefix_command_cpp</code> (<code>CCACHE_PREFIX_CPP</code>) configuration option,
\r
1097 which specifies one or several prefixes to add to the command line ccache
\r
1098 uses when invoking the preprocessor.
\r
1103 Added a new <code>limit_multiple</code> (<code>CCACHE_LIMIT_MULTIPLE</code>) configuration option,
\r
1104 which specifies how much of the cache to remove when cleaning.
\r
1109 Added a new <code>keep_comments_cpp</code> (<code>CCACHE_COMMENTS</code>) configuration option,
\r
1110 which tells ccache not to discard the comments before hashing preprocessor
\r
1111 output. This can be used to check documentation with <strong>-Wdocumentation</strong>.
\r
1116 Added a new sloppiness option <code>no_system_headers</code>, which tells ccache not to
\r
1117 include system headers in manifest files.
\r
1122 Added a new statistics counter that tracks the number of performed cleanups
\r
1123 due to the cache size being over the limit. The value is shown in the output
\r
1124 of “ccache -s”.
\r
1129 Added support for relocating debug info directory using <code>-fdebug-prefix-map</code>.
\r
1130 This allows for cache hits even when <code>hash_dir</code> is used in combination with
\r
1131 <code>base_dir</code>.
\r
1136 Added a new “cache hit rate” field to the output of “ccache -s”.
\r
1141 Added support for caching compilation of assembler code produced by e.g.
\r
1142 “gcc -S file.c”.
\r
1147 Added support for cuda including the -optf/--options-file option.
\r
1152 Added support for Fortran 77.
\r
1157 Added support for multiple <code>-arch</code> options to produce "fat binaries".
\r
1162 Multiple identical <code>-arch</code> arguments are now handled without bailing.
\r
1167 The concatenated form of some long compiler options is now recognized, for
\r
1168 example when using <code>-isystemPATH</code> instead of <code>-isystem PATH</code>.
\r
1173 If hard-linking is enabled and but fails (e.g. due to cross-device linking),
\r
1174 ccache now falls back to copying instead of running the compiler.
\r
1179 Made the <code>hash_dir</code> option only have effect when generating debug info.
\r
1184 ccache now knows how to convert absolute paths to relative paths inside
\r
1185 dependency files when using <code>base_dir</code>.
\r
1190 Improved parsing of <code>-g*</code> options.
\r
1195 Made ccache understand <code>-Wp,-D*</code> options.
\r
1200 ccache now understands the undocumented <code>-coverage</code> (only one dash) GCC
\r
1206 Names of included files are no longer included in the hash of the compiler’s
\r
1207 preprocessed output. This leads to more potential cache hits when not using
\r
1213 Increased buffer size used when reading file data. This improves performance
\r
1219 <div class="sect2">
\r
1220 <h3 id="_bug_fixes_8">Bug fixes</h3>
\r
1221 <div class="ulist"><ul>
\r
1224 Bail out on too hard compiler option <code>-P</code>.
\r
1229 Fixed clang test suite when running on Linux.
\r
1234 Fixed build and test for MinGW32 and Windows.
\r
1241 <div class="sect1">
\r
1242 <h2 id="_ccache_3_2_9">ccache 3.2.9</h2>
\r
1243 <div class="sectionbody">
\r
1244 <div class="paragraph"><p>Release date: 2016-09-28</p></div>
\r
1245 <div class="sect2">
\r
1246 <h3 id="_bug_fixes_9">Bug fixes</h3>
\r
1247 <div class="ulist"><ul>
\r
1250 Fixed a regression in ccache 3.2.8: ccache could get confused when using the
\r
1251 compiler option <code>-Wp,</code> to pass multiple options to the preprocessor,
\r
1252 resulting in missing dependency files from direct mode cache hits.
\r
1259 <div class="sect1">
\r
1260 <h2 id="_ccache_3_2_8">ccache 3.2.8</h2>
\r
1261 <div class="sectionbody">
\r
1262 <div class="paragraph"><p>Release date: 2016-09-07</p></div>
\r
1263 <div class="sect2">
\r
1264 <h3 id="_bug_fixes_10">Bug fixes</h3>
\r
1265 <div class="ulist"><ul>
\r
1268 Fixed an issue when compiler option <code>-Wp,-MT,path</code> is used instead of <code>-MT
\r
1269 path</code> (and similar for <code>-MF</code>, <code>-MP</code> and <code>-MQ</code>) and <code>run_second_cpp</code>
\r
1270 (<code>CCACHE_CPP2</code>) is enabled.
\r
1275 ccache now understands the undocumented <code>-coverage</code> (only one dash) GCC
\r
1283 <div class="sect1">
\r
1284 <h2 id="_ccache_3_2_7">ccache 3.2.7</h2>
\r
1285 <div class="sectionbody">
\r
1286 <div class="paragraph"><p>Release date: 2016-07-20</p></div>
\r
1287 <div class="sect2">
\r
1288 <h3 id="_bug_fixes_11">Bug fixes</h3>
\r
1289 <div class="ulist"><ul>
\r
1292 Fixed a bug which could lead to false cache hits for compiler command lines
\r
1293 with a missing argument to an option that takes an argument.
\r
1298 ccache now knows how to work around a glitch in the output of GCC 6’s
\r
1306 <div class="sect1">
\r
1307 <h2 id="_ccache_3_2_6">ccache 3.2.6</h2>
\r
1308 <div class="sectionbody">
\r
1309 <div class="paragraph"><p>Release date: 2016-07-12</p></div>
\r
1310 <div class="sect2">
\r
1311 <h3 id="_bug_fixes_12">Bug fixes</h3>
\r
1312 <div class="ulist"><ul>
\r
1315 Fixed build problem on QNX, which lacks “SA_RESTART”.
\r
1320 Bail out on compiler option <code>-fstack-usage</code> since it creates a <code>.su</code> file
\r
1321 which ccache currently doesn’t handle.
\r
1326 Fixed a bug where (due to ccache rewriting paths) the compiler could choose
\r
1327 incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path
\r
1328 is absolute and is a symlink.
\r
1335 <div class="sect1">
\r
1336 <h2 id="_ccache_3_2_5">ccache 3.2.5</h2>
\r
1337 <div class="sectionbody">
\r
1338 <div class="paragraph"><p>Release date: 2016-04-17</p></div>
\r
1339 <div class="sect2">
\r
1340 <h3 id="_new_features_and_enhancements_6">New features and enhancements</h3>
\r
1341 <div class="ulist"><ul>
\r
1344 Only pass clang-specific <code>-stdlib=</code> to the preprocessor.
\r
1349 Improved handling of stale NFS handles.
\r
1354 Made it harder to misinterpret documentation of boolean environment settings'
\r
1360 <div class="sect2">
\r
1361 <h3 id="_bug_fixes_13">Bug fixes</h3>
\r
1362 <div class="ulist"><ul>
\r
1365 Include m4 files used by configure.ac in the source dist archives.
\r
1370 Corrected "Performance" section in the manual regarding <code>__DATE_</code>, <code>__TIME__</code>
\r
1371 and <code>__FILE__</code> macros.
\r
1376 Fixed build on Solaris 10+ and AIX 7.
\r
1381 Fixed failure to create directories on QNX.
\r
1386 Don’t (try to) update manifest file in “read-only” and “read-only direct”
\r
1392 Fixed a bug in caching of <code>stat</code> system calls in “file_stat_matches
\r
1393 sloppiness mode”.
\r
1398 Fixed bug in hashing of clang plugins, leading to unnecessary cache misses.
\r
1403 Fixed --print-config to show “pch_defines sloppiness”.
\r
1408 The man page is now built when running “make install” from Git repository
\r
1416 <div class="sect1">
\r
1417 <h2 id="_ccache_3_2_4">ccache 3.2.4</h2>
\r
1418 <div class="sectionbody">
\r
1419 <div class="paragraph"><p>Release date: 2015-10-08</p></div>
\r
1420 <div class="sect2">
\r
1421 <h3 id="_bug_fixes_14">Bug fixes</h3>
\r
1422 <div class="ulist"><ul>
\r
1425 Fixed build error related to zlib on systems with older make versions
\r
1426 (regression in ccache 3.2.3).
\r
1431 Made conversion-to-bool explicit to avoid build warnings (and potential
\r
1432 runtime errors) on legacy systems.
\r
1437 Improved signal handling: Kill compiler on SIGTERM; wait for compiler to exit
\r
1438 before exiting; die appropriately.
\r
1443 Minor fixes related to Windows support.
\r
1448 The correct compression level is now used if compression is requested.
\r
1453 Fixed a bug where cache cleanup could be run too early for caches larger than
\r
1454 64 GiB on 32-bit systems.
\r
1461 <div class="sect1">
\r
1462 <h2 id="_ccache_3_2_3">ccache 3.2.3</h2>
\r
1463 <div class="sectionbody">
\r
1464 <div class="paragraph"><p>Release date: 2015-08-16</p></div>
\r
1465 <div class="sect2">
\r
1466 <h3 id="_new_features_and_enhancements_7">New features and enhancements</h3>
\r
1467 <div class="ulist"><ul>
\r
1470 Added support for compiler option <code>-gsplit-dwarf</code>.
\r
1475 <div class="sect2">
\r
1476 <h3 id="_bug_fixes_15">Bug fixes</h3>
\r
1477 <div class="ulist"><ul>
\r
1480 Support external zlib in nonstandard directory.
\r
1485 Avoid calling <code>exit()</code> inside an exit handler.
\r
1490 Let exit handler terminate properly.
\r
1495 Bail out on compiler option <code>--save-temps</code> in addition to <code>-save-temps</code>.
\r
1500 Only log "Disabling direct mode" once when failing to read potential include
\r
1508 <div class="sect1">
\r
1509 <h2 id="_ccache_3_2_2">ccache 3.2.2</h2>
\r
1510 <div class="sectionbody">
\r
1511 <div class="paragraph"><p>Release date: 2015-05-10</p></div>
\r
1512 <div class="sect2">
\r
1513 <h3 id="_new_features_and_enhancements_8">New features and enhancements</h3>
\r
1514 <div class="ulist"><ul>
\r
1517 Added support for <code>CCACHE_COMPILERCHECK=string:<value></code>. This is a faster
\r
1518 alternative to <code>CCACHE_COMPILERCHECK=<command></code> if the command’s output can
\r
1519 be precalculated by the build system.
\r
1524 Add support for caching code coverage results (compiling for gcov).
\r
1529 <div class="sect2">
\r
1530 <h3 id="_bug_fixes_16">Bug fixes</h3>
\r
1531 <div class="ulist"><ul>
\r
1534 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.
\r
1535 This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to
\r
1536 clear the cache to get new results.
\r
1541 Don’t try to reset a non-existing stats file. This avoids “No such file or
\r
1542 directory” messages in the ccache log when the cache directory doesn’t
\r
1548 Fixed a bug where ccache deleted clang diagnostics after compiler failures.
\r
1553 Avoid performing an unnecessary copy of the object file on a cache miss.
\r
1558 Bail out on too hard compiler option <code>-fmodules</code>.
\r
1563 Bail out on too hard compiler option <code>-fplugin=libcc1plugin</code> (interaction
\r
1569 Fixed build error when compiling ccache with recent clang versions.
\r
1574 Removed signal-unsafe code from signal handler.
\r
1579 Corrected logic for when to output cached stderr.
\r
1584 Wipe the whole cached result on failure retrieving a cached file.
\r
1589 Fixed build error when compiling ccache with recent clang versions.
\r
1596 <div class="sect1">
\r
1597 <h2 id="_ccache_3_2_1">ccache 3.2.1</h2>
\r
1598 <div class="sectionbody">
\r
1599 <div class="paragraph"><p>Release date: 2014-12-10</p></div>
\r
1600 <div class="sect2">
\r
1601 <h3 id="_bug_fixes_17">Bug fixes</h3>
\r
1602 <div class="ulist"><ul>
\r
1605 Fixed regression in temporary file handling, which lead to incorrect
\r
1606 permissions for stats, manifest and ccache.conf files in the cache.
\r
1611 <code>CACHEDIR.TAG</code> files are now created in the [0-9a-f] subdirectories so that
\r
1612 ccache.conf is not lost in backups.
\r
1617 Made the default cache size suffix <code>G</code>, as previously documented.
\r
1622 <code>-fdiagnostics-color=auto</code> is now passed to the compiler even if stderr is
\r
1623 redirected. This fixes a problem when, for instance, a configure test probes
\r
1624 if the compiler (wrapped via ccache) supports <code>-fdiagnostics-color=auto</code>.
\r
1629 Added missing documentation for <code>max_files</code> and <code>max_size</code> configuration
\r
1637 <div class="sect1">
\r
1638 <h2 id="_ccache_3_2">ccache 3.2</h2>
\r
1639 <div class="sectionbody">
\r
1640 <div class="paragraph"><p>Release date: 2014-11-17</p></div>
\r
1641 <div class="sect2">
\r
1642 <h3 id="_new_features_and_enhancements_9">New features and enhancements</h3>
\r
1643 <div class="ulist"><ul>
\r
1646 Added support for configuring ccache via one or several configuration files
\r
1647 instead of via environment variables. Environment variables still have
\r
1648 priority but are no longer the recommended way of customizing ccache
\r
1649 behavior. See the manual for more information.
\r
1654 Added support for compiler error/warning messages with color.
\r
1659 Made creation of temporary directories and cache directories smarter to avoid
\r
1660 unnecessary <code>stat</code> calls.
\r
1665 Improved efficiency of the algorithm that scans for <code>__DATE_</code> and <code>__TIME__</code>
\r
1666 tokens in the hashed source code.
\r
1671 Added support for several binaries (separated by space) in <code>CCACHE_PREFIX</code>.
\r
1676 The <code>-c</code> option is no longer passed to the preprocessor. This fixes problems
\r
1677 with clang and Solaris’s C++ compiler.
\r
1682 ccache no longer passes preprocessor options like <code>-D</code> and <code>-I</code> to the
\r
1683 compiler when compiling preprocessed output. This fixes warnings emitted by
\r
1689 Compiler options <code>-fprofile-generate</code>, <code>-fprofile-arcs</code>, <code>-fprofile-use</code> and
\r
1690 <code>-fbranch-probabilities</code> are now handled without bailing.
\r
1695 Added support for clang’s <code>--serialize-diagnostic</code> option, storing the
\r
1696 diagnostic file (<code>.dia</code>) in the cache.
\r
1701 Added support for precompiled headers when using clang.
\r
1706 Added support for clang <code>.pth</code> (pretokenized header) files.
\r
1711 Changed the <code>-x</code> language option to use the new objective C standard for GCC
\r
1717 On a cache miss, ccache now instructs the compiler to create the object file
\r
1718 at the real destination and then copies the file into the cache instead of
\r
1719 the other way around. This is needed to support compiler options like
\r
1720 <code>-fprofile-arcs</code> and <code>--serialize-diagnostics</code>.
\r
1725 ccache now checks that included files' ctimes aren’t too new. This check can
\r
1726 be turned off by adding <code>include_file_ctime</code> to the “ccache sloppiness”
\r
1732 Added possibility to get cache hits based on filename, size, mtime and ctime
\r
1733 only. On other words, source code files are not even read, only stat-ed. This
\r
1734 operation mode is opt-in by adding <code>file_stat_matches</code> to the “ccache
\r
1735 sloppiness” setting.
\r
1740 The filename part of options like <code>-Wp,-MDfilename</code> is no longer included in
\r
1741 the hash since the filename doesn’t have any bearing on the result.
\r
1746 Added a “read-only direct” configuration setting, which is like the
\r
1747 ordinary read-only setting except that ccache will only try to retrieve
\r
1748 results from the cache using the direct mode, not the preprocessor mode.
\r
1753 The display and interpretation of cache size has been changed to use SI
\r
1759 Default cache size is now 5 GB (was previously 1 GiB).
\r
1764 Added configuration option to set the compression level of compressed object
\r
1765 files in the cache.
\r
1770 Added support for <code>@file</code> and <code>-@file</code> arguments (reading options from a
\r
1776 <code>-Wl,</code> options are no longer included in the hash since they don’t affect
\r
1782 Bail out on too hard compiler option <code>-Wp,-P</code>.
\r
1787 Optimized MD4 calculation code on little-endian systems.
\r
1792 Various improvements and fixes on win32.
\r
1797 Improved logging to the ccache log file.
\r
1802 Added <code>--dump-manifest</code> command-line option for debugging purposes.
\r
1807 Added <code>--with-bundled-zlib</code> configure option.
\r
1812 Upgraded bundled zlib to version 1.2.8.
\r
1817 Improved <code>dev.mk</code> to be more platform independent.
\r
1822 Made the test suite work with clang and gcc-llvm on OS X.
\r
1827 Various other improvements of the test suite.
\r
1832 <div class="sect2">
\r
1833 <h3 id="_bug_fixes_18">Bug fixes</h3>
\r
1834 <div class="ulist"><ul>
\r
1837 Any previous <code>.stderr</code> is now removed from the cache when recaching.
\r
1842 Fixed an issue when handling the <code>-arch</code> compiler option with an argument.
\r
1847 Fixed race condition when creating the initial cache directory.
\r
1852 Fixed test suite failures when <code>CC</code> is a ccache-wrapped compiler.
\r
1859 <div class="sect1">
\r
1860 <h2 id="_ccache_3_1_12">ccache 3.1.12</h2>
\r
1861 <div class="sectionbody">
\r
1862 <div class="paragraph"><p>Release date: 2016-07-12</p></div>
\r
1863 <div class="sect2">
\r
1864 <h3 id="_bug_fixes_19">Bug fixes</h3>
\r
1865 <div class="ulist"><ul>
\r
1868 Fixed a bug where (due to ccache rewriting paths) the compiler could choose
\r
1869 incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path
\r
1870 is absolute and is a symlink.
\r
1877 <div class="sect1">
\r
1878 <h2 id="_ccache_3_1_11">ccache 3.1.11</h2>
\r
1879 <div class="sectionbody">
\r
1880 <div class="paragraph"><p>Release date: 2015-03-07</p></div>
\r
1881 <div class="sect2">
\r
1882 <h3 id="_bug_fixes_20">Bug fixes</h3>
\r
1883 <div class="ulist"><ul>
\r
1886 Fixed bug which could result in false cache hits when source code contains
\r
1887 <code>'"'</code> followed by <code>" /*"</code> or <code>" //"</code> (with variations).
\r
1892 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.
\r
1893 This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to
\r
1894 clear the cache to get new results.
\r
1899 Don’t try to reset a non-existing stats file. This avoids “No such file or
\r
1900 directory” messages in the ccache log when the cache directory doesn’t
\r
1908 <div class="sect1">
\r
1909 <h2 id="_ccache_3_1_10">ccache 3.1.10</h2>
\r
1910 <div class="sectionbody">
\r
1911 <div class="paragraph"><p>Release date: 2014-10-19</p></div>
\r
1912 <div class="sect2">
\r
1913 <h3 id="_new_features_and_enhancements_10">New features and enhancements</h3>
\r
1914 <div class="ulist"><ul>
\r
1917 Added support for the <code>-Xclang</code> compiler option.
\r
1922 Improved handling of exit code of internally executed processes.
\r
1927 Zero length object files in the cache are now rejected as invalid.
\r
1932 Bail out on option <code>-gsplit-dwarf</code> (since it produces multiple output files).
\r
1937 Compiler option <code>-fdebug-prefix-map</code> is now ignored (not part of the hash).
\r
1938 (The <code>-fdebug-prefix-map</code> option may be used in combination with
\r
1939 <code>CCACHE_BASEDIR</code> to reuse results across different directories.)
\r
1944 Added note in documentation that <code>--ccache-skip</code> currently does not mean
\r
1945 “don’t hash the following option”.
\r
1950 To enable support for precompiled headers (PCH), <code>CCACHE_SLOPPINESS</code> now also
\r
1951 needs to include the new <code>pch_defines</code> sloppiness. This is because ccache
\r
1952 can’t detect changes in the source code when only defined macros have been
\r
1958 Stale files in the internal temporary directory (<code><ccache_dir>/tmp</code>) are now
\r
1959 cleaned up if they are older than one hour.
\r
1964 <div class="sect2">
\r
1965 <h3 id="_bug_fixes_21">Bug fixes</h3>
\r
1966 <div class="ulist"><ul>
\r
1969 Fixed path canonicalization in <code>make_relative_path()</code> when path doesn’t
\r
1975 Fixed bug in <code>common_dir_prefix_length()</code>. This corrects the <code>CCACHE_BASEDIR</code>
\r
1981 ccache no longer tries to create the cache directory when <code>CCACHE_DISABLE</code> is
\r
1987 Fixed bug when reading manifests with a very large number of file info
\r
1993 Fixed problem with logging of current working directory.
\r
2000 <div class="sect1">
\r
2001 <h2 id="_ccache_3_1_9">ccache 3.1.9</h2>
\r
2002 <div class="sectionbody">
\r
2003 <div class="paragraph"><p>Release date: 2013-01-06</p></div>
\r
2004 <div class="sect2">
\r
2005 <h3 id="_bug_fixes_22">Bug fixes</h3>
\r
2006 <div class="ulist"><ul>
\r
2009 The EAGAIN signal is now handled correctly when emitting cached stderr
\r
2010 output. This fixes a problem triggered by large error outputs from the
\r
2016 Subdirectories in the cache are no longer created in read-only mode.
\r
2021 Fixed so that ccache’s log file descriptor is not made available to the
\r
2027 Improved error reporting when failing to create temporary stdout/stderr files
\r
2028 when executing the compiler.
\r
2033 Disappearing temporary stdout/stderr files are now handled gracefully.
\r
2038 <div class="sect2">
\r
2039 <h3 id="_other">Other</h3>
\r
2040 <div class="ulist"><ul>
\r
2043 Fixed test suite to work on ecryptfs.
\r
2050 <div class="sect1">
\r
2051 <h2 id="_ccache_3_1_8">ccache 3.1.8</h2>
\r
2052 <div class="sectionbody">
\r
2053 <div class="paragraph"><p>Release date: 2012-08-11</p></div>
\r
2054 <div class="sect2">
\r
2055 <h3 id="_new_features_and_enhancements_11">New features and enhancements</h3>
\r
2056 <div class="ulist"><ul>
\r
2059 Made paths to dependency files relative in order to increase cache hits.
\r
2064 Added work-around to make ccache work with buggy GCC 4.1 when creating a
\r
2065 pre-compiled header.
\r
2070 Clang plugins are now hashed to catch plugin upgrades.
\r
2075 <div class="sect2">
\r
2076 <h3 id="_bug_fixes_23">Bug fixes</h3>
\r
2077 <div class="ulist"><ul>
\r
2080 Fixed crash when the current working directory has been removed.
\r
2085 Fixed crash when stderr is closed.
\r
2090 Corrected a corner case when parsing backslash escapes in string
\r
2096 Paths are now correctly canonicalized when computing paths relative to the
\r
2102 <div class="sect2">
\r
2103 <h3 id="_other_2">Other</h3>
\r
2104 <div class="ulist"><ul>
\r
2107 Made git version macro work when compiling outside of the source directory.
\r
2112 Fixed <code>static_assert</code> macro definition clash with GCC 4.7.
\r
2119 <div class="sect1">
\r
2120 <h2 id="_ccache_3_1_7">ccache 3.1.7</h2>
\r
2121 <div class="sectionbody">
\r
2122 <div class="paragraph"><p>Release date: 2012-01-08</p></div>
\r
2123 <div class="sect2">
\r
2124 <h3 id="_bug_fixes_24">Bug fixes</h3>
\r
2125 <div class="ulist"><ul>
\r
2128 Non-writable <code>CCACHE_DIR</code> is now handled gracefully when <code>CCACHE_READONLY</code> is
\r
2134 Made failure to create files (typically due to bad directory permissions) in
\r
2135 the cache directory fatal. Previously, such failures were silently and
\r
2136 erroneously flagged as "compiler produced stdout".
\r
2141 Both the <code>-specs=file</code> and <code>--specs=file</code> forms are now recognized.
\r
2146 Added recognition and hashing of GCC plugins specified with <code>-fplugin=file</code>.
\r
2151 <code>CCACHE_COMPILERCHECK</code> now also determines how to hash explicit specs files
\r
2152 (<code>-specs=file</code>).
\r
2157 Added <code>CPATH</code>, <code>C_INCLUDE_PATH</code> and similar environment variables to the hash
\r
2158 to avoid false cache hits when such variables have changed.
\r
2163 Corrected log message when unify mode is enabled.
\r
2168 Reverted the GCC bug compatibility introduced in ccache 3.1.5 for <code>-MT</code>/<code>-MQ</code>
\r
2169 options with concatenated arguments. (The bug is fixed in recent GCC
\r
2175 <div class="sect2">
\r
2176 <h3 id="_other_3">Other</h3>
\r
2177 <div class="ulist"><ul>
\r
2180 Corrected license header for <code>mdfour.c</code>.
\r
2185 Improved documentation on how to fix bad object files in the cache.
\r
2192 <div class="sect1">
\r
2193 <h2 id="_ccache_3_1_6">ccache 3.1.6</h2>
\r
2194 <div class="sectionbody">
\r
2195 <div class="paragraph"><p>Release date: 2011-08-21</p></div>
\r
2196 <div class="sect2">
\r
2197 <h3 id="_new_features_and_enhancements_12">New features and enhancements</h3>
\r
2198 <div class="ulist"><ul>
\r
2201 Rewrite argument to <code>--sysroot</code> if <code>CCACHE_BASEDIR</code> is used.
\r
2206 <div class="sect2">
\r
2207 <h3 id="_bug_fixes_25">Bug fixes</h3>
\r
2208 <div class="ulist"><ul>
\r
2211 Don’t crash if <code>getcwd()</code> fails.
\r
2216 Fixed alignment of “called for preprocessing” counter.
\r
2223 <div class="sect1">
\r
2224 <h2 id="_ccache_3_1_5">ccache 3.1.5</h2>
\r
2225 <div class="sectionbody">
\r
2226 <div class="paragraph"><p>Release date: 2011-05-29</p></div>
\r
2227 <div class="sect2">
\r
2228 <h3 id="_new_features_and_enhancements_13">New features and enhancements</h3>
\r
2229 <div class="ulist"><ul>
\r
2232 Added a new statistics counter named “called for preprocessing”.
\r
2237 The original command line is now logged to the file specified with
\r
2238 <code>CCACHE_LOGFILE</code>.
\r
2243 Improved error logging when system calls fail.
\r
2248 Added support for rewriting absolute paths in <code>-F</code>/<code>-iframework</code> GCC
\r
2254 Improved order of statistics counters in <code>ccache -s</code> output.
\r
2259 <div class="sect2">
\r
2260 <h3 id="_bug_fixes_26">Bug fixes</h3>
\r
2261 <div class="ulist"><ul>
\r
2264 The <code>-MF</code>/<code>-MT</code>/<code>-MQ</code> options with concatenated argument are now handled
\r
2265 correctly when they are last on the command line.
\r
2270 ccache is now bug compatible with GCC for the <code>-MT</code>/<code>-MQ</code> options with
\r
2271 concatenated arguments.
\r
2276 Fixed a minor memory leak.
\r
2281 Systems that lack (and don’t need to be linked with) libm are now supported.
\r
2288 <div class="sect1">
\r
2289 <h2 id="_ccache_3_1_4">ccache 3.1.4</h2>
\r
2290 <div class="sectionbody">
\r
2291 <div class="paragraph"><p>Release date: 2011-01-09</p></div>
\r
2292 <div class="sect2">
\r
2293 <h3 id="_bug_fixes_27">Bug fixes</h3>
\r
2294 <div class="ulist"><ul>
\r
2297 Made a work-around for a bug in <code>gzputc()</code> in zlib 1.2.5.
\r
2302 Corrupt manifest files are now removed so that they won’t block direct mode
\r
2308 ccache now copes with file systems that don’t know about symbolic links.
\r
2313 The file handle in now correctly closed on write error when trying to create
\r
2321 <div class="sect1">
\r
2322 <h2 id="_ccache_3_1_3">ccache 3.1.3</h2>
\r
2323 <div class="sectionbody">
\r
2324 <div class="paragraph"><p>Release date: 2010-11-28</p></div>
\r
2325 <div class="sect2">
\r
2326 <h3 id="_bug_fixes_28">Bug fixes</h3>
\r
2327 <div class="ulist"><ul>
\r
2330 The -MFarg, -MTarg and -MQarg compiler options (i.e, without space between
\r
2331 option and argument) are now handled correctly.
\r
2336 <div class="sect2">
\r
2337 <h3 id="_other_4">Other</h3>
\r
2338 <div class="ulist"><ul>
\r
2341 Portability fixes for HP-UX 11.00 and other esoteric systems.
\r
2348 <div class="sect1">
\r
2349 <h2 id="_ccache_3_1_2">ccache 3.1.2</h2>
\r
2350 <div class="sectionbody">
\r
2351 <div class="paragraph"><p>Release date: 2010-11-21</p></div>
\r
2352 <div class="sect2">
\r
2353 <h3 id="_bug_fixes_29">Bug fixes</h3>
\r
2354 <div class="ulist"><ul>
\r
2357 Bail out on too hard compiler options <code>-fdump-*</code>.
\r
2362 NULL return values from malloc/calloc of zero bytes are now handled
\r
2368 Fixed issue when parsing precompiler output on AIX.
\r
2373 <div class="sect2">
\r
2374 <h3 id="_other_5">Other</h3>
\r
2375 <div class="ulist"><ul>
\r
2378 Improved documentation on which information is included in the hash sum.
\r
2383 Made the “too new header file” test case work on file systems with
\r
2384 unsynchronized clocks.
\r
2389 The test suite now also works on systems that lack a /dev/zero.
\r
2396 <div class="sect1">
\r
2397 <h2 id="_ccache_3_1_1">ccache 3.1.1</h2>
\r
2398 <div class="sectionbody">
\r
2399 <div class="paragraph"><p>Release date: 2010-11-07</p></div>
\r
2400 <div class="sect2">
\r
2401 <h3 id="_bug_fixes_30">Bug fixes</h3>
\r
2402 <div class="ulist"><ul>
\r
2405 ccache now falls back to preprocessor mode when a non-regular include file
\r
2406 (device, socket, etc) has been detected so that potential hanging due to
\r
2407 blocking reads is avoided.
\r
2412 CRC errors are now detected when decompressing compressed files in the cache.
\r
2417 Fixed potential object file corruption race on NFS.
\r
2422 Minor documentation corrections.
\r
2427 Fixed configure detection of ar.
\r
2432 ccache development version (set by dev.mk) now works with gits whose
\r
2433 <code>describe</code> command doesn’t understand <code>--dirty</code>.
\r
2438 <div class="sect2">
\r
2439 <h3 id="_other_6">Other</h3>
\r
2440 <div class="ulist"><ul>
\r
2443 Minor debug log message improvements.
\r
2450 <div class="sect1">
\r
2451 <h2 id="_ccache_3_1">ccache 3.1</h2>
\r
2452 <div class="sectionbody">
\r
2453 <div class="paragraph"><p>Release date: 2010-09-16</p></div>
\r
2454 <div class="sect2">
\r
2455 <h3 id="_new_features_and_enhancements_14">New features and enhancements</h3>
\r
2456 <div class="ulist"><ul>
\r
2459 Added support for hashing the output of a custom command (e.g. <code>%compiler%
\r
2460 --version</code>) to identify the compiler instead of stat-ing or hashing the
\r
2461 compiler binary. This can improve robustness when the compiler (as seen by
\r
2462 ccache) actually isn’t the real compiler but another compiler wrapper.
\r
2467 Added support for caching compilations that use precompiled headers. (See the
\r
2468 manual for important instructions regarding this.)
\r
2473 Locking of the files containing statistics counters is now done using
\r
2474 symlinks instead of POSIX locks. This should make ccache behave a lot better
\r
2475 on file systems where POSIX locks are slow or broken (e.g. NFS on some
\r
2481 Manifest files are now updated without the need of taking locks.
\r
2486 Updates of statistics counters are now always done in one of the sub-level
\r
2487 statistics files. This reduces lock contention, which especially improves
\r
2488 performance on slow NFS mounts.
\r
2493 Reading and writing of statistics counters has been made forward-compatible
\r
2494 (unknown counters are retained).
\r
2499 Files are now read without using <code>mmap()</code>. This has two benefits: it’s more
\r
2500 robust against file changes during reading and it improves performance on
\r
2501 poor systems where <code>mmap()</code> doesn’t use the disk cache.
\r
2506 Added <code>.cp</code> and <code>.CP</code> as known C++ suffixes.
\r
2516 Added <code>-install_name</code> as an option known to take an argument. (This improves
\r
2517 statistics when using the Darwin linker.)
\r
2522 <div class="sect2">
\r
2523 <h3 id="_bug_fixes_31">Bug fixes</h3>
\r
2524 <div class="ulist"><ul>
\r
2527 Non-fatal error messages are now never printed to stderr but logged instead.
\r
2532 Fixed a bug affecting failing commands when <code>--ccache-skip</code> is used.
\r
2537 Made <code>--ccache-skip</code> work for all options.
\r
2542 EINTR is now handled correctly.
\r
2547 <div class="sect2">
\r
2548 <h3 id="_other_7">Other</h3>
\r
2549 <div class="ulist"><ul>
\r
2552 Work on porting ccache to win32 (native), mostly done by Ramiro Polla. The
\r
2553 port is not yet finished, but will hopefully be complete in some subsequent
\r
2559 Added a <code>--nostats</code> flag to the performance benchmark program.
\r
2564 Made the performance benchmark program more accurate when measuring cache
\r
2570 Added a new test framework for unit tests written in C.
\r
2575 Got rid of <code>configure-dev</code>; dev mode is now given by <code>dev.mk.in</code> presence.
\r
2580 Improved documentation on how to combine ccache with other compiler wrappers
\r
2581 (like <code>distcc</code>).
\r
2586 New <code>LICENSE.txt</code> file with licensing and copyright details about bundled
\r
2592 New <code>AUTHORS.txt</code> file with a list of ccache contributors.
\r
2597 New <code>HACKING.txt</code> file with some notes about ccache code conventions.
\r
2604 <div class="sect1">
\r
2605 <h2 id="_ccache_3_0_1">ccache 3.0.1</h2>
\r
2606 <div class="sectionbody">
\r
2607 <div class="paragraph"><p>Release date: 2010-07-15</p></div>
\r
2608 <div class="sect2">
\r
2609 <h3 id="_bug_fixes_32">Bug fixes</h3>
\r
2610 <div class="ulist"><ul>
\r
2613 The statistics counter “called for link” is now correctly updated when
\r
2614 linking with a single object file.
\r
2619 Fixed a problem with out-of-source builds.
\r
2626 <div class="sect1">
\r
2627 <h2 id="_ccache_3_0">ccache 3.0</h2>
\r
2628 <div class="sectionbody">
\r
2629 <div class="paragraph"><p>Release date: 2010-06-20</p></div>
\r
2630 <div class="sect2">
\r
2631 <h3 id="_general">General</h3>
\r
2632 <div class="ulist"><ul>
\r
2635 ccache is now licensed under the GNU General Public License (GPL) version 3
\r
2641 <div class="sect2">
\r
2642 <h3 id="_upgrade_notes">Upgrade notes</h3>
\r
2643 <div class="ulist"><ul>
\r
2646 The way the hashes are calculated has changed, so you won’t get cache hits
\r
2647 for compilation results stored by older ccache versions. Because of this, you
\r
2648 might as well clear the old cache directory with <code>ccache --clear</code> if you
\r
2649 want, unless you plan to keep using an older ccache version.
\r
2654 <div class="sect2">
\r
2655 <h3 id="_new_features_and_enhancements_15">New features and enhancements</h3>
\r
2656 <div class="ulist"><ul>
\r
2659 ccache now has a “direct mode” where it computes a hash of the source code
\r
2660 (including all included files) and compiler options without running the
\r
2661 preprocessor. By not running the preprocessor, CPU usage is reduced; the
\r
2662 speed is somewhere between 1 and 5 times that of ccache running in
\r
2663 traditional mode, depending on the circumstances. The speedup will be higher
\r
2664 when I/O is fast (e.g., when files are in the disk cache). The direct mode
\r
2665 can be disabled by setting <code>CCACHE_NODIRECT</code>.
\r
2670 Support has been added for rewriting absolute paths to relative paths when
\r
2671 hashing, in order to increase cache hit rate when building the same source
\r
2672 code in different directories even when compiling with <code>-g</code> and when using
\r
2673 absolute include directory paths. This is done by setting the
\r
2674 <code>CCACHE_BASEDIR</code> environment variable to an absolute path that specifies
\r
2675 which paths to rewrite.
\r
2680 Object files are now optionally stored compressed in the cache. The runtime
\r
2681 cost is negligible, and more files will fit in the ccache directory and in
\r
2682 the disk cache. Set <code>CCACHE_COMPRESS</code> to enable object file compression. Note
\r
2683 that you can’t use compression in combination with the hard link feature.
\r
2688 A <code>CCACHE_COMPILERCHECK</code> option has been added. This option tells ccache what
\r
2689 compiler-identifying information to hash to ensure that results retrieved
\r
2690 from the cache are accurate. Possible values are: none (don’t hash anything),
\r
2691 mtime (hash the compiler’s mtime and size) and content (hash the content of
\r
2692 the compiler binary). The default is mtime.
\r
2697 It is now possible to specify extra files whose contents should be included
\r
2698 in the hash sum by setting the <code>CCACHE_EXTRAFILES</code> option.
\r
2703 Added support for Objective-C and Objective-C++. The statistics counter
\r
2704 “not a C/C++ file” has been renamed to “unsupported source language”.
\r
2709 Added support for the <code>-x</code> compiler option.
\r
2714 Added support for long command-line options.
\r
2719 A <code>CACHEDIR.TAG</code> file is now created in the cache directory. See
\r
2720 <a href="http://www.brynosaurus.com/cachedir/">http://www.brynosaurus.com/cachedir/</a>.
\r
2725 Messages printed to the debug log (specified by <code>CCACHE_LOGFILE</code>) have been
\r
2731 You can relax some checks that ccache does in direct mode by setting
\r
2732 <code>CCACHE_SLOPPINESS</code>. See the manual for more information.
\r
2737 <code>CCACHE_TEMPDIR</code> no longer needs to be on the same filesystem as
\r
2738 <code>CCACHE_DIR</code>.
\r
2743 The default value of <code>CCACHE_TEMPDIR</code> has been changed to <code>$CCACHE_DIR/tmp</code>
\r
2744 to avoid cluttering the top directory.
\r
2749 Temporary files that later will be moved into the cache are now created in
\r
2750 the cache directory they will end up in. This makes ccache more friendly to
\r
2751 Linux’s directory layout.
\r
2756 Improved the test suite and added tests for most of the new functionality.
\r
2757 It’s now also possible to specify a subset of tests to run.
\r
2762 Standard error output from the compiler is now only stored in the cache if
\r
2763 it’s non-empty.
\r
2768 If the compiler produces no object file or an empty object file, but gives a
\r
2769 zero exit status (could be due to a file system problem, a buggy program
\r
2770 specified by <code>CCACHE_PREFIX</code>, etc.), ccache copes with it properly.
\r
2775 Added <code>installcheck</code> and <code>distcheck</code> make targets.
\r
2780 Clarified cache size limit options' and cleanup semantics.
\r
2785 Improved display of cache max size values.
\r
2790 The following options are no longer hashed in the preprocessor mode:
\r
2791 <code>-imacros</code>, <code>-imultilib</code>, <code>-iprefix</code>, <code>-iquote</code>, <code>-isysroot</code>, <code>-iwithprefix</code>,
\r
2792 <code>-iwithprefixbefore</code>, <code>-nostdinc</code>, <code>-nostdinc++</code> and <code>-U</code>.
\r
2797 <div class="sect2">
\r
2798 <h3 id="_bug_fixes_33">Bug fixes</h3>
\r
2799 <div class="ulist"><ul>
\r
2802 Various portability improvements.
\r
2807 Improved detection of home directory.
\r
2812 User-defined <code>CPPFLAGS</code> and <code>LDFLAGS</code> are now respected in the Makefile.
\r
2822 Computation of the hash sum has been improved to decrease the risk of hash
\r
2823 collisions. For instance, the compiler options <code>-X -Y</code> and <code>-X-Y</code> previously
\r
2824 contributed equally to the hash sum.
\r
2829 Bail out on too hard compiler options <code>--coverage</code>, <code>-fprofile-arcs</code>,
\r
2830 <code>-fprofile-generate</code>, <code>-fprofile-use</code>, <code>-frepo</code>, <code>-ftest-coverage</code> and
\r
2831 <code>-save-temps</code>. Also bail out on <code>@file</code> style options.
\r
2836 Errors when using multiple <code>-arch</code> compiler options are now noted as
\r
2837 “unsupported compiler option”.
\r
2842 <code>-MD</code>/<code>-MMD</code> options without <code>-MT</code>/<code>-MF</code> are now handled correctly.
\r
2847 The <code>-finput-charset</code> option is now handled correctly.
\r
2852 Added support for <code>-Wp,-MD</code> and <code>-Wp,-MMD</code> options.
\r
2857 The compiler options <code>-Xassembler</code>, <code>-b</code>, <code>-G</code> and <code>-V</code> are now correctly
\r
2858 recognized as taking an argument.
\r
2863 Debug information containing line numbers of predefined and command-line
\r
2864 macros (enabled with the compiler option <code>-g3</code>) will now be correct.
\r
2869 Corrected LRU cleanup handling of object files.
\r
2874 <code>utimes()</code> is now used instead of <code>utime()</code> when available.
\r
2879 Non-writable cache directories are now handled gracefully.
\r
2884 Corrected documentation about sharing the cache directory.
\r
2889 Fixed compilation warnings from GCC 4.3.
\r
2894 The command specified by <code>CCACHE_PREFIX</code> is no longer part of the hash.
\r
2899 Fixed bad memory access spotted by Valgrind.
\r
2904 Fixed a bug in <code>x_realloc</code>.
\r
2909 Freed memory is no longer referenced when compiling a <code>.i</code>/<code>.ii</code> file and
\r
2910 falling back to running the real compiler.
\r
2915 The test suite is now immune to external values of the <code>CCACHE_*</code> environment
\r
2921 Improved detection of recursive invocation.
\r
2926 The ccache binary is now not unconditionally stripped when installing.
\r
2931 Statistics counters are now correctly updated for -E option failures and
\r
2940 <div id="footnotes"><hr /></div>
\r
2942 <div id="footer-text">
\r
2945 2018-02-11 15:20:55 CET
\r
projects / platform / upstream / ccache.git / blob