summaryrefslogtreecommitdiff
blob: 6b369d4974fe1142b2c58d456fb6898b374766d7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2011-09-05 14:12+0600\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):7
msgid "Gentoo Distcc Documentation"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):9
msgid "Author"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):10
msgid "lisa@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):10
msgid "Lisa Seelye"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):12 ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):15 ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):18 ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):21 ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):27
msgid "Editor"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):13
msgid "vapier@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):13
msgid "Mike Frysinger"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):16
msgid "erwin@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):16
msgid "Erwin"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):19
msgid "swift@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):19
msgid "Sven Vermeulen"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):22
msgid "pylon@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):22
msgid "Lars Weiler"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(author:title):24
msgid "Reviewer"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):25
msgid "blubber@gentoo.org"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail):25
msgid "Tiemo Kieft"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(mail:link):28
msgid "nightmorph"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(abstract):31
msgid "This document serves as a HOWTO for using distcc with Gentoo."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(version):39
msgid "1.22"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(date):40
msgid "2009-06-14"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):43
msgid "Introduction"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):45
msgid "What is distcc?"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):48
msgid "Distcc is a program designed to distribute compiling tasks across a network to participating hosts. It is comprised of a server, <c>distccd</c>, and a client program, <c>distcc</c>. Distcc can work transparently with <uri link=\"http://ccache.samba.org\">ccache</uri>, Portage, and Automake with a little setup."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):59
msgid "Using distcc to bootstrap"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):62
msgid "If you are planning on using distcc to help you bootstrap a Gentoo installation, make sure you read the section <uri link=\"#bootstrapping\">Using distcc to Bootstrap</uri>, which is situated further down in this document."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):73
msgid "Setup"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):75
msgid "Dependencies"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):78
msgid "In order to use Distcc, all of the computers on your network need to have the same GCC versions. For example, mixing 3.3.x (where the x varies) is okay, but mixing 3.3.x with 3.2.x <b>may</b> result in compilation errors or runtime errors."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):88
msgid "Installing Distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):91
msgid "There are a couple of options you should be aware of before you start installing distcc."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):96
msgid "Distcc ships with a graphical monitor to monitor tasks that your computer is sending away for compilation. If you use Gnome then put 'gnome' in your USE flags. However, if you don't use Gnome and would still like to have the monitor then you should put 'gtk' in your USE flags."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):103
msgid "Installing distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):103
#, no-wrap
msgid "\n# <i>emerge distcc</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(impo):107
msgid "Remember, you must be sure to install distcc on all of your participating machines."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):115
msgid "Setting up Portage to use Distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):118
msgid "Setting up Portage to use distcc is easy. Execute the following steps on each system that should participate in the distributed compiling:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):123
msgid "Integrating Distcc and Portage"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):123
#, no-wrap
msgid "\n# <i>emerge distcc</i>\n# <i>nano -w /etc/make.conf</i>\n<comment>(Set N to a suitable number for your particular setup)</comment>\n<comment>(A common strategy is setting N as twice the number of total CPUs + 1 available)</comment>\nMAKEOPTS=\"-jN\"\n<comment>(Add distcc to your FEATURES)</comment>\nFEATURES=\"distcc\"\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):136
msgid "Specifying Participating Hosts"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):139
msgid "Use the <c>distcc-config</c> command to set the list of hosts. Here is an example of some hosts that might be in your list:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):144
msgid "Examples of host definitions"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):144
#, no-wrap
msgid "\n192.168.0.1          192.168.0.2                       192.168.0.3\n192.168.0.1/2        192.168.0.2                       192.168.0.3/10\n192.168.0.1:4000/2   192.168.0.2/1                     192.168.0.3:3632/4\n@192.168.0.1         @192.168.0.2:/usr/bin/distccd     192.168.0.3\n<comment>(There are also several other methods of setting up hosts.  See the \ndistcc manpage for more details.)</comment>\n<comment>If you wish to compile on the local machine you should put 'localhost'\nin the hosts list.  Conversely if you do not wish to use the local machine to\ncompile (which is often the case) omit it from the hosts list.  On a slow\nmachine using localhost may actually slow things down. Make sure to test your\nsettings for performance.</comment>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):158
msgid "It may all look complicated, but in most cases a variant of line 1 or 2 will work."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):163
msgid "Since most people won't be using lines 3 or 4, I'll <uri link=\"http://distcc.samba.org/man/distcc_1.html\">refer to</uri> the distcc docs (man distcc) for more information, which includes being able to run distcc over an SSH connection."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):170
msgid "For instance, to set the first line in the previous example:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):174
msgid "Sample command to set the hosts"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):174
#, no-wrap
msgid "\n# <i>/usr/bin/distcc-config --set-hosts \"192.168.0.1 192.168.0.2 192.168.0.3\"</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):178
msgid "Edit <path>/etc/conf.d/distccd</path> to your needs and be sure to set the <c>--allow</c> directive to allow only hosts you trust. For added security, you should also use the <c>--listen</c> directive to tell the distcc daemon what IP to listen on (for multi-homed systems). More information on distcc security can be found at <uri link=\"http://distcc.samba.org/security.html\">Distcc Security Design</uri>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(impo):187
msgid "It is important to use --allow and --listen. Please read the distccd manpage or the above security document for more information."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):193
msgid "Now start the distcc daemon on all the participating computers:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):197
msgid "Starting the distcc daemon"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):197
#, no-wrap
msgid "\n<comment>(Add distccd to the default runlevel)</comment>\n# <i>rc-update add distccd default</i>\n<comment>(Start the distcc daemon)</comment>\n# <i>/etc/init.d/distccd start</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):207
msgid "Setting up Distcc to Work With Automake"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):210
msgid "This is, in some cases, easier than the Portage setup. What you have to do is update your <c>PATH</c> variable to include <path>/usr/lib/distcc/bin</path> in front of the directory that contains <c>gcc</c> (<path>/usr/bin</path>). However, there is a caveat. If you use ccache you have to put distcc after the ccache part:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):218 ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):278
msgid "Setting your path"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):218
#, no-wrap
msgid "\n# <i>export PATH=\"/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}\"</i>\n<comment>(You can put this in your ~/.bashrc or equivalent file to have the PATH\nset every time you log in)</comment>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):224
msgid "Then, as you would normally type <c>make</c>, you would type <c>make -jN</c> (where N is an integer). The value of N depends on your network and the types of computers you are using to compile. Test your own settings to find the number that yields the best performance."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):236
msgid "Cross-Compiling"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):240
msgid "Cross-compiling is using one architecture to build programs for another architecture. This can be as simple as using an Athlon (i686) to build a program for a K6-2 (i586), or using a Sparc to build a program for a ppc. This is documented in our <uri link=\"/doc/en/cross-compiling-distcc.xml\">DistCC Cross-compiling Guide</uri>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):253
msgid "Using Distcc to Bootstrap"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):255
msgid "Step 1: Configure Portage"
msgstr ""

#. Note that this will need to become a link to the old 2005.1 networked handbooks
#. once the 2006.0 handbooks are released. Until then, the link can stay.
#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):261
msgid "Boot your new box with a Gentoo Linux LiveCD and follow the <uri link=\"/doc/en/handbook/handbook-x86.xml?part=1\">installation instructions</uri> up until the bootstrapping part. (See the <uri link=\"/doc/en/faq.xml#stage12\">Gentoo FAQ</uri> for more information about bootstrapping.) Then configure Portage to use distcc:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):269
msgid "Preliminary Setup"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):269
#, no-wrap
msgid "\n# <i>nano -w /etc/make.conf</i>\n<comment>(Add distcc to the FEATURES</comment>\nFEATURES=\"distcc\"\n<comment>(Modify MAKEOPTS to include -jN, where N is twice the number of CPUs\n+1 available)</comment>\nMAKEOPTS=\"-jN\"\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):278
#, no-wrap
msgid "\n# <i>export PATH=\"/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}\"</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):285
msgid "Step 2: Getting Distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):288
msgid "Install distcc:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):292
msgid "Getting Distcc on the new box"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):292
#, no-wrap
msgid "\n# <i>USE='-*' emerge --nodeps sys-devel/distcc</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):299
msgid "Step 3: Setting Up Distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):302
msgid "Run <c>distcc-config --install</c> to setup distcc:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):306
msgid "Final distcc setup"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):306
#, no-wrap
msgid "\n<comment>(Substitute host1, host2, ... with the IP number(s) of the\nparticipating hosts)</comment>\n# <i>/usr/bin/distcc-config --set-hosts \"localhost host1 host2 host3 ...\"</i>\n<comment>An example: <i>/usr/bin/distcc-config --set-hosts \"localhost\n192.168.0.4 192.168.0.6\"</i></comment>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):314
msgid "Distcc is now set up to bootstrap! Continue with the official installation instructions and <e>do not forget</e> to re-emerge distcc after <c>emerge system</c>. This is to make sure that all of the dependencies you want are installed as well."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(note):321
msgid "During bootstrap and <c>emerge system</c> distcc may not appear to be used. This is expected as some ebuilds do not work well with distcc, so they intentionally disable it."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):332
msgid "Troubleshooting"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):334
msgid "Some Packages Don't Use Distcc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):337
msgid "As you emerge various packages, you'll notice that some of them aren't being distributed (and aren't being built in parallel). This may happen because the package's Makefile doesn't support parallel operations or the maintainer of the ebuild has explicitly disabled parallel operations due to a known problem."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):344
msgid "Sometimes distcc might cause a package to fail to compile. If this happens for you, please <uri link=\"http://bugs.gentoo.org\">report</uri> it to us."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):352
msgid "Mixed GCC Versions"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):355
msgid "If you have different GCC versions on your hosts, there will likely be very weird problems. The solution is to make certain all hosts have the same GCC version."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):361
msgid "Recent Portage updates have made Portage use <c>${CHOST}-gcc</c> instead of <c>gcc</c>. This means that if you're mixing i686 machines with other types (i386, i586) you will run into problems. A workaround for this may be to <c>export CC='gcc' CXX='c++'</c> or to put it in <path>/etc/make.conf</path>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(impo):368
msgid "Doing this explicitly redefines some behaviour of Portage and may have some weird results in the future. Only do this if you're mixing CHOSTs."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):377
msgid "-march=native"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):380
msgid "Starting with GCC 4.3.0, the compiler supports the <c>-march=native</c> switch which turns on CPU autodetection and optimizations that are worth being enabled on the processor the GCC is running at. This is a problem with <c>distcc</c> as it allows mixing of code optimized for different processors (like AMD Athlon and Intel Pentium). <e>Don't</e> use <c>-march=native</c> or <c>-mtune=native</c> in your <c>CFLAGS</c> or <c>CXXFLAGS</c> when compiling with <c>distcc</c>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):394
msgid "Distcc Extras"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(title):396
msgid "Distcc Monitors"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):399
msgid "Distcc ships with two monitors. The text-based one is always built and is called <c>distccmon-text</c>. Running it for the first time can be a bit confusing, but it is really quite easy to use. If you run the program with no parameter it will run once. However, if you pass it a number it will update every N seconds, where N is the argument you passed."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(p):407
msgid "The other monitor is only turned on if you enabled <c>gtk</c> or <c>gnome</c> in your <c>USE</c> flags. This one is GTK+ based, runs in an X environment and it is quite lovely. For Gentoo the GUI monitor has been called <c>distccmon-gui</c> for less confusion. Elsewhere it may be referred to as <c>distccmon-gnome</c>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre:caption):415
msgid "Starting the monitors"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(pre):415
#, no-wrap
msgid "\n# <i>distccmon-text N</i>\n<comment>(Or)</comment>\n# <i>distccmon-gui</i>\n<comment>To monitor Portage's distcc usage you can use:</comment>\n# <i>DISTCC_DIR=\"/var/tmp/portage/.distcc/\" distccmon-text N</i>\n<comment>(Or)</comment>\n# <i>DISTCC_DIR=\"/var/tmp/portage/.distcc/\" distccmon-gui</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(impo):425
msgid "If your distcc directory is elsewhere, change the DISTCC_DIR variable accordingly."
msgstr ""

#. Place here names of translator, one per line. Format should be NAME; ROLE; E-MAIL
#: ../../gentoo/xml/htdocs/doc/en//distcc.xml(None):0
msgid "translator-credits"
msgstr ""