/[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.12 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.12 2004/01/09 20:48:14 swift 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
13 <mail link="vapier@gentoo.org">Mike Frysinger</mail> 13 <mail link="vapier@gentoo.org">Mike Frysinger</mail>
14</author> 14</author>
15<author title="Editor"> 15<author title="Editor">
16 <mail link="erwin@gentoo.org">Erwin</mail> 16 <mail link="erwin@gentoo.org">Erwin</mail>
17</author> 17</author>
18<author title="Reviewer"> 18<author title="Editor">
19 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 19 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
20</author>
21<author title="Editor">
22 <mail link="pylon@gentoo.org">Lars Weiler</mail>
20</author> 23</author>
21<author title="Reviewer"> 24<author title="Reviewer">
22 <mail link="blubber@gentoo.org">Tiemo Kieft</mail> 25 <mail link="blubber@gentoo.org">Tiemo Kieft</mail>
23</author> 26</author>
24
25<license/>
26
27<version>1.3</version>
28<date>January 9, 2004</date>
29 27
30<abstract> 28<abstract>
31This document serves as a HOWTO for using distcc with Gentoo. 29This document serves as a HOWTO for using distcc with Gentoo.
32</abstract> 30</abstract>
33 31
32<!-- The content of this document is licensed under the CC-BY-SA license -->
33<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
34<license/>
35
36<version>1.18</version>
37<date>2006-12-24</date>
38
34<chapter> 39<chapter>
35<title>Introduction</title> 40<title>Introduction</title>
36<section> 41<section>
37<title>What is distcc?</title> 42<title>What is distcc?</title>
38<body> 43<body>
39 44
40<p> 45<p>
41Distcc is a program designed to distribute compiling tasks across a network to 46Distcc is a program designed to distribute compiling tasks across a network to
42participating hosts. It is comprised of a server, <c>distccd</c> and a client 47participating hosts. It is comprised of a server, <c>distccd</c>, and a client
43program, <c>distcc</c>. Distcc can work transparently with <uri 48program, <c>distcc</c>. Distcc can work transparently with <uri
44link="http://ccache.samba.org">ccache</uri> and Portage with a little set up. 49link="http://ccache.samba.org">ccache</uri>, Portage, and Automake with a
50little setup.
51</p>
52
53</body>
54</section>
55<section>
56<title>Using distcc to bootstrap</title>
57<body>
58
59<p>
60If you are planning on using distcc to help you bootstrap a Gentoo
61installation, make sure you read the section <uri link="#bootstrapping">Using
62distcc to Bootstrap</uri>, which is situated further down in this document.
45</p> 63</p>
46 64
47</body> 65</body>
48</section> 66</section>
49</chapter> 67</chapter>
52<title>Setup</title> 70<title>Setup</title>
53<section> 71<section>
54<title>Dependencies</title> 72<title>Dependencies</title>
55<body> 73<body>
56 74
57<pre caption="Distcc dependencies (2.8 through 2.10)"> 75<p>
58&gt;=sys-apps/portage-2.0.46-r11 76In order to use Distcc, all of the computers on your network need to have the
59<codenote>Distcc-2.11 and on require &gt;=sys-apps/portage-2.0.49-r6</codenote> 77same GCC versions. For example, mixing 3.3.x (where the x varies) is okay, but
60&gt;=sys-devel/gcc-config-1.3.1 78mixing 3.3.x with 3.2.x <b>may</b> result in compilation errors or runtime
61sys-apps/shadow 79errors.
62<codenote>(As of version 2.8 and up until 2.11) And the following optional dependencies when you have <i>gtk</i> in your <i>USE</i> flags</codenote>
63&gt;=x11-libs/gtk+-2.2.1
64</pre> 80</p>
65
66<pre caption="Distcc Dependencies (post 2.11.1)">
67&gt;=sys-apps/portage-2.0.49-r6
68&gt;=sys-devel/gcc-config-1.3.1
69sys-apps/shadow
70<codenote>In this revision you may chose between a Gnome and GTK GUI monitor, they have the following added dependencies</codenote>
71<codenote>For GTK:</codenote>
72&gt;=x11-libs/gtk+-2.0.0
73&gt;=gnome-base/libglade-2.0.0
74x11-libs/pango
75<codenote>For Gnome:</codenote>
76&gt;=x11-libs/gtk+-2.0.0
77&gt;=gnome-base/libglade-2.0.0
78x11-libs/pango
79&gt;=gnome-base/libgnomeui-2.0.0.0
80&gt;=gnome-base/libgnome-2.0.0
81</pre>
82 81
83</body> 82</body>
84</section> 83</section>
85<section> 84<section>
86<title>Installing Distcc</title> 85<title>Installing Distcc</title>
87<body> 86<body>
88 87
89<p> 88<p>
90Installing Distcc is very easy. Simply set your USE flags and <c>emerge 89There are a couple of options you should be aware of before you start
91distcc</c>. But, there's a couple of options you should know about. 90installing distcc.
92</p> 91</p>
93 92
94<p> 93<p>
95Distcc ships with a graphical monitor to monitor tasks that your computer is 94Distcc ships with a graphical monitor to monitor tasks that your computer is
96sending away for compilation. If you use Gnome then put 'gnome' in your USE 95sending away for compilation. If you use Gnome then put 'gnome' in your USE
97flags. However, if you don't use Gnome and would still like to have the 96flags. However, if you don't use Gnome and would still like to have the
98monitor then you should put 'gtk' in your USE flags. 97monitor then you should put 'gtk' in your USE flags.
99</p> 98</p>
100 99
100<pre caption="Installing distcc">
101# <i>emerge distcc</i>
102</pre>
103
104<impo>
105Remember, you must be sure to install distcc on all of your participating
106machines.
107</impo>
108
101</body> 109</body>
102</section> 110</section>
103<section> 111<section>
104<title>Setting up Portage to use Distcc</title> 112<title>Setting up Portage to use Distcc</title>
105<body> 113<body>
106 114
107<p> 115<p>
108Setting up distcc is very easy to do with Portage. Follow these simple steps on 116Setting up Portage to use distcc is easy. Execute the following steps on
109each computer you want to use distcc on: 117each system that should participate in the distributed compiling:
110</p> 118</p>
111 119
112<pre caption="Integrating Distcc and Portage"> 120<pre caption="Integrating Distcc and Portage">
113# <i>emerge distcc</i> 121# <i>emerge distcc</i>
114# <i>nano -w /etc/make.conf</i> 122# <i>nano -w /etc/make.conf</i>
123<comment>(Set N to a suitable number for your particular setup)</comment>
124<comment>(A common strategy is setting N as twice the number of total CPUs + 1
125available)</comment>
126MAKEOPTS="-jN"
127<comment>(Add distcc to your FEATURES)</comment>
128FEATURES="distcc"
115</pre> 129</pre>
116 130
117<impo> 131</body>
118If you use distcc-2.11.1 or greater with &gt;=portage-2.0.49-r6, then all you 132</section>
119need to do as far as setup is to set your hosts (see next code block), modify 133<section>
120MAKEOPTS in <path>/etc/make.conf</path>, and add 'distcc' to FEATURES in 134<title>Specifying Participating Hosts</title>
121<path>/etc/make.conf</path>. 135<body>
122</impo>
123 136
124<note>
125Edit your FEATURES flags to include &quot;distcc&quot;
126</note>
127
128<p> 137<p>
129Next you have to specify what hosts you want to use. To do this you can use
130the <c>distcc-config</c> command to set the list of hosts. Here is an example 138Use the <c>distcc-config</c> command to set the list of hosts. Here is an
131of some hosts that might be in your list: 139example of some hosts that might be in your list:
132</p> 140</p>
133 141
134<pre caption="Examples of host definitions"> 142<pre caption="Examples of host definitions">
135192.168.0.1 192.168.0.2 192.168.0.3 143192.168.0.1 192.168.0.2 192.168.0.3
136192.168.0.1/2 192.168.0.2 192.168.0.3/10 144192.168.0.1/2 192.168.0.2 192.168.0.3/10
137192.168.0.1:4000/2 192.168.0.2/1 192.168.0.3:3632/4 145192.168.0.1:4000/2 192.168.0.2/1 192.168.0.3:3632/4
138@192.168.0.1 @192.168.0.2:/usr/bin/distccd 192.168.0.3 146@192.168.0.1 @192.168.0.2:/usr/bin/distccd 192.168.0.3
139<codenote>There are also several other methods of setting up hosts. </codenote> 147<comment>(There are also several other methods of setting up hosts. See the
140<codenote>See the distcc manpage for more details.</codenote> 148distcc manpage for more details.)</comment>
149<comment>If you wish to compile on the local machine you should put 'localhost'
150in the hosts list. Conversely if you do not wish to use the local machine to
151compile (which is often the case) omit it from the hosts list. On a slow
152machine using localhost may actually slow things down. Make sure to test your
153settings for performance.</comment>
141</pre> 154</pre>
142 155
143<p> 156<p>
144It may all look complicated, but in most cases a variant of line 1 or 2 will 157It may all look complicated, but in most cases a variant of line 1 or 2 will
145work. An explanation of each line is: Line 1 is just a space-delimited list 158work.
146of hosts that will use default everything. Line 2 is a list of hosts that
147specifies the maximum number of jobs (by use of the /N) to send that host at
148any given time (specified with the <c>/n</c>). Since most people won't be
149using lines 3 or 4, I'll <uri link="http://distcc.samba.org/man/distcc_1.html">
150point you to</uri> the distcc docs for more information.
151</p>
152
153<p> 159</p>
154A sample command to set the hosts (for line 1) is: 160
161<p>
162Since most people won't be using lines 3 or 4, I'll <uri
163link="http://distcc.samba.org/man/distcc_1.html">refer to</uri> the distcc
164docs (man distcc) for more information.
165</p>
166
167<p>
168For instance, to set the first line in the previous example:
155</p> 169</p>
156 170
157<pre caption="Sample command to set the hosts"> 171<pre caption="Sample command to set the hosts">
158# <i>/usr/bin/distcc-config --set-hosts "192.168.0.1 192.168.0.2 192.168.0.3"</i> 172# <i>/usr/bin/distcc-config --set-hosts "192.168.0.1 192.168.0.2 192.168.0.3"</i>
159</pre> 173</pre>
160 174
161<p> 175<p>
162The final step to integrating distcc into Portage is to re-open your 176Edit <path>/etc/conf.d/distccd</path> to your needs and be sure to set the
163<path>/etc/make.conf</path> and edit <c>MAKEOPTS</c> to include <c>-jN</c> 177<c>--allow</c> directive to allow only hosts you trust. For added security,
164(where N is an integer). Typically you will want to set this to the total 178you should also use the <c>--listen</c> directive to tell the distcc daemon
165number of processors in your network plus one. 179what IP to listen on (for multi-homed systems). More information on distcc
166</p> 180security can be found at <uri
167 181link="http://distcc.samba.org/security.html">Distcc Security Design</uri>.
168<pre caption="Final steps in make.conf">
169# <i>nano -w /etc/make.conf</i>
170MAKEOPTS=-jN
171</pre> 182</p>
172 183
173<impo> 184<impo>
174Don't forget to start the distcc daemon! <c>/etc/init.d/distccd start</c> 185It is important to use --allow and --listen. Please read the distccd manpage
186or the above security document for more information.
175</impo> 187</impo>
176 188
177<note> 189
178You will likely have to find a suitable 'N' for your particular setup. Another 190<p>
179strategy is 2 x #number of CPUs + 1. 191Now start the distcc daemon on all the participating computers:
180</note> 192</p>
193
194<pre caption="Starting the distcc daemon">
195<comment>(Add distccd to the default runlevel)</comment>
196# <i>rc-update add distccd default</i>
197<comment>(Start the distcc daemon)</comment>
198# <i>/etc/init.d/distccd start</i>
199</pre>
181 200
182</body> 201</body>
183</section> 202</section>
184<section> 203<section>
185<title>Setting up Distcc to Work With Automake</title> 204<title>Setting up Distcc to Work With Automake</title>
186<body> 205<body>
187 206
188<p> 207<p>
189This is in some cases easier than the Portage setup. What you have to do is 208This is, in some cases, easier than the Portage setup. What you have to do is
190update your <c>PATH</c> environmental variable to include 209update your <c>PATH</c> variable to include <path>/usr/lib/distcc/bin</path>
191<path>/usr/lib/distcc/bin</path> before where gcc (<path>/usr/bin</path>). 210in front of the directory that contains <c>gcc</c> (<path>/usr/bin</path>).
192However, there is a caveat. If you use ccache you have to put distcc after 211However, there is a caveat. If you use ccache you have to put distcc after
193the ccache part. Like so: 212the ccache part:
194</p> 213</p>
195 214
196<pre caption="Setting your path"> 215<pre caption="Setting your path">
197# <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>
217<comment>(You can put this in your ~/.bashrc or equivalent file to have the PATH
218set every time you log in)</comment>
198</pre> 219</pre>
199 220
200<p> 221<p>
201Then, 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>
202(where N is an integer). A safe number to use for N varies on your network 223(where N is an integer). The value of N depends on your network and the types
203and the types of computers you are using to compile. For me, I have a dual 224of computers you are using to compile. Test your own settings to find the
204processor P3 and a K6-2/400 that compile everything for my desktop (a 1200MHz 225number that yields the best performance.
205Athlon Thunderbird) and I use -j5. Test your own settings to find the right
206number.
207</p> 226</p>
208 227
209</body> 228</body>
210</section> 229</section>
211</chapter> 230</chapter>
212 231
213<chapter> 232<chapter>
214<title>Cross-Compiling</title> 233<title>Cross-Compiling</title>
215<section> 234<section>
216<title>A Note on Cross-Compiling</title>
217<body> 235<body>
218 236
219<p> 237<p>
220Cross-compiling is using one architecture to build programs for another 238Cross-compiling is using one architecture to build programs for another
221architecture. This can be as simple as using an Athlon (i686) to build a 239architecture. This can be as simple as using an Athlon (i686) to build a
222program for a K6-2 (i586), or using a Sparc to build a program for a ppc. 240program for a K6-2 (i586), or using a Sparc to build a program for a ppc. This
241is documented in our <uri link="/doc/en/cross-compiling-distcc.xml">DistCC
242Cross-compiling Guide</uri>.
223</p> 243</p>
224 244
225</body> 245</body>
226</section>
227<section> 246</section>
228<title>A Personal Note on Cross-compiling</title>
229<body>
230
231<p>
232I'd love to be able to help out on the Gentoo Cross-compiling effort, but I
233don't have any non-x86 machines. I can create things that work <e>in
234theory</e>, but I have to rely on other people to test what I write. That
235works to an extent, but it's tough. ;-)
236</p>
237
238<p>
239In the near future I hope to acquire a Sparc of some type to put Gentoo on so
240I can play around in-house.
241</p>
242
243</body>
244</section>
245</chapter>
246
247<chapter> 247</chapter>
248
249<chapter id="bootstrapping">
248<title>Using Distcc to Bootstrap</title> 250<title>Using Distcc to Bootstrap</title>
249<section> 251<section>
250<title>Step 1: Setup on New Box</title> 252<title>Step 1: Configure Portage</title>
251<body> 253<body>
252 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-->
253<p> 258<p>
254Next, you have to boot your new box with a Gentoo Linux LiveCD and follow all 259Boot your new box with a Gentoo Linux LiveCD and follow the <uri
255of the steps up until the bootstrapping. Then proceed with a little preliminary 260link="/doc/en/handbook/handbook-x86.xml?part=1">installation instructions</uri>
256setup on the new box. 261up until the bootstrapping part. (See the <uri
262link="/doc/en/faq.xml#stage12">Gentoo FAQ</uri> for more information about
263bootstrapping.) Then configure Portage to use distcc:
257</p> 264</p>
258 265
259<pre caption="Preliminary Setup"> 266<pre caption="Preliminary Setup">
260<codenote>Here we add distcc to FEATURES</codenote>
261# <i>nano -w /etc/make.conf</i> 267# <i>nano -w /etc/make.conf</i>
262<codenote>Add &quot;distcc&quot; to FEATURES</codenote> 268<comment>(Add distcc to the FEATURES</comment>
263<codenote>Modify MAKEOPTS in <path>/etc/make.conf to include -jN (as described above)</path></codenote> 269FEATURES="distcc"
270<comment>(Modify MAKEOPTS to include -jN, where N is twice the number of CPUs
271+1 available)</comment>
272MAKEOPTS="-jN"
264</pre> 273</pre>
265 274
266<p> 275<pre caption="Setting your path">
267Then add the distcc user to your <path>/etc/passwd</path>: 276# <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i>
277</pre>
278
279</body>
280</section>
281<section>
282<title>Step 2: Getting Distcc</title>
283<body>
284
268</p> 285<p>
286Before the installation of distcc, a user called distcc must be added to the
287<path>/etc/passwd</path>:
288</p>
269 289
270<pre caption="Add the distcc user to /etc/passwd"> 290<pre caption="Create user distcc">
271# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt;/etc/passwd</i> 291# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt;/etc/passwd</i>
272<codenote>Do not forget the `<i>&gt;&gt;</i>'</codenote>
273</pre> 292</pre>
274 293
275</body> 294<impo>
276</section> 295It is important to note that adding users like this is very bad. We only do
277<section> 296it here because there is no <c>useradd</c> utility (which you normally use for
278<title>Step 2: Getting Distcc</title> 297adding users) yet at this stage of installation.
279<body> 298</impo>
280 299
281<p> 300<p>
282Next you will want to issue the following command inside the chroot on the new 301Install distcc:
283box.
284</p> 302</p>
285 303
286<pre caption="Getting Distcc on the new box"> 304<pre caption="Getting Distcc on the new box">
287# <i>USE='-*' emerge --nodeps distcc</i> 305# <i>USE='-*' emerge --nodeps sys-devel/distcc</i>
306</pre>
307
308</body>
309</section>
310<section>
311<title>Step 3: Setting Up Distcc</title>
312<body>
313
314<p>
315Run <c>distcc-config --install</c> to setup distcc:
288</pre> 316</p>
317
318<pre caption="Final distcc setup">
319<comment>(Substitute host1, host2, ... with the IP number(s) of the
320participating hosts)</comment>
321# <i>/usr/bin/distcc-config --set-hosts "localhost host1 host2 host3 ..."</i>
322<comment>An example: <i>/usr/bin/distcc-config --set-hosts "localhost
323192.168.0.4 192.168.0.6"</i></comment>
324</pre>
325
326<p>
327Distcc is now set up to bootstrap! Continue with the official installation
328instructions and <e>do not forget</e> to re-emerge distcc after <c>emerge
329system</c>. This is to make sure that all of the dependencies you want are
330installed as well.
331</p>
289 332
290<note> 333<note>
291<uri link="http://bugs.gentoo.org/show_bug.cgi?id=34262">Bug 34262</uri> 334During bootstrap and <c>emerge system</c> distcc may not appear to be used.
292mentions a problem with pkg-config (dev-util/pkgconfig), so it may be necessary 335This is expected as some ebuilds do not work well with distcc, so they
293to also issue <c>emerge --nodeps pkgconfig</c> prior to the above emerge. 336intentionally disable it.
294</note>
295
296</body>
297</section>
298<section>
299<title>Step 3: Setting Up Distcc Itself</title>
300<body>
301
302<p>
303Now set up distcc itself...
304</p>
305
306<pre caption="Final distcc setup">
307# <i>/usr/bin/distcc-config --install</i>
308# <i>/usr/bin/distcc-config --set-hosts "localhost host1 host2 host3 ..."</i>
309</pre>
310
311<p>
312distcc should be set up now to bootstrap! Continue the official install guide,
313and don't forget to re-emerge distcc after <c>emerge system</c>.
314</p>
315
316<note>
317It is important to note that during bootstrap and <c>emerge system</c> distcc
318may not appear to be being used. This is not to be unexpected. Some ebuilds or
319packages do not work well with distcc, so they intentionally disable distcc.
320</note> 337</note>
321 338
322</body> 339</body>
323</section> 340</section>
324</chapter> 341</chapter>
325 342
326<chapter> 343<chapter>
327<title>Troubleshooting</title> 344<title>Troubleshooting</title>
328<section> 345<section>
329<title>Mozilla and Xfree</title> 346<title>Some Packages Don't Use Distcc</title>
330<body>
331
332<p>
333As you emerge various packages, you'll notice that they aren't being distributed
334(and indeed aren't being built in parallel). This is because the developers of
335Mozilla and Xfree .ebuilds disabled parallel building because it is known to
336cause problems. This isn't necessarily a distcc problem.
337</p>
338
339<p>
340That isn't to say that sometimes distcc will cause a package to fail to compile.
341</p>
342
343</body> 347<body>
344</section>
345<section>
346<title>A Mixture of hardened-gcc and non-hardened-gcc Hosts Will Be Faulty</title>
347<body>
348 348
349<p>
350With such a long title any explanation here is almost irrelevent. However, if
351you plan to use distcc across hosts that have the <uri
352link="http://www.gentoo.org/proj/en/hardened/etdyn-ssp.xml">PaX/hardened-gcc</uri>
353and some that do not, you will run into problems.
354</p> 349<p>
355 350As you emerge various packages, you'll notice that some of them aren't being
351distributed (and aren't being built in parallel). This may happen because the
352package's Makefile doesn't support parallel operations or the maintainer of the
353ebuild has explicitly disabled parallel operations due to a known problem.
356<p> 354</p>
357The solution requires a little foresight on your part; you have to run 355
358<c>hardened-gcc -R</c> on the host that has PaX/hardened-gcc, or you have to 356<p>
359enable PaX protections in your kernel and <c>emerge hardened-gcc</c>. Both of 357Sometimes distcc might cause a package to fail to compile. If this happens
360which are a good thing to do since for the most part the protections offered 358for you, please <uri link="http://bugs.gentoo.org">report</uri> it to us.
361by both packages is a good thing and is transparent to the user.
362</p> 359</p>
363 360
364</body> 361</body>
365</section> 362</section>
366<section> 363<section>
367<title>Mixed GCC Versions</title> 364<title>Mixed GCC Versions</title>
368<body> 365<body>
369 366
370<p> 367<p>
371If you have differing versions of GCC on your hosts, there will likely be very 368If you have different GCC versions on your hosts, there will likely be very
372weird problems. The solution is to make certain all hosts have the same GCC 369weird problems. The solution is to make certain all hosts have the same GCC
373version. 370version.
374</p> 371</p>
375 372
373<p>
374Recent Portage updates have made Portage use <c>${CHOST}-gcc</c> instead of
375<c>gcc</c>. This means that if you're mixing i686 machines with other types
376(i386, i586) you will run into problems. A workaround for this may be to
377<c>export CC='gcc' CXX='c++'</c> or to put it in <path>/etc/make.conf</path>.
378</p>
379
380<impo>
381Doing this explicitly redefines some behaviour of Portage and may have some
382weird results in the future. Only do this if you're mixing CHOSTs.
383</impo>
384
385
376</body> 386</body>
377</section> 387</section>
378</chapter> 388</chapter>
379 389
380<chapter> 390<chapter>
382<section> 392<section>
383<title>Distcc Monitors</title> 393<title>Distcc Monitors</title>
384<body> 394<body>
385 395
386<p> 396<p>
387Distcc ships with two monitors. The text-based one is always built, it is 397Distcc ships with two monitors. The text-based one is always built and is
388called <c>distccmon-text</c>. Running it for the first time can be a bit 398called <c>distccmon-text</c>. Running it for the first time can be a bit
389confusing, but it is really quite easy to use. If you run the program with no 399confusing, but it is really quite easy to use. If you run the program with no
390parameter it will run once. However, if you pass it a number it will update 400parameter it will run once. However, if you pass it a number it will update
391every N seconds, where N is the argument you passed. 401every N seconds, where N is the argument you passed.
392</p> 402</p>
393 403
394<p> 404<p>
395The other monitor is only turned on if you enabled <c>gtk</c> or <c>gnome</c> 405The other monitor is only turned on if you enabled <c>gtk</c> or <c>gnome</c>
396in your <c>USE</c> flags. This one is GTK+ based and runs in an X environment, 406in your <c>USE</c> flags. This one is GTK+ based, runs in an X environment
397and it is quite lovely. 407and it is quite lovely. For Gentoo the GUI monitor has been called
398</p> 408<c>distccmon-gui</c> for less confusion. Elsewhere it may be referred to as
399 409<c>distccmon-gnome</c>.
400<p>
401There is a caveat to using these programs. If you want to monitor any emerge,
402you have to start the monitor like so:
403</p> 410</p>
404 411
405<pre caption="Starting the monitors"> 412<pre caption="Starting the monitors">
413# <i>distccmon-text N</i>
414<comment>(Or)</comment>
415# <i>distccmon-gui</i>
416<comment>To monitor Portage's distcc usage you can use:</comment>
406# <i>DISTCC_DIR=/path/to/distccdir distccmon-text N</i> 417# <i>DISTCC_DIR="/var/tmp/portage/.distcc/" distccmon-text N</i>
407<codenote>Or you can start the graphical monitor...</codenote> 418<comment>(Or)</comment>
408# <i>DISTCC_DIR=/path/to/distccdir distccmon-gnome</i> 419# <i>DISTCC_DIR="/var/tmp/portage/.distcc/" distccmon-gui</i>
409</pre> 420</pre>
410 421
411<impo> 422<impo>
412If you are using Portage and used the above example, this will be 423If your distcc directory is elsewhere, change the DISTCC_DIR variable
413<c>DISTCC_DIR=/var/tmp/portage/.distcc</c>. 424accordingly.
414</impo> 425</impo>
415 426
416<note>
417If you aren't using Portage you do not need to specify DISTCC_DIR (i.e., just
418type distccmon-text N).
419</note>
420
421</body>
422</section>
423</chapter>
424
425<chapter>
426<title>Future Plans for Distcc and Gentoo</title>
427<section>
428<title>distcc-subnetscan</title>
429<body>
430
431<p>
432<c>distcc-subnetscan</c> is a perl program in development that will scan a
433subnet for hosts that have a participating distcc daemon. Even this will be
434enhanced to test if the daemon on a remote host will conform to a specific
435<c>CHOST</c> setting to make cross-compiling easier.
436</p>
437
438<p>
439The perl script is being kept at <uri link="http://dev.gentoo.org/~lisa/distcc/distcc-subnetscan/distcc-subnetscan.pl">
440right here</uri> until a more formal home can be found.
441</p>
442
443</body>
444</section>
445<section>
446<title>distcc-config</title>
447<body>
448
449<p>
450<c>distcc-config</c>, the userland configuration tool for distcc is out of date.
451It has been rewritten and is present in <path>distcc-2.11.1-r1</path> and up.
452</p>
453
454</body> 427</body>
455</section> 428</section>
456</chapter> 429</chapter>
457</guide> 430</guide>

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

  ViewVC Help
Powered by ViewVC 1.1.20