PEEKFD(1)

✨ PEEKFD(1) — peekfd, the manual bestie 💖

okay so peekfd is the manual name for this one, and it's giving "peek at file descriptors of running processes" 👀🦋

✨ SYNOPSIS ✨

peekfd [-8,--eight-bit-clean] [-n,--no-headers] [-c,--follow]
[-d,--duplicates-removed] [-V,--version] [-h,--help] pid [fd] [fd] ...

🎀 DESCRIPTION 🎀

okay so peekfd slides right up to a running process and intercepts every single read and write going through its file descriptors 😭✨ You can name the exact fd numbers you care about, or just dump all of them. Main character energy, no cap 💅

💅 OPTIONS 💅

• -8 — bestie, this one means no post-processing on the bytes being read or written. Raw and unfiltered 🍓
• -n — skip the headers that show where the bytes came from. Less noise, more vibes 🌸
• -c — also dump the requested fd activity in any new child processes that spawn. It follows the drama everywhere 🧚
• -d — removes duplicate reads/writes from the output. Lowkey essential if you're staring at a tty with echo on 🙈
• -v — displays a version string ✨
• -h — displays a help message 🫶

🦋 FILES 🦋

• /proc/*/fd — not used by peekfd itself, but super useful for you to peek at so you can pick good fd numbers 👀

🌈 ENVIRONMENT 🌈

None. Zero env vars, zero drama 💜

🚨 DIAGNOSTICS 🚨

The following diagnostics may be issued on stderr:

• Error attaching to pid <PID> — an unknown error popped up while trying to attach to a process. You might need to be root, so go check 🙈

💀 BUGS 💀

Probably lots. Don't be surprised if the process you're monitoring dies on you 😭

👑 AUTHOR 👑

Trent Waddington, the icon who made this 🫶

🔗 SEE ALSO 🔗

• ttysnoop(8) — go check this one out next 🧚

bestie, that's the whole page 💖 Brought to you by psmisc, last updated 2021-12-01. Stay iconic, stay curious, and go peek at some file descriptors ✨💅