/[gentoo]/xml/htdocs/doc/en/distcc.xml
Gentoo

Diff of /xml/htdocs/doc/en/distcc.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.32 Revision 1.39
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/distcc.xml,v 1.32 2006/01/25 09:16:29 neysx Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/distcc.xml,v 1.39 2006/12/24 17:54:01 nightmorph Exp $ -->
4 4
5<guide link="/doc/en/distcc.xml"> 5<guide link="/doc/en/distcc.xml">
6 6
7<title>Gentoo Distcc Documentation</title> 7<title>Gentoo Distcc Documentation</title>
8 8
28<abstract> 28<abstract>
29This document serves as a HOWTO for using distcc with Gentoo. 29This document serves as a HOWTO for using distcc with Gentoo.
30</abstract> 30</abstract>
31 31
32<!-- The content of this document is licensed under the CC-BY-SA license --> 32<!-- The content of this document is licensed under the CC-BY-SA license -->
33<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 33<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
34<license/> 34<license/>
35 35
36<version>1.13</version> 36<version>1.18</version>
37<date>2006-01-25</date> 37<date>2006-12-24</date>
38 38
39<chapter> 39<chapter>
40<title>Introduction</title> 40<title>Introduction</title>
41<section> 41<section>
42<title>What is distcc?</title> 42<title>What is distcc?</title>
98</p> 98</p>
99 99
100<pre caption="Installing distcc"> 100<pre caption="Installing distcc">
101# <i>emerge distcc</i> 101# <i>emerge distcc</i>
102</pre> 102</pre>
103
104<impo>
105Remember, you must be sure to install distcc on all of your participating
106machines.
107</impo>
103 108
104</body> 109</body>
105</section> 110</section>
106<section> 111<section>
107<title>Setting up Portage to use Distcc</title> 112<title>Setting up Portage to use Distcc</title>
207the ccache part: 212the ccache part:
208</p> 213</p>
209 214
210<pre caption="Setting your path"> 215<pre caption="Setting your path">
211# <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i> 216# <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i>
212<comment>You can put this in your .bashrc or equivelant file to have the PATH 217<comment>(You can put this in your ~/.bashrc or equivalent file to have the PATH
213set every time you log in</comment> 218set every time you log in)</comment>
214</pre> 219</pre>
215 220
216<p> 221<p>
217Then, as you would normally type <c>make</c>, you would type <c>make -jN</c> 222Then, as you would normally type <c>make</c>, you would type <c>make -jN</c>
218(where N is an integer). The value of N depends on your network and the types 223(where N is an integer). The value of N depends on your network and the types
244<chapter id="bootstrapping"> 249<chapter id="bootstrapping">
245<title>Using Distcc to Bootstrap</title> 250<title>Using Distcc to Bootstrap</title>
246<section> 251<section>
247<title>Step 1: Configure Portage</title> 252<title>Step 1: Configure Portage</title>
248<body> 253<body>
249 254<!--
255Note that this will need to become a link to the old 2005.1 networked handbooks
256once the 2006.0 handbooks are released. Until then, the link can stay.
257-->
250<p> 258<p>
251Boot your new box with a Gentoo Linux LiveCD and follow the <uri 259Boot your new box with a Gentoo Linux LiveCD and follow the <uri
252link="/doc/en/handbook/handbook-x86.xml?part=1">installation instructions</uri> 260link="/doc/en/handbook/handbook-x86.xml?part=1">installation instructions</uri>
261up until the bootstrapping part. (See the <uri
262link="/doc/en/faq.xml#stage12">Gentoo FAQ</uri> for more information about
253up until the bootstrapping part. Then configure Portage to use distcc: 263bootstrapping.) Then configure Portage to use distcc:
254</p> 264</p>
255 265
256<pre caption="Preliminary Setup"> 266<pre caption="Preliminary Setup">
257# <i>nano -w /etc/make.conf</i> 267# <i>nano -w /etc/make.conf</i>
258<comment>(Add distcc to the FEATURES</comment> 268<comment>(Add distcc to the FEATURES</comment>
331</chapter> 341</chapter>
332 342
333<chapter> 343<chapter>
334<title>Troubleshooting</title> 344<title>Troubleshooting</title>
335<section> 345<section>
336<title>Mozilla and Xfree</title> 346<title>Some Packages Don't Use Distcc</title>
337<body> 347<body>
338 348
339<p> 349<p>
340As you emerge various packages, you'll notice that some of them aren't being 350As you emerge various packages, you'll notice that some of them aren't being
341distributed (and aren't being built in parallel). This is because the 351distributed (and aren't being built in parallel). This may happen because the
342developers of the Mozilla and Xfree ebuilds intentionally disable parallel 352package's Makefile doesn't support parallel operations or the maintainer of the
343building because it is known to cause problems. 353ebuild has explicitly disabled parallel operations due to a known problem.
344</p> 354</p>
345 355
346<p> 356<p>
347Sometimes distcc might cause a package to fail to compile. If this happens 357Sometimes distcc might cause a package to fail to compile. If this happens
348for you, please <uri link="http://bugs.gentoo.org">report</uri> it to us. 358for you, please <uri link="http://bugs.gentoo.org">report</uri> it to us.
349</p>
350
351</body>
352</section>
353<section>
354<title>A Mixture of hardened-gcc and non-hardened-gcc Hosts Will Be Faulty</title>
355<body>
356
357<p>
358With such a long title any explanation here is almost irrelevent. However, if
359you plan to use distcc across hosts that have the <uri
360link="/proj/en/hardened/etdyn-ssp.xml">PaX/hardened-gcc</uri> and some that do
361not, you will run into problems.
362</p>
363
364<p>
365The solution requires a little foresight on your part; you have to run
366<c>hardened-gcc -R</c> on the host that has PaX/hardened-gcc, or you have to
367enable PaX protections in your kernel and <c>emerge hardened-gcc</c>. Both of
368which are a good thing to do since for the most part the protections offered
369by both packages is a good thing and is transparent to the user.
370</p> 359</p>
371 360
372</body> 361</body>
373</section> 362</section>
374<section> 363<section>

Legend:
Removed from v.1.32  
changed lines
  Added in v.1.39

  ViewVC Help
Powered by ViewVC 1.1.20