Bug 326291 – Add a warning message about compilation failures when using ccache

• Product: Documentation
• Status: RESOLVED FIXED

[Description Markos Chandras (RETIRED) 2010-06-30 10:54:07 UTC]

Hi

Could you please add a warning message on 

http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=3#doc_chap3


when using ccache? Quite a lot of bugs are being reported to our bugzilla when ccache is enabled which sometimes links to broken compilation with messages like

"file not recognized: File truncated"

[Comment 1 Zac Medico 2010-07-01 05:06:20 UTC]

I wonder if this "file not recognized: File truncated" error indicates some kind of bug in ccache.

[Comment 2 Markos Chandras (RETIRED) 2010-07-01 07:56:06 UTC]

I guess is just corrupted object files or leftovers in ccache storage,we have been hitting with such errors for more than a year. Disabling ccache makes the feature go away. So a warning would be nice

[Comment 3 Samuli Suominen (RETIRED) 2010-07-12 16:50:42 UTC]

(In reply to comment #1)
> I wonder if this "file not recognized: File truncated" error indicates some
> kind of bug in ccache.
> 

^ http://bugs.gentoo.org/show_bug.cgi?id=79519#c18

[Comment 4 Zac Medico 2010-07-12 22:44:40 UTC]

CCing docs team for the handbook part.

Now there's a warning in the make.conf.5 manpage:
http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=e8cc36816634b0bfb22142941dbf579960343c99

[Comment 5 nm (RETIRED) 2010-07-12 22:52:29 UTC]

More or less the same issue as bug 327945, but we'll be sure to add a warning bit on compilation failures and stale cache files.

Marking as a blocker of #327945.

[Comment 6 nm (RETIRED) 2010-07-13 00:29:12 UTC]

Fixed in CVS. 

From the commit log:

"redo the ccache section so it's not recommended for everyone. make it clear that it's for folks doing development work, and that ccache is known to cause numerous compile failures. also added a suggestion to disable ccache and recompile before reporting any bugs."

Portage team, can I get you to put some of the handbook text into the ccache section of the manpage? something a bit more explanatory than the initial one-liner would be useful. Thanks!