~ubuntu-branches/debian/experimental/distcc/experimental

« back to all changes in this revision

Viewing changes to source/man/distcc.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:
134
134
Wrap your build inside the pump command, here assuming 10 servers:
135
135
 
136
136
.RS
137
 
$ pump make -j20 CC=distcc
 
137
$ distcc-pump make -j20 CC=distcc
138
138
.RE
139
139
.SH "HOW PLAIN (NON-PUMP) DISTCC WORKS"
140
140
distcc only ever runs the compiler and assembler remotely.  With plain distcc,
171
171
corresponds to the current working directory on the client.  To find and
172
172
transmit the many hundreds of files that are often part of a single compilation,
173
173
pump mode uses an incremental include analysis algorithm.  The include server is
174
 
a Python program that implements this algorithm.  The pump command starts the
 
174
a Python program that implements this algorithm.  The distcc-pump command starts the
175
175
include server so that throughout the build it can answer include queries by
176
176
distcc commands.
177
177
 
480
480
  SSH_HOST = [USER]@HOSTID[/LIMIT][:COMMAND][OPTIONS]
481
481
  TCP_HOST = HOSTID[:PORT][/LIMIT][OPTIONS]
482
482
  OLDSTYLE_TCP_HOST = HOSTID[/LIMIT][:PORT][OPTIONS]
483
 
  HOSTID = HOSTNAME | IPV4
 
483
  HOSTID = HOSTNAME | IPV4 | IPV6
484
484
  OPTIONS = ,OPTION[OPTIONS]
485
485
  OPTION = lzo | cpp
486
486
  GLOBAL_OPTION = --randomize
496
496
local machine for testing, then give the machine's IP address or real
497
497
hostname.  (This will be slower.)
498
498
.TP
 
499
.B IPV6
 
500
A literal IPv6 address enclosed in square brackets, such as
 
501
.B [::1]
 
502
.TP
499
503
.B IPV4
500
504
A literal IPv4 address, such as 
501
505
.B 10.0.0.1
534
538
.TP
535
539
.B ,cpp
536
540
Enables distcc-pump mode for this host.  Note: the build command must be 
537
 
wrapped in the pump script in order to start the include server.
 
541
wrapped in the distcc-pump script in order to start the include server.
538
542
.TP
539
543
.B --randomize
540
544
Randomize the order of the host list before execution.
884
888
distcc was written by Martin Pool <mbp@sourcefrog.net>, with the
885
889
co-operation of many scholars including Wayne Davison, Frerich Raabe,
886
890
Dimitri Papadopoulos and others noted in the NEWS file.  Please report
887
 
bugs to <distcc@lists.samba.org>.  See \fBpump\fR(1) for the authors of pump mode.
 
891
bugs to <distcc@lists.samba.org>.  See \fBdistcc-pump\fR(1) for the authors of pump mode.
888
892
.SH "LICENCE"
889
893
You are free to use distcc.  distcc (including this manual) may be
890
894
copied, modified or distributed only under the terms of the GNU
892
896
absolutely no warrany.  A copy of the GPL is included in the file
893
897
COPYING.
894
898
.SH "SEE ALSO"
895
 
\fBdistccd\fR(1), \fBpump\fR(1), \fBinclude_server\fR(1), \fBgcc\fR(1),
 
899
\fBdistccd\fR(1), \fBdistcc-pump\fR(1), \fBinclude_server\fR(1), \fBgcc\fR(1),
896
900
\fBmake\fR(1), and  \fBccache\fR(1).
897
901
.I http://code.google.com/p/distcc/
898
902
.I http://ccache.samba.org/