readbytes.d.1m   [plain text]


.TH readbytes.d 1m  "May 15, 2005" "version 1.00" "USER COMMANDS"
.SH NAME
readbytes.d \- read bytes by process name. Uses DTrace.
.SH SYNOPSIS
.B readbytes.d
.SH DESCRIPTION
readbytes.d is a DTrace OneLiner to a report of the number of 
bytes read by process name.

Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
to run.

Since this uses DTrace, only the root user or users with the
dtrace_kernel privilege can run this command.
.SH EXAMPLES
.TP
This samples until Ctrl\-C is hit.
# 
.B readbytes.d
.PP
.SH FIELDS
.TP
first field
This is the process name. There may be several PIDs that have the 
same process name, for example with numerous instances of "bash". The
value reported will be the sum of them all.
.TP
second field
This is the number of bytes read.
.PP
.SH DOCUMENTATION
See the DTraceToolkit for further documentation under the 
Docs directory. The DTraceToolkit docs may include full worked
examples with verbose descriptions explaining the output.
.SH EXIT
readbytes.d will sample until Ctrl\-C is hit.
.SH AUTHOR
Brendan Gregg
[Sydney, Australia]
.SH SEE ALSO
dtrace(1M), truss(1)