man-pages/man1/peekfd.1.html
2021-03-31 01:06:50 +01:00

128 lines
2.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PEEKFD</TITLE>
</HEAD><BODY>
<H1>PEEKFD</H1>
Section: User Commands (1)<BR>Updated: 2012-07-28<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
peekfd - peek at file descriptors of running processes
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>peekfd </B>
[<B>-8</B>,<B>--eight-bit-clean</B>]
[<B>-n</B>,<B>--no-headers</B>]
[<B>-f</B>,<B>--follow</B>]
[<B>-d</B>,<B>--duplicates-removed</B>]
[<B>-V</B>,<B>--version</B>]
[<B>-h</B>,<B>--help</B>]
<I>pid</I>
[<I>fd</I>]
[<I>fd</I>]
<B>...</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>peekfd</B>
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.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1">-8<DD>
Do no post-processing on the bytes being read or written.
<DT id="2">-n<DD>
Do not display headers indicating the source of the bytes dumped.
<DT id="3">-c<DD>
Also dump the requested file descriptor activity in any new child
processes that are created.
<DT id="4">-d<DD>
Remove duplicate read/writes from the output. If you're looking at a
tty with echo, you might want this.
<DT id="5">-v<DD>
Display a version string.
<DT id="6">-h<DD>
Display a help message.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<I>/proc/*/fd</I>
<DL COMPACT><DT id="7"><DD>
Not used but useful for the user to look at to get good file descriptor
numbers.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>ENVIRONMENT</H2>
None.
<A NAME="lbAH">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
The following diagnostics may be issued on stderr:
<DL COMPACT>
<DT id="8"><B>Error attaching to pid ...</B>
<DD>
An unknown error occurred while attempted to attach to a process.. you
may need to be root.
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>BUGS</H2>
Probably lots. Don't be surprised if the process you are monitoring
dies.
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
Trent Waddington
<A NAME="lbAK">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+ttysnoop">ttysnoop</A></B>(8)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAF">FILES</A><DD>
<DT id="14"><A HREF="#lbAG">ENVIRONMENT</A><DD>
<DT id="15"><A HREF="#lbAH">DIAGNOSTICS</A><DD>
<DT id="16"><A HREF="#lbAI">BUGS</A><DD>
<DT id="17"><A HREF="#lbAJ">AUTHOR</A><DD>
<DT id="18"><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:22 GMT, March 31, 2021
</BODY>
</HTML>