iotop(1m) USER COMMANDS iotop(1m)

NAME
       iotop - display top disk I/O events by process. Uses DTrace.

SYNOPSIS
       iioottoopp   [-C]   [-D|-o|-P]   [-j|-Z]   [-d  device]  [-f  filename]  [-m
       mountpoint] [-t top] [interval [count]]

DESCRIPTION
       iotop tracks disk I/O by process, and prints a summary report  that  is
       refreshed every interval.

       This is measuring disk events that have made it past system caches.

       Since  this  uses  DTrace,  only  the  root  user  or  users  with  the
       dtracekernel privilege can run this command.

OOPPTTIIOONNSS
       -C     don't clear the screen

       -D     print delta times - elapsed, us

       -j     print project ID

       -o     print disk delta times, us

       -P     print %I/O (disk delta times)

       -Z     print zone ID

       -d device
              instance name to snoop (eg, dad0)

       -f filename
              full pathname of file to snoop

       -m mountpoint
              mountpoint for filesystem to snoop

       -t top print top number only


EEXXAAMMPPLLEESS
       Default output, print summary every 5 seconds
              # iioottoopp


       One second samples,
              # iioottoopp 1


       print %I/O (time based),
              # iioottoopp -P


       Snoop events on the root filesystem only,
              # iioottoopp -m /

       Print top 20 lines only,
              # iioottoopp -t 20

       Print 12 x 5 second samples, scrolling,
              # iioottoopp -C 5 12


FFIIEELLDDSS
       UID    user ID

       PID    process ID

       PPID   parent process ID

       PROJ   project ID

       ZONE   zone ID

       CMD    command name for the process

       DEVICE device name

       MAJ    device major number

       MIN    device minor number

       D      direction, Read or Write

       BYTES  total size of operations, bytes

       ELAPSED
              total elapsed times from request to completion, us (this is  the
              elapsed  time  from the disk request (strategy) to the disk com-
              pletion (iodone))

       DISKTIME
              total times for disk to complete request, us (this is  the  time
              for  the disk to complete that event since it's last event (time
              between iodones), or, the time to the strategy if the  disk  had
              been idle)

       %I/O   percent disk I/O, based on time (DISKTIME)

       load   1 minute load average

       diskr total disk read Kb for sample

       diskw total disk write Kb for sample


DDOOCCUUMMEENNTTAATTIIOONN
       See  the  DTraceToolkit for further documentation under the Docs direc-
       tory. The DTraceToolkit docs may include full worked examples with ver-
       bose descriptions explaining the output.

EEXXIITT
       iotop  will  run forever until Ctrl-C is hit, or the specified interval
       is reached.

AUTHOR       Brendan Gregg [Sydney, Australia]

SEE ALSO
       iosnoop(1M), dtrace(1M)




version 0.75                     Oct 25, 2005                        iotop(1m)