S6-INSTANCE-LIST(8)

📦 version 2.15.1.0, in nixpkgs unstable

💅 s6-instance-list — the roster of your instances, bestie

okay so real talk, this is s6-instance-list from section 8 of the manual (system manager's manual energy ✨), and it's literally the "who's here" page for your s6-instanced-service(7). Like, the guest list. The roster. The group chat member list. 🫶

🌸 SYNOPSIS 🌸

s6-instance-list servicedir

✨ DESCRIPTION ✨

So s6-instance-list is expecting a running, supervised s6-instanced-service(7) sitting in servicedir — and also an existing instance of this service named name. (yes queen, that's what it says, we're keeping it 💅)

What it does is print to stdout, one per line, the names of all the existing instances of servicedir — meaning the ones that have been created and not deleted. Doesn't matter if they're up or down, bestie; if they've been created and not deleted, they get printed. periodt. 🔥

It exits 0. iconic behavior, no notes.

The list is unsorted — the instance names come out in an unspecified order, so don't come for me if your fave isn't first. 🙈

Here's the fun part: you can use s6-instance-list to script up commands that handle whole sets of instances. Like, say you wanna grab the status of every instance of a given service — you could write:

for i in `s6-instance-list service` ; do printf "%s: " $i ; s6-instance-status service $i ; done

it's giving automation. it's giving main character scripting. iykyk. 🧚

💖 EXIT STATUS 💖

  • 0 — Success. slay.
  • 100 — Wrong usage. 💀 (you called it wrong, babe)
  • 111 — System call failed. 😭 (not your fault, the system's being weird)

🦋 SEE ALSO 🦋

the whole squad, all linked up 💜

👑 AUTHORS 👑

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

okay that's the whole page, mwah 💋 this lil beauty dropped in the Debian edition on January 15, 2023 — yeah it's been iconic for a minute. go forth and list those instances, bestie 🎀⭐

📦 where this page comes from