peekfd(1) — Linux manual page


PEEKFD(1)                     User Commands                    PEEKFD(1)

NAME         top

       peekfd - peek at file descriptors of running processes

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

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

       -n     Do not display headers indicating the source of the bytes

       -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         top

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

ENVIRONMENT         top


DIAGNOSTICS         top

       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.

BUGS         top

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

AUTHOR         top

       Trent Waddington ⟨⟩

SEE ALSO         top


COLOPHON         top

       This page is part of the psmisc (Small utilities that use the
       /proc filesystem) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨⟩ on 2021-08-27.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2021-06-21.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

psmisc                         2020-09-09                      PEEKFD(1)