~ubuntu-branches/debian/jessie/distcc/jessie

« back to all changes in this revision

Viewing changes to source/man/pump.1

  • Committer: Package Import Robot
  • Author(s): Daniel Hartwig
  • Date: 2012-05-05 17:24:18 UTC
  • Revision ID: package-import@ubuntu.com-20120505172418-d5821mf4ys0vvh2o
Tags: 3.1-5
* new maintainer (Closes: #664497)
* update Standards-Version to 3.9.3:
  - debian/distcc.init.d: start action exits successfully if daemon
    is already running [9.3.2]; postinst will succeed on upgrades in
    this case also (Closes: #620773, LP: #822887)
* switch to dpkg-source 3.0 (quilt) format
* remove Build-Depends: dpatch
* add Build-Depends: autotools-dev
* debian/rules:
  - use debhelper compat level 9
  - reduce to "dh $@" style
  - fixes FTBFS caused by previous build-arch target (Closes: #666383)
  - enabled bindnow hardening (no PIE yet, it causes build failure)
* debian/control:
  - added Homepage field
  - distcc: description starts lowercase
* debian/distcc.config:
  - renamed from debian/config
  - use "set -e"
  - include missing #DEBHELPER# token
* debian/distcc.init.d:
  - added stop levels 0, 6
  - unset TMPDIR before starting the daemon to avoid problems with
    root's value for this being unwritable by the distccd user; to
    provide distccd with a sensible TMPDIR put it in /etc/default/distcc
    (Closes: #514556)
* debian/distcc.postinst:
  - use "set -e" instead of "#!/bin/sh -e"
  - drop extra calls to "sed ... /etc/default/distcc" for every field
    that only removed whitespace which would be removed anyway when
    updating the fields
  - always create distccd user if it does not exist (Closes: #548053)
* debian/distccmon-gnome.menu:
  - changed title to "distcc monitor"
  - dropped incorrect hint tag
* debian/patches:
  - 06_set-pythonpath-securely.patch: contains fix for #605168 which
    was previously applied directly to the source
  - 07_preferred-user.patch: starting the daemon as root causes it to
    change user, which should be to "distccd" in Debian
  - 08_gnome-data-public-dirs.patch: install desktop and icon files for
    distccmon-gnome /usr/share/applications and /usr/share/pixmaps
    respectively (LP: #512288)
  - 09_rename-pump.patch: rename the "pump" command to "distcc-pump" in
    all references such as help text, man pages, etc. (Closes: #594083)
  - 10_consecutive-preprocessor-options.patch: correctly count
    preprocessor options (Closes: #626926)
  - 11_lsdistcc-man.patch: add man page for lsdistcc utility
* debian/watch:
  - added remote watch file
* source/config.{guess,sub}:
  - update with autotools-dev during build instead of directly patching
    the source tree
* use dpkg triggers to dynamically generate/update compiler links
  based on the ccache packaging.  Thanks to Daniel Schaal
  (Closes: #651670)
* cherry-pick upstream fixes for IPv6 support (Closes: #452835):
  - r650_ipv6-zeroconf.patch: IPv6 patch for Zeroconf and IPv6 literals
    in hosts file (Closes: #481951, LP: #593047)
  - r673_zeroconf-nodups.patch: remove duplicate hosts from the Zeroconf
    list (LP: #809534)
  - r678_distcc-v6-acl-2.patch: IPv6 support for access control
* cherry-pick other upstream fixes:
  - r732_distccmon-gnome.patch: avoid client list growing indefinitely
    (LP: #521165)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.TH pump 1 "9 June 2008"
2
2
.SH "NAME"
3
 
pump \- accelerate remote compilation with distcc
 
3
distcc-pump \- accelerate remote compilation with distcc
4
4
.SH "SYNOPSIS"
5
 
.B pump
 
5
.B distcc-pump
6
6
.I BUILD-COMMAND [ARGS]
7
7
\& ...
8
8
.BR
9
9
.PP
10
10
eval `
11
 
.B pump
 
11
.B distcc-pump
12
12
--startup `;
13
13
.I BUILD-COMMAND [ARGS]
14
14
\& ...
15
15
;
16
 
.B pump
 
16
.B distcc-pump
17
17
--shutdown
18
18
.BR
19
19
.SH "DESCRIPTION"
20
 
.B pump
 
20
.B distcc-pump
21
21
is part of distcc.
22
22
It is used for distcc's pump mode.
23
23
Distcc's pump mode accelerates remote compilation with distcc
36
36
.PP
37
37
The simplest usage is the form
38
38
.RS
39
 
.B pump
 
39
.B distcc-pump
40
40
.I COMMAND [ARG]
41
41
\& ...
42
42
.RE
45
45
.B lsdistcc
46
46
to compute the distcc host list;
47
47
set some auxiliary environment variables;
48
 
change PATH to use the distcc client in the same directory as the "pump"
 
48
change PATH to use the distcc client in the same directory as the "distcc-pump"
49
49
script;
50
50
execute
51
51
.I COMMAND
59
59
"make -j80", that will do many concurrent invocations of distcc.
60
60
.PP
61
61
An alternative way of invoking
62
 
.B pump
63
 
is to explicitly invoke "pump --startup"
64
 
to start the include server and "pump --shutdown" to stop the include server.
65
 
The "pump --startup" command will start up the include server, and will print
 
62
.B distcc-pump
 
63
is to explicitly invoke "distcc-pump --startup"
 
64
to start the include server and "distcc-pump --shutdown" to stop the include server.
 
65
The "distcc-pump --startup" command will start up the include server, and will print
66
66
out some environment variable settings.  These environment variables are used
67
67
to communicate between the pump-mode "distcc" client and the include
68
 
server, and to communicate between "pump --startup" and "pump --shutdown".
69
 
The caller of "pump --startup" is responsible for setting those environment
70
 
variables before invoking "distcc" or "pump --shutdown".
 
68
server, and to communicate between "distcc-pump --startup" and "distcc-pump --shutdown".
 
69
The caller of "distcc-pump --startup" is responsible for setting those environment
 
70
variables before invoking "distcc" or "distcc-pump --shutdown".
71
71
.PP
72
72
For example:
73
73
.RS
74
 
eval `pump --startup`
 
74
eval `distcc-pump --startup`
75
75
.br
76
76
make -j80
77
77
.br
78
 
pump --shutdown
 
78
distcc-pump --shutdown
79
79
.RE
80
80
.PP
81
81
Note that distcc's pump-mode assumes that sources files will not be
84
84
may cause inconsistent results.
85
85
.SH "INVOKING LSDISTCC"
86
86
When invoked in either the simple "
87
 
.B pump
 
87
.B distcc-pump
88
88
.I COMMAND [ARG]
89
89
\&... " form,
90
90
or as "
91
 
.B pump --startup
 
91
.B distcc-pump --startup
92
92
\&", the
93
 
.B pump
 
93
.B distcc-pump
94
94
script will invoke
95
95
.B lsdistcc
96
96
\& whenever DISTCC_POTENTIAL_HOSTS is set and DISTCC_HOSTS isn't.
109
109
needed for
110
110
.BR distcc(1)
111
111
or
112
 
.B pump --shutdown
 
112
.B distcc-pump --shutdown
113
113
to access it.
114
114
.TP
115
115
.B --shutdown
116
116
Shuts down an include server started up by
117
 
.B pump --startup.
 
117
.B distcc-pump --startup.
118
118
.SH "ENVIRONMENT VARIABLES"
119
119
The following environment variables are all optional.
120
120
.TP
154
154
PYTHONOPTIMIZE
155
155
If set to "", then Python optimization is disabled.
156
156
.SH "EXAMPLE"
157
 
.B pump make -j20
 
157
.B distcc-pump make -j20
158
158
.SH "BUGS"
159
159
.\" TODO:
160
160
.\" Fix inconsistency between BUGS section and bug reporting instructions
163
163
.I reporting-bugs.txt
164
164
in the documentation directory for information on how to report it.
165
165
.SH "AUTHORS"
166
 
The pump script and distcc's pump mode were written by Nils Klarlund,
 
166
The distcc-pump script and distcc's pump mode were written by Nils Klarlund,
167
167
Manos Renieris, Fergus Henderson, and Craig Silverstein. Please report
168
168
bugs to <distcc@lists.samba.org>.
169
169
.SH "LICENCE"
170
 
.B pump
 
170
.B distcc-pump
171
171
is part of distcc.
172
172
You are free to use distcc.  distcc (including this manual) may be
173
173
copied, modified or distributed only under the terms of the GNU