summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSami Kerola <kerolasa@iki.fi>2012-07-26 19:34:18 +0200
committerCraig Small <csmall@users.sourceforge.net>2012-07-28 18:41:52 +1000
commit8e193d8a7904b9e96d6dffc2a9f230cbb52142b6 (patch)
tree51415e12cb0fb96b011ee910358c88ffdab5ee89
parent4d96788456db947dc62b54727e0bcfda40391694 (diff)
docs: clean up peekfd.1
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
-rw-r--r--doc/peekfd.133
1 files changed, 19 insertions, 14 deletions
diff --git a/doc/peekfd.1 b/doc/peekfd.1
index 3ab6df2..d6d055e 100644
--- a/doc/peekfd.1
+++ b/doc/peekfd.1
@@ -1,7 +1,7 @@
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
-.TH PEEKFD 1 "APRIL 2007" Linux "User Commands"
+.TH PEEKFD 1 "July 2012" "psmisc" "User Commands"
.SH NAME
peekfd \- peek at file descriptors of running processes
.SH SYNOPSIS
@@ -18,18 +18,20 @@ peekfd \- peek at file descriptors of running processes
.B ...
.SH DESCRIPTION
.B 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.
+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.
.SH OPTIONS
.IP -8
Do no post-processing on the bytes being read or written.
.IP -n
Do not display headers indicating the source of the bytes dumped.
.IP -c
-Also dump the requested file descriptor activity in any new child processes that are created.
+Also dump the requested file descriptor activity in any new child
+processes that are created.
.IP -d
-Remove duplicate read/writes from the output. If you're looking at a tty with echo, you might want this.
+Remove duplicate read/writes from the output. If you're looking at a
+tty with echo, you might want this.
.IP -v
Display a version string.
.IP -h
@@ -37,19 +39,22 @@ Display a help message.
.SH FILES
.I /proc/*/fd
.RS
-Not used but useful for the user to look at to get good file descriptor numbers.
+Not used but useful for the user to look at to get good file descriptor
+numbers.
.SH ENVIRONMENT
None.
.SH DIAGNOSTICS
The following diagnostics may be issued on stderr:
-
-.B
-Error attaching to pid ...
-.RS
-An unknown error occurred while attempted to attach to a process.. you may need to be root.
+.TP
+.B Error attaching to pid ...
+An unknown error occurred while attempted to attach to a process.. you
+may need to be root.
.SH BUGS
-Probably lots. Don't be surprised if the process you are monitoring dies.
+Probably lots. Don't be surprised if the process you are monitoring
+dies.
.SH AUTHOR
-Trent Waddington <trent.waddington@gmail.com>
+.MT trent.waddington@gmail.com
+Trent Waddington
+.ME
.SH "SEE ALSO"
.BR ttysnoop (8)