lsdistcc(1)

💅 lsdistcc — the manual page, but make it make sense

okay bestie, so this is lsdistcc(1) from the General Commands Manual section — it's a whole little icon and honestly it deserves more hype than it gets. let me tell you everything 💖

✨ NAME ✨

lsdistcc — simple distcc server discovery 🦋

like, it finds your distcc servers for you. that's the whole vibe.

🌸 SYNOPSIS 🌸

lsdistcc [OPTIONS] [FORMAT]

lsdistcc [OPTIONS] host1 ...

two ways in, bestie. pick your fighter.

🎀 DESCRIPTION 🎀

so lsdistcc autodetects listening distcc servers, and it does it two ways:

• it goes looking in DNS for hosts named according to a given FORMAT, or
• it just checks the host names you hand it right there on the command line.

and how does it decide who's a "good server"? 💅 based solely on whether their name fits the format and whether they're listening on the right port. that's it. (and optionally, whether they respond when you send them a compile job — fancy.)

it scans for hosts named according to FORMAT (default is distcc%d; see printf(3)) and it starts from 1, so you get hosts like distcc1, distcc2, and so on and so forth. then it stops after 7 seconds or at the first host name that does not resolve. and it prints the names of all such servers listening on distcc's port. slay ✨

oh and if you give it a list of host names on the command line, lsdistcc will only check those hosts. no extras, no surprises. periodt.

👑 OPTIONS 👑

• --help — displays summary instructions. the "help me bestie" button 🫶
• -l — output latency in milliseconds after each hostname (not including DNS latency). like, how fast are they actually 🏃
• -n — print IP address rather than name. numbers instead of names, no cap.
• -x — append ,down to down hosts in host list. calling them out fr fr 😭
• -tTIMEOUT — set number of seconds to stop searching after [7]. the patience setting.
• -hHTIMEOUT — set number of milliseconds before retrying gethostbyname [500].
• -cCTIMEOUT — set number of milliseconds before giving up on connect [900] (0 to inhibit connect). note the 0, it literally means "don't even try" 💀
• -kKTIMEOUT — set number of milliseconds before giving up on compile [1500] (0 to inhibit compile). same energy, but for compiling.
• -mBITS — set number of bits of address that must match first host found [0].
• -oOVERLAP — set number of extra DNS requests to send [1].
• -gDNSGAP — set number of missing DNS entries to tolerate [0].
• -rPORT — port to connect to [3632].
• -PPROTOCOL — protocol version to use (1-3) [1]. it's giving options.
• -pCOMPILER — name of compiler to use [none].
• -d — append DNS domain name to format.
• -v — verbose. the yapper mode 🗣️

🌈 EXAMPLES 🌈

scan the whole squad

scan for servers named distcc1, distcc2, ... that provide a compiler named gcc-4.6 and include their latencies in the output:

$ lsdistcc -l -pgcc-4.6

just these four, thanks

scan for a compiler named gcc-4.6 on the servers hosta, somehost, hostx, and hosty:

$ lsdistcc -pgcc-4.6 hosta somehost hostx hosty

putting it in a build script 🧚

to use the program in a build script, add the lines:

DISTCC_HOSTS=`lsdistcc`
export DISTCC_HOSTS

before the line that invokes make. or, in a Makefile, add the line:

export DISTCC_HOSTS = $(shell lsdistcc)

or use pump(1) which automatically invokes lsdistcc if you set DISTCC_POTENTIAL_HOSTS. yes bestie, it does the work for you. main character energy 💜

⭐ EXIT STATUS ⭐

the exit status is 0 if any servers were found, and 1 otherwise. found = happy, found nothing = 😔

uses 'for i=1... sprintf(format, i)' to construct names of servers, stops after 7 seconds or at second server that doesn't resolve, prints the names of all such servers listening on distcc's port. default format is distcc%d.

🔥 SEE ALSO 🔥

distcc(1), distccd(1), pump(1), printf(3)

http://code.google.com/p/distcc/

💖 AUTHOR 💖

lsdistcc was written by Dan Kegel, Dongmin Zhang, and Manos Renieris.

this manual page was written by Daniel Hartwig for the Debian project.

and that's the whole page bestie, no notes 💅

signing off with the source + date realness: this is lsdistcc(1), dated 1 May 2012 — General Commands Manual, slay, periodt ✨🦋🌸