/[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.19 Revision 1.20
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.19 2004/07/02 15:47:15 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/distcc.xml,v 1.20 2004/07/11 13:13:49 pylon Exp $ -->
4 4
5<!-- 5<!--
6 Synchronised with rev 1.15 on 6 Synchronised with rev 1.15 on
7 http://www.thedoh.com/viewcvs/distcc/html/distcc.xml 7 http://www.thedoh.com/viewcvs/distcc/html/distcc.xml
8--> 8-->
9 9
10<guide link="/doc/en/distcc.xml"> 10<guide link="/doc/en/distcc.xml">
11 11
12<title>Gentoo Distcc Documentation</title> 12<title>Gentoo Distcc Documentation</title>
13 13
14<author title="Author"> 14<author title="Author">
15 <mail link="lisa@gentoo.org">Lisa Seelye</mail> 15 <mail link="lisa@gentoo.org">Lisa Seelye</mail>
16</author> 16</author>
17 17
18<author title="Editor"> 18<author title="Editor">
19 <mail link="vapier@gentoo.org">Mike Frysinger</mail> 19 <mail link="vapier@gentoo.org">Mike Frysinger</mail>
20</author> 20</author>
21 21
22<author title="Editor"> 22<author title="Editor">
23 <mail link="erwin@gentoo.org">Erwin</mail> 23 <mail link="erwin@gentoo.org">Erwin</mail>
24</author> 24</author>
25 25
26<author title="Editor"> 26<author title="Editor">
27 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 27 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
28</author> 28</author>
29 29
30<author title="Editor">
31 <mail link="pylon@gentoo.org">Lars Weiler</mail>
32</author>
33
30<author title="Reviewer"> 34<author title="Reviewer">
31 <mail link="blubber@gentoo.org">Tiemo Kieft</mail> 35 <mail link="blubber@gentoo.org">Tiemo Kieft</mail>
32</author> 36</author>
33 37
34<abstract> 38<abstract>
35This document serves as a HOWTO for using distcc with Gentoo. 39This document serves as a HOWTO for using distcc with Gentoo.
36</abstract> 40</abstract>
37 41
38<!-- The content of this document is licensed under the CC-BY-SA license --> 42<!-- The content of this document is licensed under the CC-BY-SA license -->
39<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 43<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
40<license/> 44<license/>
41 45
42<version>1.7</version> 46<version>1.7.1</version>
43<date>July 02, 2004</date> 47<date>July 11, 2004</date>
44 48
45<chapter> 49<chapter>
46<title>Introduction</title> 50<title>Introduction</title>
47<section> 51<section>
48<title>What is distcc?</title> 52<title>What is distcc?</title>
49<body> 53<body>
50 54
51<p> 55<p>
52Distcc is a program designed to distribute compiling tasks across a network to 56Distcc is a program designed to distribute compiling tasks across a network to
53participating hosts. It is comprised of a server, <c>distccd</c> and a client 57participating hosts. It is comprised of a server, <c>distccd</c> and a client
54program, <c>distcc</c>. Distcc can work transparently with <uri 58program, <c>distcc</c>. Distcc can work transparently with <uri
55link="http://ccache.samba.org">ccache</uri> and Portage with a little work. 59link="http://ccache.samba.org">ccache</uri> and Portage with a little work.
56</p> 60</p>
57 61
58</body> 62</body>
260# <i>nano -w /etc/make.conf</i> 264# <i>nano -w /etc/make.conf</i>
261<comment>(Add distcc to the FEATURES variable)</comment> 265<comment>(Add distcc to the FEATURES variable)</comment>
262FEATURES="distcc" 266FEATURES="distcc"
263<comment>(Set distcc's directory for temporary space)</comment> 267<comment>(Set distcc's directory for temporary space)</comment>
264DISTCC_DIR="${PORTAGE_TMPDIR}/.distcc" 268DISTCC_DIR="${PORTAGE_TMPDIR}/.distcc"
265<comment>(Modify MAKEOPTS to include -jN with N an appropriate integer)</comment> 269<comment>(Modify MAKEOPTS to include -jN with N an appropriate integer)</comment>
266MAKEOPTS="-jN" 270MAKEOPTS="-jN"
267</pre> 271</pre>
268 272
269</body> 273</body>
270</section> 274</section>
271<section> 275<section>
272<title>Step 2: Getting Distcc</title> 276<title>Step 2: Getting Distcc</title>
273<body> 277<body>
274 278
279<p>Before the installation of distcc, a user called distcc must be added to the
280<path>/etc/passwd</path>:</p>
281
282<pre caption="Create user distcc">
283# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt; /etc/passwd</i>
284</pre>
285
275<p> 286<p>
276Install distcc: 287Install distcc:
277</p> 288</p>
278 289
279<pre caption="Getting Distcc on the new box"> 290<pre caption="Getting Distcc on the new box">
280# <i>USE='-*' emerge --nodeps distcc</i> 291# <i>USE='-*' emerge --nodeps distcc</i>
281</pre> 292</pre>
282 293
283</body> 294</body>
284</section> 295</section>
285<section> 296<section>
286<title>Step 3: Setting Up Distcc</title> 297<title>Step 3: Setting Up Distcc</title>
287<body> 298<body>
288 299
289<p> 300<p>
290Add a "distcc" user to the <path>/etc/passwd</path> file and run
291<c>distcc-config</c> to setup distcc: 301Run <c>distcc-config</c> to setup distcc:
292</p> 302</p>
293 303
294<pre caption="Final distcc setup"> 304<pre caption="Final distcc setup">
295# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt; /etc/passwd</i>
296<comment>(Substitute host1, host2, ... with the IP number(s) of the participating hosts)</comment> 305<comment>(Substitute host1, host2, ... with the IP number(s) of the participating hosts)</comment>
297# <i>/usr/bin/distcc-config --set-hosts "localhost host1 host2 host3 ..."</i> 306# <i>/usr/bin/distcc-config --set-hosts "localhost host1 host2 host3 ..."</i>
298</pre> 307</pre>
299 308
300<p> 309<p>
301distcc is now set up to bootstrap! Continue the official installation 310distcc is now set up to bootstrap! Continue the official installation
302instructions and <e>don't forget</e> to re-emerge distcc after <c>emerge 311instructions and <e>don't forget</e> to re-emerge distcc after <c>emerge
303system</c>. This is to make sure that all of the dependencies you want are 312system</c>. This is to make sure that all of the dependencies you want are
304installed as well. 313installed as well.
305</p> 314</p>
306 315
307<note> 316<note>
308During bootstrap and <c>emerge system</c> Distcc may not appear to be used. 317During bootstrap and <c>emerge system</c> Distcc may not appear to be used.
309This is expected as some ebuilds do not work well with distcc, so they 318This is expected as some ebuilds do not work well with distcc, so they
310intentionally disable it. 319intentionally disable it.

Legend:
Removed from v.1.19  
changed lines
  Added in v.1.20

  ViewVC Help
Powered by ViewVC 1.1.20