diff options
author | Omer Katz <omer.drow@gmail.com> | 2015-08-24 18:08:43 +0300 |
---|---|---|
committer | Omer Katz <omer.drow@gmail.com> | 2015-08-24 18:08:43 +0300 |
commit | 267fe5be154ca375ac574875894b476b60f19af0 (patch) | |
tree | 6d0b9b3ae2f3c66c5059f20a36d1e6bb49891770 | |
parent | c36f5cfb6e36bda50af645347a7fd1a95b2d1654 (diff) | |
parent | 21c3a6a6729c98e6f85822b529aa177aa265ff46 (diff) | |
download | distcc-git-267fe5be154ca375ac574875894b476b60f19af0.tar.gz |
Merge pull request #158 from amchoukir/master
Adding missing README from svn to fix make install breakage
-rw-r--r-- | README | 55 |
1 files changed, 55 insertions, 0 deletions
@@ -0,0 +1,55 @@ + + distcc -- a free distributed C/C++ compiler system + + http://code.google.com/p/distcc/ + + by Martin Pool <mbp@samba.org> + + "pump" functionality added by + Fergus Henderson, Nils Klarlund, Manos Renieris, and Craig Silverstein + (Google Inc.) + +distcc is a program to distribute compilation of C or C++ code across +several machines on a network. distcc should always generate the same +results as a local compile, is simple to install and use, and is often +two or more times faster than a local compile. + +Unlike other distributed build systems, distcc does not require all +machines to share a filesystem, have synchronized clocks, or to have +the same libraries or header files installed. Machines can be running +different operating systems, as long as they have compatible binary +formats or cross-compilers. + +By default, distcc sends the complete preprocessed source code across +the network for each job, so all it requires of the volunteer machines +is that they be running the distccd daemon, and that they have an +appropriate compiler installed. + +The distcc "pump" functionality, added in distcc 3.0, improves on +distcc by distributing not only compilation but also preprocessing to +distcc servers. This requires that the server and client have the same +system headers (the client takes responsibility for transmitting +application-specific headers). Given that, distcc in pump mode yields +the same results that distcc would in non-pump mode, but faster, since +the preprocessor no longer runs locally. For more details on the pump +functionality, see README.pump. + +distcc is not itself a compiler, but rather a front-end to the GNU +C/C++ compiler (gcc), or another compiler of your choice. All the +regular gcc options and features work as normal. + +distcc is designed to be used with GNU make's parallel-build feature +(-j). Shipping files across the network takes time, but few cycles on +the client machine. Any files that can be built remotely are +essentially "for free" in terms of client CPU. This is even more true +in "pump" mode, where the client does not even have to take time to +preprocess the source files. distcc has been successfully used in +environments with hundreds of distcc servers, supporting dozens of +simultaneous compiles. + +distcc is now reasonably stable and can successfully compile the Linux +kernel, rsync, KDE, GNOME (via GARNOME), Samba and Ethereal. distcc +is nearly linearly scalable for small numbers of machines: for a +typical case, three machines are 2.6 times faster than one. + +distcc is distributed under the GNU General Public Licence v2. |