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 ...
              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 2020-08-13.  (At that time,
       the date of the most recent commit that was found in the repository
       was 2020-07-23.)  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)