S6-FORMAT-FILTER(1)

💅 s6-format-filter, bestie ✨

okay so real talk: this is the s6-format-filter(1) page from the General Commands Manual and it's genuinely so cute once you get it. it takes lines, it formats them, it prints them. that's the whole vibe. no cap.

---

🌸 NAME 🌸

s6-format-filter — processes lines according to arguments, and prints the result. literally that's it, that's the girlboss move 💖

---

✨ SYNOPSIS ✨

s6-format-filter format [args...]

---

🦋 DESCRIPTION 🦋

okay so <italic>format</italic> is a format string, right? and it can contain these special little sequences, and you need to know all of them, so:

• %%
• %s
• %0 to %9

that's the whole set, iykyk 🎀

now for every single line it reads on stdin, s6-format-filter prints format on stdout — but with the swapsies happening:

• %% gets replaced with %
• %0 gets replaced with the command name (probably s6-format-filter, she's not being shady about it, it's just probably that)
• %1 to %9 get replaced with the first to the ninth argument in args
• %s gets replaced with the input line 👑

and then s6-format-filter exits 0 when it reads EOF. clean, iconic, no drama. periodt 💅

---

💀 EXIT STATUS 💀

bestie please pay attention to these, they're literally telling you what happened:

• 111 — Temporary error. she's going through something, try again later 🙈
• 100 — Permanent error, such as a misuse. yeah that one's on you fr fr 😭
• 127 — Unable to execute program - not found. she's not here, she's not coming 💔
• 126 — Unable to execute program - other reason. she's here but something's wrong 🫶

---

🌈 SEE ALSO 🌈

okay the reading list is LONG but she ate, every single one of these links is carrying its weight:

s6-basename(1), s6-cat(1), s6-chmod(1), s6-chown(1), s6-clock(1), s6-cut(1), s6-dirname(1), s6-dumpenv(1), s6-echo(1), s6-env(1), s6-expr(1), s6-false(1), s6-grep(1), s6-head(1), s6-hiercopy(1), s6-linkname(1), s6-ln(1), s6-ls(1), s6-maximumtime(1), s6-mkdir(1), s6-mkfifo(1), s6-nice(1), s6-nuke(1), s6-pause(1), s6-printenv(1), s6-quote(1), s6-quote-filter(1), s6-rename(1), s6-rmrf(1), s6-seq(1), s6-sleep(1), s6-sort(1), s6-sync(1), s6-tai64ndiff(1), s6-tail(1), s6-touch(1), s6-true(1), s6-uniquename(1), s6-unquote(1), s6-unquote-filter(1), s6-update-symlinks(1), seekablepipe(1)

This man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/s6-format-filter.html — go read the source, she's the main character 🧚

---

👑 AUTHORS 👑

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

---

and that's the whole page, bestie 🍓💜 cute lil sign-off: this one's from Debian, dated April 16, 2022, and it's living in S6-FORMAT-FILTER(1) — she's been iconic since day one, obsessed 🎀⭐🔥