cddl/contrib/dtracetoolkit/Man/man1m/iopending.1m

   1 .TH iopending 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 iopending \- plot number of pending disk events. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B iopending
   6 [\-c] [\-d device] [\-f filename] [\-m mount_point] [interval [count]]
   7 .SH DESCRIPTION
   8 This samples the number of disk events that are pending and plots a
   9 distribution graph. By doing this the
  10 "serialness" or "parallelness" of disk behaviour can be distinguished.
  11 A high occurance of a pending value of more than 1 is an indication of
  12 saturation.
  13
  14 Since this uses DTrace, only the root user or users with the
  15 dtrace_kernel privilege can run this command.
  16 .SH OS
  17 Solaris
  18 .SH STABILITY
  19 stable - needs the io provider.
  20 .SH OPTIONS
  21 .TP
  22 \-c
  23 clear screen
  24 .TP
  25 \-d device
  26 instance name to snoop (eg, dad0)
  27 .TP
  28 \-f filename
  29 full pathname of file to snoop
  30 .TP
  31 \-m mount_point
  32 mountpoint for filesystem to snoop
  33 .SH EXAMPLES
  34 .TP
  35 Default output, print I/O summary every 1 second,
  36 #
  37 .B iopending
  38 .PP
  39 .TP
  40 Print 10 second samples,
  41 #
  42 .B iopending
  43 10
  44 .PP
  45 .TP
  46 Print 12 x 5 second samples,
  47 #
  48 .B iopending
  49 5 12
  50 .PP
  51 .TP
  52 Snoop events on the root filesystem only,
  53 #
  54 .B iopending
  55 \-m /
  56 .PP
  57 .SH FIELDS
  58 .TP
  59 value
  60 number of pending events, 0 == idle
  61 .TP
  62 count
  63 number of samples @ 1000 Hz
  64 .TP
  65 load
  66 1 min load average
  67 .TP
  68 disk_r
  69 total disk read Kb for sample
  70 .TP
  71 disk_w
  72 total disk write Kb for sample
  73 .PP
  74 .SH IDEA
  75 Dr Rex di Bona
  76 .PP
  77 .SH DOCUMENTATION
  78 See the DTraceToolkit for further documentation under the
  79 Docs directory. The DTraceToolkit docs may include full worked
  80 examples with verbose descriptions explaining the output.
  81 .SH EXIT
  82 iopending will run forever until Ctrl\-C is hit, or the
  83 specified count is reached.
  84 .SH AUTHOR
  85 Brendan Gregg
  86 [Sydney, Australia]
  87 .SH SEE ALSO
  88 iosnoop(1M), iotop(1M), dtrace(1M)
  89