lsdistcc(1)

1lsdistcc(1)                 General Commands Manual                lsdistcc(1)
2
3
4

NAME

6       lsdistcc - simple distcc server discovery
7
8

SYNOPSIS

10       lsdistcc [OPTIONS] [FORMAT]
11
12       lsdistcc [OPTIONS] host1 ...
13
14

DESCRIPTION

16       lsdistcc  autodetects listening distcc servers either by looking in DNS
17       for hosts named according to a given FORMAT, or by  checking  the  host
18       names given on the command line.
19
20       Hosts  are  considered  good servers based solely on whether their name
21       fits the format and whether they are listening on the right  port  (and
22       optionally whether they respond when you send them a compile job).
23
24       Scans  for  hosts named according to FORMAT (default is "distcc%d"; see
25       printf(3)) and starting from 1, so hosts such as distcc1, distcc2,  and
26       so  on.   Stops  after  7  seconds or the first host name that does not
27       resolve.  Prints the names of all such servers  listening  on  distcc's
28       port.
29
30       If  a  list  of  host names is given in the command line, lsdistcc will
31       only check those hosts.
32
33

OPTIONS

35       --help Displays summary instructions
36
37
38       -l     Output latency in milliseconds after each hostname (not  includ‐
39              ing DNS latency)
40
41
42       -n     Print IP address rather than name
43
44
45       -x     Append ,down to down hosts in host list
46
47
48       -tTIMEOUT
49              Set number of seconds to stop searching after [7]
50
51
52       -hHTIMEOUT
53              Set number of milliseconds before retrying gethostbyname [500]
54
55
56       -cCTIMEOUT
57              Set  number of milliseconds before giving up on connect [900] (0
58              to inhibit connect)
59
60
61       -kKTIMEOUT
62              Set number of milliseconds before giving up on compile [1500] (0
63              to inhibit compile)
64
65
66       -mBITS Set  number  of bits of address that must match first host found
67              [0]
68
69
70       -oOVERLAP
71              Set number of extra DNS requests to send [1]
72
73
74       -gDNSGAP
75              Set number of missing DNS entries to tolerate [0]
76
77
78       -rPORT Port to connect to [3632]
79
80
81       -PPROTOCOL
82              Protocol version to use (1-3) [1]
83
84
85       -pCOMPILER
86              Name of compiler to use [none]
87
88
89       -d     Append DNS domain name to format
90
91
92       -v     Verbose
93
94

EXAMPLES

96       Scan for servers named distcc1, distcc2, ...  that provide  a  compiler
97       named gcc-4.6 and include their latencies in the output:
98
99              $ lsdistcc -l -pgcc-4.6
100
101       Scan  for  a  compiler  named  gcc-4.6  on the servers hosta, somehost,
102       hostx, and hosty:
103
104              $ lsdistcc -pgcc-4.6 hosta somehost hostx hosty
105
106       To use the program in a build script, add the lines:
107
108              DISTCC_HOSTS=`lsdistcc`
109              export DISTCC_HOSTS
110
111       before the line that invokes make.  Or, in a Makefile, add the line:
112
113              export DISTCC_HOSTS = $(shell lsdistcc)
114
115       Or  use  pump(1)  which  automatically  invokes  lsdistcc  if  you  set
116       DISTCC_POTENTIAL_HOSTS.
117
118

EXIT STATUS

120       The exit status is 0 if any servers were found, and 1 otherwise.
121
122       Uses  'for  i=1...  sprintf(format,  i)' to construct names of servers,
123       stops after 7 seconds or at second server that doesn't resolve,  prints
124       the names of all such servers listening on distcc's port.  Default for‐
125       mat is distcc%d.
126
127

AUTHOR

135       lsdistcc was written by Dan Kegel, Dongmin Zhang, and Manos Renieris.
136
137       This manual page was written by Daniel Hartwig for the Debian project.
138
139
140
141                                  1 May 2012                       lsdistcc(1)