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

   1 .TH iopattern 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 iopattern \- print disk I/O pattern. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B iopattern
   6 [\-v] [\-d device] [\-f filename] [\-m mount_point] [interval [count]]
   7 .SH DESCRIPTION
   8 This prints details on the I/O access pattern for the disks, such as
   9 percentage of events that were of a random or sequential nature.
  10 By default totals for all disks are printed.
  11
  12 An event is considered random when the heads seek. This program prints
  13 the percentage of events that are random. The size of the seek is not
  14 measured - it's either random or not.
  15
  16 Since this uses DTrace, only the root user or users with the
  17 dtrace_kernel privilege can run this command.
  18 .SH OS
  19 Solaris
  20 .SH STABILITY
  21 stable - needs the io provider.
  22 .SH OPTIONS
  23 .TP
  24 \-v
  25 print timestamp, string
  26 .TP
  27 \-d device
  28 instance name to snoop (eg, dad0)
  29 .TP
  30 \-f filename
  31 full pathname of file to snoop
  32 .TP
  33 \-m mount_point
  34 mountpoint for filesystem to snoop
  35 .SH EXAMPLES
  36 .TP
  37 Default output, print I/O summary every 1 second,
  38 #
  39 .B iopattern
  40 .PP
  41 .TP
  42 Print 10 second samples,
  43 #
  44 .B iopattern
  45 10
  46 .PP
  47 .TP
  48 Print 12 x 5 second samples,
  49 #
  50 .B iopattern
  51 5 12
  52 .PP
  53 .TP
  54 Snoop events on the root filesystem only,
  55 #
  56 .B iopattern
  57 \-m /
  58 .PP
  59 .SH FIELDS
  60 .TP
  61 %RAN
  62 percentage of events of a random nature
  63 .TP
  64 %SEQ
  65 percentage of events of a sequential nature
  66 .TP
  67 COUNT
  68 number of I/O events
  69 .TP
  70 MIN
  71 minimum I/O event size
  72 .TP
  73 MAX
  74 maximum I/O event size
  75 .TP
  76 AVG
  77 average I/O event size
  78 .TP
  79 KR
  80 total kilobytes read during sample
  81 .TP
  82 KW
  83 total kilobytes written during sample
  84 .TP
  85 DEVICE
  86 device name
  87 .TP
  88 MOUNT
  89 mount point
  90 .TP
  91 FILE
  92 filename (basename) for I/O operation
  93 .TP
  94 TIME
  95 timestamp, string
  96 .PP
  97 .SH IDEA
  98 Ryan Matteson
  99 .PP
 100 .SH DOCUMENTATION
 101 See the DTraceToolkit for further documentation under the
 102 Docs directory. The DTraceToolkit docs may include full worked
 103 examples with verbose descriptions explaining the output.
 104 .SH EXIT
 105 iopattern will run forever until Ctrl\-C is hit, or the
 106 specified count is reached.
 107 .SH AUTHOR
 108 Brendan Gregg
 109 [Sydney, Australia]
 110 .SH SEE ALSO
 111 iosnoop(1M), iotop(1M), dtrace(1M)
 112