pump (1) - Linux Man Pages
pump: accelerate remote compilation with distcc
NAMEpump - accelerate remote compilation with distcc
SYNOPSISpump BUILD-COMMAND [ARGS] ...
DESCRIPTIONpump is part of distcc. It is used for distcc's pump mode. Distcc's pump mode accelerates remote compilation with distcc by also distributing preprocessing to the servers.
For a detailed description of pump mode, including most notably some important restrictions, see the distcc(1) man page, in particular the HOW PUMP-MODE WORKS section and the RESTRICTIONS ON PUMP MODE section.
The simplest usage is the form
- pump COMMAND [ARG] ...
An alternative way of invoking pump is to explicitly invoke "pump --startup" to start the include server and "pump --shutdown" to stop the include server. The "pump --startup" command will start up the include server, and will print out some environment variable settings. These environment variables are used to communicate between the pump-mode "distcc" client and the include server, and to communicate between "pump --startup" and "pump --shutdown". The caller of "pump --startup" is responsible for setting those environment variables before invoking "distcc" or "pump --shutdown".
eval `pump --startup`
Note that distcc's pump-mode assumes that sources files will not be
When invoked in either the simple "
... " form,
or as "
script will invoke
whenever DISTCC_POTENTIAL_HOSTS is set and DISTCC_HOSTS isn't.
It will pass the value of DISTCC_POTENTIAL_HOSTS to
and use the output of
to set DISTCC_HOSTS.
The following environment variables are all optional.
pump make -j20
If you think you have found a distcc bug, please see the file
in the documentation directory for information on how to report it.
The pump script and distcc's pump mode were written by Nils Klarlund,
Manos Renieris, Fergus Henderson, and Craig Silverstein. Please report
bugs to <distcc [at] lists.samba.org>.
is part of distcc.
You are free to use distcc. distcc (including this manual) may be
copied, modified or distributed only under the terms of the GNU
General Public Licence version 2 or later. distcc comes with
absolutely no warranty. A copy of the GPL is included in the file