|--help||Display summary usage information.|
|Shows the daemon version and exits.|
|-j, --jobs JOBS|
|Sets a limit on the number of jobs that can be accepted at any time. By default this is set to two greater than the number of CPUs on the machine, to allow for some processes being blocked on network IO. (Daemon mode only.)|
|-N, --nice NICENESS|
|Makes the daemon more nice about giving up the CPU to other tasks on the machine. NICENESS is an increment to the current priority of the process. The range of priorities depends on the operating system but is typically 0 to 20. By default the niceness is increased by 5.|
|-p, --port PORT|
|Set the TCP port to listen on, rather than the default of 3632. (Daemon mode only.)|
|Instructs the distccd daemon to listen on the IP address ADDRESS. This can be useful for access control on dual-homed hosts. (Daemon mode only.)|
|-P, --pid-file FILE|
|Save daemon process id to file FILE. (Daemon mode only.)|
|If distccd gets executed as root, change to user USER.|
|-a, --allow IPADDR[/MASK]|
|Instructs distccd to accept connections from the IP address IPADDR. A CIDR mask length can be supplied optionally after a trailing slash, e.g. 192.168.0.0/24, in which case addresses that match in the most significant MASK bits will be allowed. If no --allow options are specified, distccd will exit immediately! Unauthorized connections are rejected by closing the TCP connection immediately. A warning is logged on the server but nothing is sent to the client.|
|Kills a distccd job if it runs for more than SECONDS seconds. This prevents denial of service from clients that dont properly disconnect and compilers that fail to terminate. By default this is turned off.|
|Do not detach from the shell that started the daemon.|
|Dont fork children for each connection, to allow attaching gdb. Dont use this if you dont understand it!|
|Send messages to file FILE instead of syslog. Logging directly to a file is significantly faster than going via syslog and is recommended.|
|Set the minimum severity of error that will be included in the log file. Useful if you only want to see error messages rather than an entry for each connection. LEVEL can be any of the standard syslog levels, and in particular critical, error, warning, notice, info, or debug.|
|Send log messages to stderr, rather than to a file or syslog. This is mainly intended for use in debugging. Do not use in inetd mode.|
|Include debug messages in log. Equivalent to --log-level=debug|
|Turn on all options appropriate for starting distccd under gdb: run as a daemon, log verbosely to stderr, and do not detach or fork. For wizards only.|
|Turn on the statistics HTTP server. By default it is off. (Daemon mode only.)|
|Set the TCP port to listen on for HTTP requests, rather than the default of 3633. (Daemon mode only.)|
|Serve a client connected to stdin/stdout. As the name suggests, this option should be used when distccd is run from within a super-server like inetd. distccd assumes inetd mode when stdin is a socket.|
|Bind and listen on a socket, rather than running from inetd. This is used for standalone mode. distccd assumes daemon mode at startup if stdin is a tty, so --daemon should be explicitly specified when starting distccd from a script or in a non-interactive ssh connection.|
|Register the availability of this distccd server using Avahi Zeroconf DNS Service Discovery (DNS-SD). This allows distcc clients on the local network to access this distccd server without explicitly listing its host name or IP address in their distcc host list: the distcc clients can just use "+zeroconf" in their distcc host lists. This option is only available if distccd was compiled with Avahi support enabled.|
distcc can pass either a relative or an absolute name for the compiler to distccd. If distcc is given an explicit absolute compiler filename, that name is used verbatim on both the client and server. If the compiler name is not an absolute path, or if the client is used in masquerade mode, then the servers PATH is searched.
distccd inherits its search path from its parent process. By default distccd tries to remove directories that seem to contain distccd masquerade links, to guard against inadvertent recursion. The DISTCCD_PATH environment variable may be used to set the path.
The search path is logged when --verbose is given. In case of confusion, check the logs.
When distccd is run over ssh, the $HOME/.ssh/environment file may be useful in setting the path. See ssh(1).
distccd logs messages to syslogs daemon facility by default, which normally writes to /var/log/daemon or /var/log/messages. Log messages can be sent to a different file using the --log-file option.
DISTCC_CMDLIST If the environment variable DISTCC_CMDLIST is set, load a list of supported commands from the file named by DISTCC_CMDLIST, and refuse to serve any command whose last DISTCC_CMDLIST_MATCHWORDS last words do not match those of a command in that list. See the comments in src/serve.c. DISTCC_CMDLIST_NUMWORDS The number of words, from the end of the command, to match. The default is 1. DISTCCD_PATH When starting distccd, if this value is set it will be used unaltered for the command-execution PATH. The code that normally tries to remove masquerade directories from the path is skipped. DISTCC_SAVE_TEMPS If set to 1, temporary files are not deleted after use. Note that DISTCC_LOG does not affect the log destination for the server. DISTCC_TCP_DEFER_ACCEPT On Linux, turn on the TCP_DEFER_ACCEPT socket option. Defaults to on. TMPDIR Directory for temporary files such as preprocessor output. By default /tmp/ is used.
distcc(1), pump(1), include_server(1), gcc(1), make(1), and ccache(1) http://code.google.com/p/distcc/
IP-based access control is not secure against attackers able to spoof TCP connections, and cannot discriminate different users on a client.
TCP connections are not secure against attackers able to observe or modify network traffic.
Because ccache does not cache compilation from .i files, it is not useful to call it from distccd.
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 warrany. A copy of the GPL is included in the file COPYING.
distcc was written by Martin Pool <email@example.com>, with the co-operation of many scholars including Wayne Davison, Frerich Raabe, Dimitri Papadopoulos and others noted in the NEWS file. See pump(1) for the authors of pump mode. Please report bugs to <firstname.lastname@example.org>.
|-->||DISTCCD (1)||9 June 2008|