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 ...
              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 2017-03-13.  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                           2012-07-28                        PEEKFD(1)