SEEKABLEPIPE(1)

💅 SEEKABLEPIPE(1) — like, the general commands manual, bestie

okay so picture this: you're in the General Commands Manual section (section 1, iykyk) and you've got a seekablepipe moment. let me tell you everything 🫶

---

✨ NAME ✨

seekablepipe — turn the reading end of a pipe into a seekable file descriptor, using a temporary file. literally that's the whole vibe. 🌈

---

🎀 SYNOPSIS 🎀

writer | seekablepipe tmpfile reader [args...]

---

🦋 DESCRIPTION 🦋

okay so here's the tea, bestie: seekablepipe takes writer's output and writes it to tmpfile, which gets unlinked as soon as it is created (the way that it just ✨vanishes✨ from the directory listing but the fd is still vibing, iconic). then it does an exec(3) into reader, reading from a file descriptor on tmpfile.

so like, your reader thinks it's reading a normal file it can seek around in, but lowkey it's a pipe's output. main character energy fr fr. 💅

---

👑 EXIT STATUS 👑

• 111 — temporary error. like, a "try again later" moment 😭
• 100 — permanent error, such as a misuse. that one's a you problem, ngl 💀
• 127 — unable to execute program — not found. it's giving "who? never heard of her" 🙈
• 126 — unable to execute program — other reason. the program exists but it's not cooperating 🍓

---

🌸 SEE ALSO 🌸

a whole friend group of s6 besties, all of them section 1, all of them slaying:

• 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-format-filter(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)

this man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/seekablepipe.html — go give the source some love 💖

---

🧚 AUTHORS 🧚

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

---

okay that's the whole page, no cap. 💜 this Debian-flavored edition of SEEKABLEPIPE(1) is dated January 15, 2023, and honestly? a classic. periodt. ⭐🎀