Specifying Participating Hosts

Distcc is a program designed to distribute compiling tasks across a network to -participating hosts. It is comprised of a server, distccd and a client +participating hosts. It is comprised of a server, distccd, and a client program, distcc. Distcc can work transparently with ccache and Portage with a little work.

If you are planning on using distcc to help you bootstrap a Gentoo installation, -make sure you read the part on Using distcc to -Bootstrap which is situated further down in this document. +make sure you read the section Using distcc to +Bootstrap, which is situated further down in this document.

-To start off with, to use Distcc all of the computers on your network need to -have the same GCC versions. Mixing 3.3.x (where the x varies) is okay, but -mixing 3.3.x and 3.2.x is not: your programs will have errors in it. +In order to use Distcc, all of the computers on your network need to +have the same GCC versions. Mixing 3.3.x (where the x varies) is okay, but +mixing 3.3.x and 3.2.x will result in your programs having errors in them.

-There are a couple of options you should know about before you start +There are a couple of options you should be aware of before you start installing distcc.

-Setting up distcc is easy to do with Portage. Execute the following steps on +Setting up Portage to use distcc is easy. Execute the following steps on each system that should participate in the distributed compiling:

+Specifying Participating Hosts + +

-Next you have to specify what hosts you want to use. Use the -distcc-config command to set the list of hosts. Here is an example of +Use the distcc-config command to set the list of hosts. Here is an example of some hosts that might be in your list:

@@ -166,11 +171,10 @@

Edit /etc/conf.d/distccd to your needs and be sure to set the ---allow directive to allow only hosts you trust. For more information -please see the Distcc Security -Design. For added security you should also use the --listen -directive to tell the Distcc daemon what IP to listen on (for multi-homed -systems). +--allow directive to allow only hosts you trust. For added security, you should also use the --listen +directive to tell the distcc daemon what IP to listen on (for multi-homed +systems). More information on distcc security can be found at Distcc Security +Design.

@@ -191,7 +195,7 @@

-This is in some cases easier than the Portage setup. What you have to do is +This is, in some cases, easier than the Portage setup. What you have to do is update your PATH variable to include /usr/lib/distcc/bin in front of the directory that contains gcc (/usr/bin). However, there is a caveat. If you use ccache you have to put distcc after @@ -230,12 +234,12 @@

-An Introduction to Cross-compiling +An Introduction to Cross-Compiling

-If you want to give Cross-compiling a try you can to follow The Cross Compile -HOWTO; Crossdev is depreciated. +If you want to give cross-compiling a try, you can read The Cross Compile +HOWTO; Crossdev is deprecated.

@@ -311,14 +315,14 @@

-distcc is now set up to bootstrap! Continue the official installation +Distcc is now set up to bootstrap! Continue with the official installation instructions and do not forget to re-emerge distcc after emerge system. This is to make sure that all of the dependencies you want are installed as well.

-During bootstrap and emerge system Distcc may not appear to be used. +During bootstrap and emerge system distcc may not appear to be used. This is expected as some ebuilds do not work well with distcc, so they intentionally disable it.