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

   1 .TH iotop 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 iotop \- display top disk I/O events by process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B iotop
   6 [\-C] [\-D|\-o|\-P] [\-j|\-Z] [\-d device] [\-f filename]
   7 [\-m mount_point] [\-t top] [interval [count]]
   8 .SH DESCRIPTION
   9 iotop tracks disk I/O by process, and prints a summary report that
  10 is refreshed every interval.
  11
  12 This is measuring disk events that have made it past system caches.
  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 don't clear the screen
  24 .TP
  25 \-D
  26 print delta times - elapsed, us
  27 .TP
  28 \-j
  29 print project ID
  30 .TP
  31 \-o
  32 print disk delta times, us
  33 .TP
  34 \-P
  35 print %I/O (disk delta times)
  36 .TP
  37 \-Z
  38 print zone ID
  39 .TP
  40 \-d device
  41 instance name to snoop (eg, dad0)
  42 .TP
  43 \-f filename
  44 full pathname of file to snoop
  45 .TP
  46 \-m mount_point
  47 mountpoint for filesystem to snoop
  48 .TP
  49 \-t top
  50 print top number only
  51 .PP
  52 .SH EXAMPLES
  53 .TP
  54 Default output, print summary every 5 seconds
  55 #
  56 .B iotop
  57 .PP
  58 .TP
  59 One second samples,
  60 #
  61 .B iotop
  62 1
  63 .PP
  64 .TP
  65 print %I/O (time based),
  66 #
  67 .B iotop
  68 \-P
  69 .PP
  70 .TP
  71 Snoop events on the root filesystem only,
  72 #
  73 .B iotop
  74 \-m /
  75 .TP
  76 Print top 20 lines only,
  77 #
  78 .B iotop
  79 \-t 20
  80 .TP
  81 Print 12 x 5 second samples, scrolling,
  82 #
  83 .B iotop
  84 \-C 5 12
  85 .PP
  86 .SH FIELDS
  87 .TP
  88 UID
  89 user ID
  90 .TP
  91 PID
  92 process ID
  93 .TP
  94 PPID
  95 parent process ID
  96 .TP
  97 PROJ
  98 project ID
  99 .TP
 100 ZONE
 101 zone ID
 102 .TP
 103 CMD
 104 command name for the process
 105 .TP
 106 DEVICE
 107 device name
 108 .TP
 109 MAJ
 110 device major number
 111 .TP
 112 MIN
 113 device minor number
 114 .TP
 115 D
 116 direction, Read or Write
 117 .TP
 118 BYTES
 119 total size of operations, bytes
 120 .TP
 121 ELAPSED
 122 total elapsed times from request to completion, us (this is the elapsed
 123 time from the disk request (strategy) to the disk completion (iodone))
 124 .TP
 125 DISKTIME
 126 total times for disk to complete request, us (this is the time for the
 127 disk to complete that event since it's last event (time between iodones),
 128 or, the time to the strategy if the disk had been idle)
 129 .TP
 130 %I/O
 131 percent disk I/O, based on time (DISKTIME)
 132 .TP
 133 load
 134 1 minute load average
 135 .TP
 136 disk_r
 137 total disk read Kb for sample
 138 .TP
 139 disk_w
 140 total disk write Kb for sample
 141 .PP
 142 .SH DOCUMENTATION
 143 See the DTraceToolkit for further documentation under the
 144 Docs directory. The DTraceToolkit docs may include full worked
 145 examples with verbose descriptions explaining the output.
 146 .SH EXIT
 147 iotop will run forever until Ctrl\-C is hit, or the specified
 148 interval is reached.
 149 .SH AUTHOR
 150 Brendan Gregg
 151 [Sydney, Australia]
 152 .SH SEE ALSO
 153 iosnoop(1M), dtrace(1M)
 154