S6-RC-WHY(7)

📦 version 0.7.0.0, in nixpkgs unstable

💖 NAME 💖

S6-RC-WHY(7) — why s6-rc 💅

okay bestie, welcome to S6-RC-WHY(7) from the Miscellaneous Information Manual. this is the “why is s6-rc even a thing” page, and it’s giving big-brain Unix energy fr fr 🧚✨

✨ DESCRIPTION ✨

🧚 The limits of supervision suites 🧚

Supervision suites like s6[1], runit[2], perp[3], or daemontools[4] define a service as a long-lived process, a.k.a. a daemon. they give you tools to run that daemon in a reproducible way inside a controlled environment and keep it alive if it dies; they also give you daemon management tools that, among other things, let you send signals to the daemon without knowing its PID. they can control individual long-lived processes perfectly well, and s6 also provides tools to manage a whole supervision tree. to any system administrator who cares about reliability, supervision suites are a good thing. 💖

but — and this is the whole point — a supervision suite is not a service manager. periodt.

relying on a supervision suite to handle all the service management is doable on simple systems, where there aren’t many dependencies, and where most of the one-time initialization can take place in stage 1, before any daemons are launched. on some embedded systems, for instance, this is perfectly reasonable. 🎀

on other systems, though, it gets more problematic. here are a few issues encountered:

  • with a pure supervision tree, all daemons are launched in parallel; if their dependencies are not met, daemons just die, and are restarted by the supervisors, and so on; so eventually the dependency tree is correctly built and everything is brought up. this is okay with lightweight daemons that do not take up too many resources when starting; but with heavyweight daemons, bringing them up at the wrong time can expend CPU or cause heavy disk access, and increase the total booting time significantly. 😭
  • the runit model of separating one-time initialization (stage 1) and daemon management (stage 2) does not always work: some one-time initialization may depend on a daemon being up. example: udevd on Linux. such daemons then need to be run in stage 1, unsupervised — which defeats the purpose of having a supervision suite. 💀
  • more generally, supervision suites do not perform dependency management. their job is to maintain daemons alive and ease their administration; dependency across those daemons is not their concern, and one-time initialization scripts are entirely foreign to them. so a situation like udevd where it is necessary to interleave daemons and one-time scripts is not handled properly by them.

to manage complex systems, pure supervision suites are insufficient, and real service managers — starting and stopping services in the proper order and handling both oneshots (one-time initialization scripts) and longruns (daemons) — are needed. no cap. 🔥

🌸 Previous alternatives 🌸

Unix distributions usually come with their own init systems and service managers; all of those have flaws one way or another. no widely spread init system gets things right, which is the main reason for the recent “init wars” — no matter what init system you talk about, there are strong, valid reasons to like it and support it, and there are also strong, valid reasons to dislike it. 🙈

non-supervision init systems usually fall in one of two categories, both with pros and cons.

💅 Traditional, sequential starters 💅

those are either the historical Unix init systems, or newer systems that still favor simplicity. among them, for instance:

  • sysvinit[5], the historical GNU/Linux init system, and its companion set of /etc/rc.d init scripts that some distributions like to call sysv-rc. note that sysvinit does have supervision capabilities, but nobody ever bothered to use them for anything else than gettys, and all the machine initialization, including longruns, is done by the sysv-rc scripts, in a less than elegant way. 🫠
  • BSD init[6], which is very similar to sysvinit — including the supervision abilities that are only ever used for gettys. the /etc/rc script takes care of all the initialization. 🎀
  • OpenRC[7], an alternative, dependency-based rc system. 🦋

all these systems run sequentially: they will start services, either oneshots or longruns, one by one, even when the dependency graph says that some services could be started in parallel. also, the daemons they start are always unsupervised, even when the underlying init system provides supervision features. there usually is no readiness notification support (cf. s6-notifywhenup(7)) on daemons either — daemons are fire-and-forget (but that’s more on the scripts themselves than on the frameworks). another common criticism of those systems is that the amount of shell scripting is so huge that it has a significant performance impact. 😭

(note that OpenRC has an option to start services in parallel, but at the time of this writing, it uses polling on a lock file to check whether a service has completed all its dependencies; this is heavily prone to race conditions, and is not the correct mechanism to ensure proper service ordering, so this option cannot be considered reliable.) ⚠️

another, less obvious, but important drawback is that service-launching scripts run as scions of the shell that invoked the command, and so they may exhibit different behaviours when they’re run automatically at boot time and when they’re run manually by an admin, because the environment is different. scripts usually try to run in a clean environment, but it’s hard to think of everything (open file descriptors!) and every script must protect itself with a gigantic boilerplate, which adds to the inefficiency problem. 💀

👑 Monolithic init behemoths 👑

the other category of service managers is made of attempts to cover the flaws of traditional service starters, and provide supervision, dependency management and sometimes readiness notification, while reducing the amount of scripting needed. unfortunately, the results are tightly integrated, monolithic init systems straying far away from Unix core principles, with design flaws that make the historical inits’ design flaws look like a joke. 😭

  • Upstart[8] was the first one. the concepts in Upstart are actually pretty good: in theory, it’s a decent event-based service manager. unfortunately, the implementation is less than ideal. for instance, the service file format is full of adhocisms breaking the principle of least surprise. but most importantly, Upstart was the first system that used ptrace(2) on the processes it spawned in order to keep track of their forks. if you don’t know what that means: it’s complete insanity, using a debug feature in production, with heavy impact on security and efficiency. 💀
  • launchd[9], Darwin’s init and service manager. the Wikipedia page (linked here because Apple doesn’t see fit to provide a documentation page for launchd) is very clear: it replaces init, rc, init.d/rc.d, SystemStarter, inetd, crontd, atd and watchdogd. it does all of this in process 1. and it uses XML for daemon configuration, so launchctl has to link in an XML parsing library, and it communicates with process 1 via a Mach-specific IPC mechanism. is this the sleek, elegant design that Apple is usually known for? like, stick to selling iPhones, guys. 💅
  • systemd[10], the main protagonist (or antagonist) in the “init wars”. it has the same problems as launchd, up by an order of magnitude; here[11] is why. systemd avowedly aims to replace the whole low-level user-space of Linux systems, but its design is horrendous. it doesn’t even get readiness notification right[12]. 🔥💀

the problem of integrated init systems is that:

  • they have been developed by companies and associations, not individuals, and despite the licensing, they are for all intents and purposes closer to proprietary software than free software; they also suffer from many of the technical flaws of enterprise software design.
  • as a result, and despite being backed by tremendous manpower, they have been very poorly thought out. the manpower goes into the coding of features, not into architecture conception; and the architects were obviously not Unix experts, which is a shame when it’s about creating a process 1 for Unix. this is apparent because:
  • they have been designed like application software, not system software, which requires a fairly different set of skills, and careful attention to details that are not as important in application software, such as minimal software dependencies and shortness of code paths.

pages and pages could be — and have been — written about the shortcomings of integrated init systems, but one fact remains: they are not a satisfying solution to the problem of service management under Unix. periodt. 🫶

🦋 The best of both worlds 🦋

s6-rc aims to be such a solution: it is small and modular, but offers full functionality. parallel service startup and shutdown with correct dependency management (none of the systemd nonsense where services are started before their dependencies are met), correct readiness notification support, reproducible script execution, and short code paths. ✨👑

  • s6-rc is a service manager, i.e. the equivalent of sysv-rc or OpenRC. it is not an init system. you can run s6-rc with any init system of your choosing. of course, s6-rc requires an s6 supervision tree to be running on the system, since it delegates the management of longrun services to that supervision tree, but it does not require that s6 be the init system itself. s6-rc will work when s6-svscan(8) runs as process 1 (cf. s6-svscan-as-process-1(7) — on Linux, such a setup can be easily achieved via the help of the s6-linux-init package), and it will also work when s6-svscan(8) runs under another init process (cf. s6-svscan-not-as-process-1(7)). 🌈
  • the service manager runs on top of a supervision suite. it does not try to make it perform boot/shutdown operations or dependency management itself; and it does not substitute itself to it. s6-rc uses the functionality provided by s6, but it is still possible to run s6 without s6-rc for systems that do not need a service manager. it would also be theoretically possible to run s6-rc on top of another supervision suite, if said supervision suite provided the hooks that s6-rc needs. 🫶
  • the dependency-graph grind? okay so analyzing a whole set of services and computing a dependency graph for that set is a significantly time-consuming part of any service manager, fr fr. And at the time of writing this document, s6-rc is the only service manager that does that work offline — which means it eliminates the dependency analysis overhead from boot time, shutdown time, or literally any other time where the machine state changes. iconic behavior, honestly 👑
  • the source format stays simple on purpose. the source format for the s6-rc-compile(8) tool is purposefully simple, so that external tools can automatically write service definitions for s6-rc — for instance, for conversions between service manager formats. cooperation slay 💅
  • tiny code, does its job, nothing else. like every skarnet.org tool[13], s6-rc is made of very little code, that does its job and nothing else. the binaries are small, it is very light in memory usage, and the code paths are extremely short. she's efficient, she's minimal, she's that girl ✨

the combination of s6 and s6-rc makes a complete, full-featured and performant init system and service manager, with probably the lowest total memory footprint of any service manager out there, plus all the reliability and ease of administration that a supervision suite can provide. it is a real, viable alternative to integrated init behemoths, providing equivalent functionality while being much smaller and much more maintainable. no cap — she's a whole main character 💖

🦋 SEE ALSO 🦋

the besties she wants you to meet:

and the receipts (iykyk) 🧾:

this man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-rc/why.html — always gotta give credit where credit is due 🫶

🎀 AUTHORS 🎀

  • Laurent Bercot 👑
  • Alexis <flexibeast@gmail.com> (man page port) 💜

and that's the whole page, bestie — you made it 💅 this drop is from Debian, dated April 6, 2023, and she's filed as S6-RC-WHY(7). go forth and run your services, you beautiful little sysadmin 🌈💖

📦 where this page comes from