iopending 1m "$Date:: 2007-08-05 #$" "USER COMMANDS"
NAME
iopending - plot number of pending disk events. Uses DTrace.
SYNOPSIS
iopending [-c] [-d device] [-f filename] [-m mount_point] [interval [count]]
DESCRIPTION
This samples the number of disk events that are pending and plots a
distribution graph. By doing this the
"serialness" or "parallelness" of disk behaviour can be distinguished.
A high occurance of a pending value of more than 1 is an indication of
saturation.
Since this uses DTrace, only the root user or users with the
dtrace_kernel privilege can run this command.
OS
Solaris
STABILITY
stable - needs the io provider.
OPTIONS
-c clear screen
-d device instance name to snoop (eg, dad0)
-f filename full pathname of file to snoop
-m mount_point mountpoint for filesystem to snoop
EXAMPLES
Default output, print I/O summary every 1 second, # iopending
Print 10 second samples, # iopending 10
Print 12 x 5 second samples, # iopending 5 12
Snoop events on the root filesystem only, # iopending -m /
FIELDS
value number of pending events, 0 == idle
count number of samples @ 1000 Hz
load 1 min load average
disk_r total disk read Kb for sample
disk_w total disk write Kb for sample
IDEA
Dr Rex di Bona
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.
EXIT
iopending will run forever until Ctrl-C is hit, or the
specified count is reached.
AUTHOR
Brendan Gregg
[Sydney, Australia]
SEE ALSO
iosnoop(1M), iotop(1M), dtrace(1M)