Distcc/it

Distcc è un programma progettato per distribuire i processi di compilazione, attraverso una rete, a degli host partecipanti. È composto da un server,, e da un client,. Distcc funziona in modo trasparente con ccache, Portage e perfino Automake, con un po' di lavoro.

Se stai pensando di usare distcc per facilitare il bootstrap di una installazione di Gentoo, assicurati di leggere la sezione Usare Distcc per il Bootstrap.

Dipendenze
Per poter usare Distcc, tutti i computer sulla rete devono avere la stessa versione di GCC. Ad esempio, mescolare GCC 3.3.x (dove la x è variabile) non è un problema, ma mescolare 3.3.x e 3.2.x potrebbe generare errori in fase di compilazione o di esecuzione.

Installing distcc
Distcc ships with a graphical monitor to monitor tasks that a computer is sending away for compilation. This monitor is enabled when the    flag is set.

After configuring the  setting, install the  package:

Configurare portage all'uso di Distcc
Far usare distcc a Portage è semplice. Eseguire i passaggi seguenti su tutti i sistemi che partecipano alla compilazione distribuita:

First, make sure that is installed:

Adesso, impostare le variabili  e   come mostrato sotto. Una strategia comune consiste nell'impostare N al doppio del numero totale delle CPU (locali+remote)+1, ed M al numero delle CPU locali. NEl caso in cui non siano disponibili host distcc, o che l'ebuild richieda una compilazione esplicitamente locale (ad esempio, gcc), la flag  preverrà l'apertura di troppi task.

For instance, when there are two quad-core host PCs running distccd and the local PC has a dual core CPU, then the  variable could look like this:

While editing the file, make sure that it does not have   in the   or   variables. distccd will not distribute work to other machines if  is set to. The appropriate  value can be obtained by running the following command:

See Inlining -march=native for distcc for more information.

Specificare gli host partecipanti
Utilizzare il comando  per impostare una lista di host. Ecco un esempio degli host che potrebbero essere nella tua lista:

The following is an example list of host definitions. In most cases, variants of lines 1 and 2 suffice. More information about the syntax used in lines 3 and 4 can be found in the distcc manual page.

Ci sono anche altri modi per impostare gli host. Consultare la manpage di distcc per ulteriori dettagli.

Se si vuole compilare anche in locale, occorre inserire 'localhost' nella lista degli host. Di contro, se si vuole evitare di usare la macchina locale per compilare (caso d'uso comune), bisogna ometterlo dalla lista. Inserire 'localhost' su una macchina lenta potrebbe addirittura rallentare le cose. È consigliabile effettuare dei test per raggiungere le performance migliori.

Ad esempio, per impostare la prima riga dell'esempio precedente:

Modificare sulla base delle proprie esigenze ed assicurarsi di aver impostato la direttiva   di modo da accettare solo host fidati. Per aumentare la sicurezza, si può usare la direttiva  per indicare al demone distcc quale IP ascoltare (per sistemi multi-homed). Ulteriori informazioni su distcc sono presenti alla pagina Distcc Security Design.

Adesso, lanciare il demone di distcc su tutti i computer partecipanti:

Configurare Distcc per funzionare con Automake
In molti casi, questa procedura è anche più semplice della parte riguardante Portage. Ciò che bisogna fare è aggiornare la propria variabile  per farle includere  di fronte alla directory che contiene. In ogni caso, c'è da fare attenzione. Se si usa ccache bisogna inserire distcc dopo ccache:

Si può inserire tutto questo dentro il proprio o equivalente, di modo da impostare PATH ogni volta che si esegue il login.

Instead of calling just make, add in -jN (where  is an integer). The value of  depends on the network and the types of computers that are used to compile. A heuristic approach to the right value is given earlier in this article.

Setting up distcc to work with ssh
Setting up distcc via ssh includes some pitfalls. First, generate an SSH key pair without password setup. Be aware that portage compiles programs as the portage user. The home folder of the portage user is, which means the keys need to be stored in

Second, create a section for each host in the SSH configuration file:

Also make sure that each host is available in the file and append the public key to the  file of the hosts. To set up the hosts test1 and test2, run:

Please note the @ (@ sign), which specifies ssh hosts for distcc.

Cross-compiling
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 PowerPC. This is documented in the DistCC Cross-compiling guide.

Step 1: configure Portage
Boot the new box with a Gentoo Linux LiveCD and follow the installation instructions, while keeping track of the instructions in the Gentoo FAQ for information about bootstrapping). Then configure Portage to use distcc:

Update the  variable in the installation session as well:

Step 2: getting distcc
Install :

Step 3: setting up distcc
Run distcc-config --install to setup distcc; substitute the  in the example with the IP addresses or hostnames of the participating nodes.

Distcc is now set up to bootstrap! Continue with the proper installation instructions and do not forget to run emerge distcc after running emerge @system. This is to make sure that all of the necessary dependencies are installed.

Some packages don't use distcc
As various packages are installed, users will notice that some of them aren't being distributed (and aren't being built in parallel). This may happen because the package' doesn't support parallel operations, or the maintainer of the ebuild has explicitly disabled parallel operations due to a known problem.

Sometimes distcc</tt> might cause a package to fail to compile. If this happens, please report it.

Mixed GCC versions
If the environment hosts different GCC versions, there will likely be very weird problems. The solution is to make certain all hosts have the same GCC version.

Recent Portage updates have made Portage use  (minus gcc) instead of. This means that if i686 machines are mixed with other types (i386, i586) then the builds will run into troubles. A workaround for this may be to run export CC='gcc' CXX='c++' as root in a terminal, or put it in.

-march=native
Starting with GCC 4.3.0, the compiler supports the  option which turns on CPU auto-detection and optimizations that are worth being enabled on the processor on which GCC is running. This creates a problem when using distcc</tt> because it allows the mixing of code optimized for different processors. For example, running distcc</tt> with  on a system that has an AMD Athlon processor and doing the same on another system that has an Intel Pentium processor will mix code compiled on both processors together.

Heed the following warning:

To know the flags that GCC would enable when called with, execute the following:

Distcc monitors
Distcc ships with two monitoring utilities. The text-based monitoring utility is always built and is called distccmon-text</tt>. Running it for the first time can be a bit confusing, but it is really quite easy to use. If the program is run with no parameter it will run just once. However, if it is passed a number it will update every  seconds, where   is the argument that was passed.

The other monitoring utility is only enabled when the    flag is set. This one is GTK+ based, runs in an X environment, and it is quite lovely. For Gentoo, the GUI monitor has been renamed to distccmon-gui</tt> to make it less confusing (it is originally called distccmon-gnome</tt>).

To monitor Portage's distcc</tt> usage:

External resources

 * Inlining -march=native for distcc
 * Distcc homepage