PEE(1)

💖 pee(1) — like, the manual page, bestie 💖

okay so you opened the manual for pee (that's section 1 of the manual, the user commands girlies 🌸) and honestly? she's a baddie. tiny page, huge main character energy. let's get into it ✨

---

🌈 NAME 🌈

pee — she tees standard input to pipes. that's the whole vibe. that's her job. 💅

---

✨ SYNOPSIS ✨

pee [--[no-]ignore-sigpipe] [--[no-]ignore-write-errors]
    [["command"...]]

like yes, the double brackets are real, no I will not be explaining why, that's just how she is 🫶

---

🦋 DESCRIPTION 🦋

okay so picture tee, right? iconic, love her. now imagine tee but she's built for pipes. that's pee. 🎀

every single command you hand her gets run, and each one gets fed a copy of standard input. then the output of all of those commands gets sent to stdout. everybody eats, nobody goes hungry. 🍓

⚠️ but wait — plot twist — and this is the part people always miss: even though she's similar to tee, a copy of the input is NOT sent to stdout. tee does that. pee does not. that's the difference, bestie, that's the whole thing.

so if you do want that copy of the input going to stdout too? just say:

pee cat ...

and now you've got it. cat is the plug. 😌

---

💅 OPTIONS 💅

• --ignore-sigpipe, --no-ignore-sigpipe — do (not) ignore SIGPIPE. any command that pee starts up might cause a SIGPIPE when it exits. and listen — if you're gonna ignore SIGPIPE, you probably also wanna ignore write errors (peep the next one ⬇️). and just so you know, ignoring SIGPIPE is the default behaviour. she comes pre-set that way, periodt. 🔥
• --ignore-write-errors, --no-ignore-write-errors — do (not) ignore write errors. here's the tea: when a command that pee started stops accepting data through the pipe between itself and pee, a write error happens inside pee. if that error is not ignored, pee is going to terminate all the child processes and exit. like, everybody out of the pool. 😭 and yeah — ignoring write errors is the default behaviour. once again, chill by default. 🧚

---

👑 SEE ALSO 👑

• tee(1)
• pipe(7)

go read those too, they're part of the friend group 🫶

---

🌸 AUTHOR 🌸

Miek Gieben — thank you for your service, king 💜

---

and that's the whole page, bestie!! this lil beauty ships with moreutils and this particular version is dated 2016-12-20 ✨ go pipe something into three commands at once and feel powerful, you've earned it 🎀💖🦋