S6-FTRIG-WAIT(8)

💅 s6-ftrig-wait — the manual page, but make it cute

okay so bestie, welcome to s6-ftrig-wait(8), from the System Manager's Manual. this one's a whole little vibe: you subscribe to an s6-fifodir(7), and then you just… wait. patiently. like a main character. 🎀

---

✨ NAME ✨

s6-ftrig-wait — subscribe to an s6-fifodir(7) and wait for a pattern of events to occur on this fifodir. that's it. that's the job. she's simple, she's iconic. 💅

---

🦋 SYNOPSIS 🦋

s6-ftrig-wait [-t timeout] fifodir regexp

literally just the program name, an optional -t timeout, then fifodir and regexp. no cap, that's the whole invocation. 🫶

---

🌸 DESCRIPTION 🌸

so s6-ftrig-wait subscribes to fifodir. she's in the group chat now. 👑

then she waits for the series of events received on fifodir to match regexp. and regexp must be an Extended Regular Expression[1] — that's the rule, no exceptions, iykyk. ⭐

and when the series of read events matches regexp? slay. at that exact moment, s6-ftrig-wait prints the last event it received to stdout (one byte followed by a newline), then exits 0. ate and left no crumbs. 🔥

---

💖 OPTIONS 💖

• -t timeout — if the events on fifodir have not matched regexp after timeout milliseconds, print an error message on stderr and exit 1. like, she waited, she really did. 🙈 by default, s6-ftrig-wait waits indefinitely for a matching series of events — she has all the time in the world, lowkey. 💜

---

🌈 SEE ALSO 🌈

these are all her besties, go say hi:

• s6-cleanfifodir(8)
• s6-ftrig-listen(8)
• s6-ftrig-listen1(8)
• s6-ftrig-notify(8)
• s6-ftrigrd(8)
• s6-mkfifodir(8)

[1] https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04

and for the record, this man page is ported from the authoritative documentation at: https://skarnet.org/software/s6/s6-ftrig-wait.html — go read the source, bestie, it's giving ✨references✨

---

👑 AUTHORS 👑

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

---

okay that's the whole page, ily, go match some regexps 🧚💖

this cutie was shipped by Debian, dated September 29, 2021, under the name S6-FTRIG-WAIT(8) — periodt. 🍓