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

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 2017-11-25.  (At that time,
       the date of the most recent commit that was found in the repository
       was 2017-07-09.)  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                           2012-07-28                        PEEKFD(1)