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

   1 .TH rwtop 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 rwtop \- display top read/write bytes process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B rwtop
   6 [\-Cc] [\-j|\-Z] [\-n name] [\-p PID]
   7 [\-t top] [interval [count]]
   8 .SH DESCRIPTION
   9 This is measuring reads and writes at the application level.
  10 This matches read and write system calls.
  11
  12 Since this uses DTrace, only the root user or users with the
  13 dtrace_kernel privilege can run this command.
  14 .SH OS
  15 Solaris
  16 .SH STABILITY
  17 stable - needs the sysinfo provider.
  18 .SH OPTIONS
  19 .TP
  20 \-C
  21 don't clear the screen
  22 .TP
  23 \-c
  24 print counts
  25 .TP
  26 \-j
  27 print project ID
  28 .TP
  29 \-Z
  30 print zone ID
  31 .TP
  32 \-n name
  33 process name to track
  34 .TP
  35 \-p PID
  36 PID to track
  37 .TP
  38 \-t top
  39 print top number only
  40 .PP
  41 .SH EXAMPLES
  42 .TP
  43 Default output, print summary every 5 seconds
  44 #
  45 .B rwtop
  46 .PP
  47 .TP
  48 One second samples,
  49 #
  50 .B rwtop
  51 1
  52 .TP
  53 Print top 10 lines only,
  54 #
  55 .B rwtop
  56 \-t 10
  57 .TP
  58 Monitor processes named "bash",
  59 #
  60 .B rwtop
  61 \-n bash
  62 .TP
  63 Print 12 x 5 second samples, scrolling,
  64 #
  65 .B rwtop
  66 \-C 5 12
  67 .PP
  68 .SH FIELDS
  69 .TP
  70 PROJ
  71 project ID
  72 .TP
  73 ZONE
  74 zone ID
  75 .TP
  76 UID
  77 user ID
  78 .TP
  79 PID
  80 process ID
  81 .TP
  82 PPID
  83 parent process ID
  84 .TP
  85 CMD
  86 command name for the process
  87 .TP
  88 D
  89 direction, Read or Write
  90 .TP
  91 BYTES
  92 total bytes during sample
  93 .TP
  94 load
  95 1 minute load average
  96 .TP
  97 app_r
  98 total read Kb for sample
  99 .TP
 100 app_w
 101 total write Kb for sample
 102 .PP
 103 .SH DOCUMENTATION
 104 See the DTraceToolkit for further documentation under the
 105 Docs directory. The DTraceToolkit docs may include full worked
 106 examples with verbose descriptions explaining the output.
 107 .SH EXIT
 108 rwtop will run forever until Ctrl\-C is hit, or the specified
 109 interval is reached.
 110 .SH AUTHOR
 111 Brendan Gregg
 112 [Sydney, Australia]
 113 .SH SEE ALSO
 114 iotop(1M), dtrace(1M)
 115