| … | |
… | |
| 2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 6 | |
6 | |
| 7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.36 2008/03/02 17:58:39 rane Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.37 2010/07/13 00:26:59 nightmorph Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | Discover the features Portage has, such as support for distributed compiling, |
12 | Discover the features Portage has, such as support for distributed compiling, |
| 13 | ccache and more. |
13 | ccache and more. |
| 14 | </abstract> |
14 | </abstract> |
| 15 | |
15 | |
| 16 | <version>1.32</version> |
16 | <version>1.33</version> |
| 17 | <date>2008-03-02</date> |
17 | <date>2010-07-12</date> |
| 18 | |
18 | |
| 19 | <section> |
19 | <section> |
| 20 | <title>Portage Features</title> |
20 | <title>Portage Features</title> |
| 21 | <body> |
21 | <body> |
| 22 | |
22 | |
| … | |
… | |
| 130 | <subsection> |
130 | <subsection> |
| 131 | <title>About ccache</title> |
131 | <title>About ccache</title> |
| 132 | <body> |
132 | <body> |
| 133 | |
133 | |
| 134 | <p> |
134 | <p> |
| 135 | <c>ccache</c> is a fast compiler cache. When you compile a program, it will |
135 | <c>ccache</c> is a fast compiler cache. When you compile a program, it will |
| 136 | cache intermediate results so that, whenever you recompile the same program, the |
136 | cache intermediate results so that, whenever you recompile the same program, the |
| 137 | compilation time is greatly reduced. In common compilations this can result in 5 |
137 | compilation time is greatly reduced. The first time you run ccache, it will be |
| 138 | to 10 times faster compilation times. |
138 | much slower than a normal compilation. Subsequent recompiles should be faster. |
|
|
139 | ccache is only helpful if you will be recompiling the same application many |
|
|
140 | times; thus it's mostly only useful for software developers. |
| 139 | </p> |
141 | </p> |
| 140 | |
142 | |
| 141 | <p> |
143 | <p> |
| 142 | If you are interested in the ins and outs of ccache, please visit the |
144 | If you are interested in the ins and outs of ccache, please visit the |
| 143 | <uri link="http://ccache.samba.org">ccache homepage</uri>. |
145 | <uri link="http://ccache.samba.org">ccache homepage</uri>. |
| 144 | </p> |
146 | </p> |
|
|
147 | |
|
|
148 | <warn> |
|
|
149 | <c>ccache</c> is known to cause numerous compilation failures. Sometimes ccache |
|
|
150 | will retain stale code objects or corrupted files, which can lead to packages |
|
|
151 | that cannot be emerged. If this happens (if you receive errors like "File not |
|
|
152 | recognized: File truncated"), try recompiling the application with ccache |
|
|
153 | disabled (<c>FEATURES="-ccache"</c> in <path>/etc/make.conf</path>) |
|
|
154 | <e>before</e> reporting a bug. Unless you are doing development work, <e>do not |
|
|
155 | enable ccache</e>. |
|
|
156 | </warn> |
| 145 | |
157 | |
| 146 | </body> |
158 | </body> |
| 147 | </subsection> |
159 | </subsection> |
| 148 | <subsection> |
160 | <subsection> |
| 149 | <title>Installing ccache</title> |
161 | <title>Installing ccache</title> |