S6-FGHACK(8)

okay so bestie, welcome to S6-FGHACK(8) — the s6-fghack page from section 8 of the System Manager's Manual — and it is literally an anti-backgrounding tool. No cap. The vibes are “a hack”, but sometimes you gotta do what you gotta do 💅✨

🌸 NAME 🌸

<hotpink>s6-fghack</hotpink> — an anti-backgrounding tool 🫶

✨ SYNOPSIS ✨

Bestie, the whole mood is:

s6-fghack prog...

💖 DESCRIPTION 💖

Okay so here’s the tea ☕: s6-fghack opens a lot of file descriptors — and yes, all of them are writing to a single pipe. It’s giving descriptor party, honestly 🎉.

Then it spawns prog... as a child. Cute, right? 🧚

If something gets written on one of those descriptors, it’s a bug in prog. Periodt. s6-fghack then complains and exits 102. Not a drill, bestie 💀.

Unless prog... goes out of its way to close descriptors it does not know about, s6-fghack is able to detect when prog... exits. It exits with an approximation (cf. execline(1)) of the same exit code. That’s the whole trick ✨.

⚠️ Real talk: s6-fghack is what it says: a hack. Ideally, you should never have to use it. It is only useful when you want to supervise a daemon that does not provide a “stay in the foreground” option; and even then, the right thing is to report this as a bug to the daemon author and have it fixed. Like, please do that instead if you can 🙈💖

🦋 SEE ALSO 🦋

• s6-applyuidgid(8)
• s6-envdir(8)
• s6-envuidgid(8)
• s6-setsid(8)
• s6-setuidgid(8)
• s6-softlimit(8)
• s6-tai64n(8)
• s6-tai64nlocal(8)

This man page is ported from the authoritative documentation at: https://skarnet.org/software/s6/s6-fghack.html 🌈

👑 AUTHORS 👑

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

okay bye bestie 🫶 — this little page is stamped Debian, November 7, 2023, and S6-FGHACK(8), so that’s the footer vibe ✨💖