peekfd(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | ENVIRONMENT | DIAGNOSTICS | BUGS | AUTHOR | SEE ALSO | COLOPHON

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

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

ENVIRONMENT         top

       None.

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 ⟨trent.waddington@gmail.com⟩

SEE ALSO         top

       ttysnoop(8)

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 ⟨https://gitlab.com/psmisc/psmisc⟩.  If you have a bug
       report for this manual page, see
       ⟨https://gitlab.com/psmisc/psmisc/issues⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://gitlab.com/psmisc/psmisc.git⟩ 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
       man-pages@man7.org

psmisc                         2020-09-09                      PEEKFD(1)