| 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.22 2004/08/22 20:51:08 neysx Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/distcc.xml,v 1.23 2004/11/09 11:37:30 swift 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 | |
| 9 | <author title="Author"> |
9 | <author title="Author"> |
| 10 | <mail link="lisa@gentoo.org">Lisa Seelye</mail> |
10 | <mail link="lisa@gentoo.org">Lisa Seelye</mail> |
| 11 | </author> |
11 | </author> |
| 12 | |
12 | |
| 13 | <author title="Editor"> |
13 | <author title="Editor"> |
| 14 | <mail link="vapier@gentoo.org">Mike Frysinger</mail> |
14 | <mail link="vapier@gentoo.org">Mike Frysinger</mail> |
| 15 | </author> |
15 | </author> |
| 16 | |
16 | |
| 17 | <author title="Editor"> |
17 | <author title="Editor"> |
| 18 | <mail link="erwin@gentoo.org">Erwin</mail> |
18 | <mail link="erwin@gentoo.org">Erwin</mail> |
| … | |
… | |
| 26 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
26 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
| 27 | </author> |
27 | </author> |
| 28 | |
28 | |
| 29 | <author title="Reviewer"> |
29 | <author title="Reviewer"> |
| 30 | <mail link="blubber@gentoo.org">Tiemo Kieft</mail> |
30 | <mail link="blubber@gentoo.org">Tiemo Kieft</mail> |
| 31 | </author> |
31 | </author> |
| 32 | |
32 | |
| 33 | <abstract> |
33 | <abstract> |
| 34 | This document serves as a HOWTO for using distcc with Gentoo. |
34 | This document serves as a HOWTO for using distcc with Gentoo. |
| 35 | </abstract> |
35 | </abstract> |
| 36 | |
36 | |
| 37 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
37 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 38 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
38 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
| 39 | <license/> |
39 | <license/> |
| 40 | |
40 | |
| 41 | <version>1.8</version> |
41 | <version>1.9</version> |
| 42 | <date>August 22, 2004</date> |
42 | <date>November 09, 2004</date> |
| 43 | |
43 | |
| 44 | <chapter> |
44 | <chapter> |
| 45 | <title>Introduction</title> |
45 | <title>Introduction</title> |
| 46 | <section> |
46 | <section> |
| 47 | <title>What is distcc?</title> |
47 | <title>What is distcc?</title> |
| 48 | <body> |
48 | <body> |
| 49 | |
49 | |
| 50 | <p> |
50 | <p> |
| 51 | Distcc is a program designed to distribute compiling tasks across a network to |
51 | Distcc is a program designed to distribute compiling tasks across a network to |
| 52 | participating hosts. It is comprised of a server, <c>distccd</c> and a client |
52 | participating hosts. It is comprised of a server, <c>distccd</c> and a client |
| 53 | program, <c>distcc</c>. Distcc can work transparently with <uri |
53 | program, <c>distcc</c>. Distcc can work transparently with <uri |
| 54 | link="http://ccache.samba.org">ccache</uri> and Portage with a little work. |
54 | link="http://ccache.samba.org">ccache</uri> and Portage with a little work. |
| 55 | </p> |
55 | </p> |
| 56 | |
56 | |
| 57 | </body> |
57 | </body> |
| … | |
… | |
| 156 | <p> |
156 | <p> |
| 157 | Since most people won't be using lines 3 or 4, I'll <uri |
157 | Since most people won't be using lines 3 or 4, I'll <uri |
| 158 | link="http://distcc.samba.org/man/distcc_1.html">point you to</uri> the distcc |
158 | link="http://distcc.samba.org/man/distcc_1.html">point you to</uri> the distcc |
| 159 | docs for more information. |
159 | docs for more information. |
| 160 | </p> |
160 | </p> |
| 161 | |
161 | |
| 162 | <p> |
162 | <p> |
| 163 | For instance, to set the first line in the previous example: |
163 | For instance, to set the first line in the previous example: |
| 164 | </p> |
164 | </p> |
| 165 | |
165 | |
| 166 | <pre caption="Sample command to set the hosts"> |
166 | <pre caption="Sample command to set the hosts"> |
| 167 | # <i>/usr/bin/distcc-config --set-hosts "192.168.0.1 192.168.0.2 192.168.0.3"</i> |
167 | # <i>/usr/bin/distcc-config --set-hosts "192.168.0.1 192.168.0.2 192.168.0.3"</i> |
| 168 | </pre> |
168 | </pre> |
| 169 | |
169 | |
| 170 | <p> |
170 | <p> |
|
|
171 | Edit <path>/etc/conf.d/distccd</path> to your needs and be sure to set the |
|
|
172 | <c>--allow</c> directive to allow only hosts you trust. For more information |
|
|
173 | please see the <uri link="http://distcc.samba.org/security.html">Distcc Security |
|
|
174 | Design</uri>. |
|
|
175 | </p> |
|
|
176 | |
|
|
177 | <p> |
| 171 | Now start the distcc daemon on all the participating computers: |
178 | Now start the distcc daemon on all the participating computers: |
| 172 | </p> |
179 | </p> |
| 173 | |
180 | |
| 174 | <pre caption="Starting the distcc daemon"> |
181 | <pre caption="Starting the distcc daemon"> |
| 175 | <comment>(Add distccd to the default runlevel)</comment> |
182 | <comment>(Add distccd to the default runlevel)</comment> |
| 176 | # <i>rc-update add distccd default</i> |
183 | # <i>rc-update add distccd default</i> |
| 177 | <comment>(Start the distcc daemon)</comment> |
184 | <comment>(Start the distcc daemon)</comment> |
| 178 | # <i>/etc/init.d/distccd start</i> |
185 | # <i>/etc/init.d/distccd start</i> |
| 179 | </pre> |
186 | </pre> |
| 180 | |
187 | |
| 181 | </body> |
188 | </body> |
| 182 | </section> |
189 | </section> |
| 183 | <section> |
190 | <section> |
| 184 | <title>Setting up Distcc to Work With Automake</title> |
191 | <title>Setting up Distcc to Work With Automake</title> |
| 185 | <body> |
192 | <body> |