Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 326291

Summary: Add a warning message about compilation failures when using ccache
Product: Documentation Reporter: Markos Chandras (RETIRED) <hwoarang>
Component: [OLD] Portage DocumentationAssignee: nm (RETIRED) <nightmorph>
Severity: normal CC: dev-portage, docs-team, toolchain
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Package list:
Runtime testing required: ---
Bug Depends on:    
Bug Blocks: 327945    

Description Markos Chandras (RETIRED) gentoo-dev 2010-06-30 10:54:07 UTC

Could you please add a warning message on

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 gentoo-dev 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) gentoo-dev 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) gentoo-dev 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.

Comment 4 Zac Medico gentoo-dev 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:;a=commit;h=e8cc36816634b0bfb22142941dbf579960343c99
Comment 5 nm (RETIRED) gentoo-dev 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) gentoo-dev 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!