icecc-scheduler(1)

📦
version 1.4.0 · 3 versions
, in epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 icecc-scheduler(1) — the Icecream scheduler, bestie edition 💖

okay so you found your way to icecc-scheduler, the section-1 manual page, and honestly? you're about to have a great time. this is the main character of your compile farm and she is thriving. ✨

✨ SYNOPSIS ✨

icecc-scheduler [-d] [-r] [-l log-file] [-n net-name] [-p port] [-u user] [-v[v[v]]]

that's the whole vibe. flags in, chaos out (in a good way, a distributed way). 🦋

🌸 DESCRIPTION 🌸

so the Icecream scheduler is the central instance of an Icecream compile network. like, the queen bee. the group chat admin. everyone else is just a member of the server. 👑

what does she actually do? two iconic things:

  • she distributes the compile jobs — your builds get handed out to the network like party invites
  • she provides the data for the monitors — so icemon and friends have something cute to display

no scheduler, no network. it's giving load-bearing. no cap. 💅

🎀 OPTIONS 🎀

  • -d, --daemonize — detach the daemon from the shell. she leaves the group chat and goes to live on her own, fr fr. 🧚
  • -r, --persistent-client-connection — client connections are not disconnected from the scheduler even if there is a better scheduler available. she's keeping her friends close, and honestly? loyal. 🫶
  • -h, --help — print the help message and exit. the classic "just tell me what to do" move. 🙈
  • -l, --log-file log-file — the name of the file where log output is written to. her diary, basically. write it down, keep receipts. 📓
  • -n, --netname net-name — the name of the Icecream network the scheduler controls. this is the wifi password of your little compile kingdom. 🔑
  • -p, --port port — the IP port the scheduler uses. pick your door, bestie. 🚪
  • -u, --user-uid user — specify the system user used by the daemon, which must be different than root. like, do not. that's a hard no. if you don't specify it, the daemon defaults to the icecc system user if available, or nobody if not. she'll find a home either way. 💖
⚠️ not kidding about the root thing — the user must be different than root. periodt.
  • -v, -vv, -vvv — control the verbosity of the daemon. the more v the more verbose. one v is a lil whisper, three vs is her telling you everything. 🗣️🔥

🌈 SEE ALSO 🌈

go read the whole friend group, iykyk. 💜

⭐ AUTHOR ⭐

Cornelius Schumacher — the original author, the blueprint, the icon. respect the architect. 👑

and that's the page!! the source/version + date on this one is April 21th, 2005 (yes, "21th", we love her exactly as she is, no notes 💀) — so if you're reading this in the year of our lord 2025+, just know this manual has been slaying since 2005 and she's not stopping. 🌸✨ bye bestie, go schedule something! 🎀

📦 where this page comes from