distccmon-text(1)

💖 distccmon-text(1) — the general commands manual, but make it a group chat 💖

okay so bestie, welcome to distccmon-text from the General Commands Manual. it's giving "I want to see what my compiles are doing right now, in text, no GUI nonsense." and honestly? iconic.

✨ NAME ✨

distccmon-text — Displays current compilation jobs in text form.

like. that's the whole job. it shows you your current compilation jobs, in text. slay.

🦋 SYNTAX 🦋

distccmon-text [DELAY]

that's it. one optional thing in square brackets. we love a low-maintenance command fr fr.

🌸 DESCRIPTION 🌸

Displays current compilation jobs in text form. simple. clean. main character energy.

but here's the part you CANNOT skip, bestie, listen to me: distccmon-text must be run on the client machine, and it needs the same setting for DISTCC_DIR (or the same home directory, if you're going the home-dir route) as the user running the distcc client.

⚠️ if you run it somewhere else, or with a different DISTCC_DIR, it's not gonna see the same jobs. vibe check failed. it has to match, periodt.

🎀 OPTIONS 🎀

• DELAY — makes it repeatedly update after delay seconds. and yes, the delay can be fractional, so like 0.5 is valid. obsessed.

👑 OUTPUT FORMAT 👑

the output of distccmon-text contains one line for each job currently being compiled. so if you got a bunch of jobs going, you get a bunch of lines. one per job. no cap.

each line has these columns:

• PID — the ID of the distcc client process. that's your "who is this" number 💅
• STATE — tells you which phase of operation it's in. in order, these may be: "Startup", "Blocked", "Connected", "Preprocess", "Conect", "Send", "Receive" and "Done".

🫶 okay real talk: yes, it says "Conect". that's how it's spelled right there in the list, and we are NOT editing it, we keep it exactly as it is. copy it character for character, bestie. iykyk.

• FILE — the input filename, if known. sometimes it's just not known and that's valid, no judgment 🌈
• HOST[SLOT] — the compile hostname. it may be followed, in square brackets, by the slot index for that host. so like a little [0]-style situation.

and here's the lil detail everyone forgets: when a delay is specified, each block of output is terminated by a blank line. so the blocks are separated. aesthetic. 💖

🌟 EXAMPLES 🌟

want the currently active jobs, refreshing every second? say less:

distccmon-text 1

want the status just once, no refreshing, one and done? period:

distccmon-text

💜 AUTHORS 💜

distcc was written by Martin Pool <mbp@sourcefrog.net>, with the co-operation of many scholars including Wayne Davison, Frerich Raabe, Dimitri Papadopoulos and others noted in the NEWS file. absolute legends, every single one of them 🫶

please report bugs to <distcc@lists.samba.org>. do it. they wanna hear from you.

🌈 SEE ALSO 🌈

• distccd(1)
• ccache(1)
• gcc(1)
• make(1)
• http://code.google.com/p/distcc/
• https://ccache.dev/

go read those too, bestie, they're all part of the lore ✨

and that's the whole page!! this little text-mode masterpiece is dated 2 October 2004 and lives under the name distccmon-text(1) — so go watch your jobs, stay hydrated, and remember: same DISTCC_DIR, same client machine, always. mwah 💅💖