peekfd(1)

peekfd1

Peek at file descriptors of running processes

Usage

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

Overview

peekfd attaches to a running process and intercepts all reads and writes to file descriptors. You can specify the desired file descriptor numbers or dump all of them.

Options

-8

Do no post-processing on the bytes being read or written.

-n

Do not display headers indicating the source of the bytes dumped.

-c

Also dump the requested file descriptor activity in any new child processes that are created.

-d

Remove duplicate read/writes from the output. If you're looking at a tty with echo, you might want this.

-v

Display a version string.

-h

Display a help message.

Files

/proc/*/fd

Not used but useful for the user to look at to get good file descriptor numbers.

Environment

None.

Diagnostics

The following diagnostics may be issued on stderr:

Error attaching to pid <PID>

An unknown error occurred while attempted to attach to a process, you may need to be root.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0–7
  2. 8–10
  3. 11
  4. 12–Arch

Bugs

Probably lots. Don't be surprised if the process you are monitoring dies.

Author

Trent Waddington ⟨[email protected]⟩

From psmisc 23.7-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.