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

   1 .TH rwsnoop 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 rwsnoop \- snoop read/write events. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B rwsnoop
   6 [\-jPtvZ] [\-n name] [\-p PID]
   7 .SH DESCRIPTION
   8 This is measuring reads and writes at the application level. This
   9 matches the syscalls read, write, pread and pwrite.
  10
  11 Since this uses DTrace, only the root user or users with the
  12 dtrace_kernel privilege can run this command.
  13 .SH OS
  14 Solaris
  15 .SH STABILITY
  16 stable - needs the syscall provider.
  17 .SH OPTIONS
  18 .TP
  19 \-j
  20 print project ID
  21 .TP
  22 \-P
  23 print parent process ID
  24 .TP
  25 \-t
  26 print timestamp, us
  27 .TP
  28 \-v
  29 print time, string
  30 .TP
  31 \-Z
  32 print zone ID
  33 .TP
  34 \-n name
  35 process name to track
  36 .TP
  37 \-p PID
  38 PID to track
  39 .PP
  40 .SH EXAMPLES
  41 .TP
  42 Default output,
  43 #
  44 .B rwsnoop
  45 .TP
  46 Print zone ID,
  47 #
  48 .B rwsnoop
  49 -\Z
  50 .TP
  51 Monitor processes named "bash",
  52 #
  53 .B rwsnoop
  54 \-n bash
  55 .PP
  56 .SH FIELDS
  57 .TP
  58 TIME
  59 timestamp, us
  60 .TP
  61 TIMESTR
  62 time, string
  63 .TP
  64 ZONE
  65 zone ID
  66 .TP
  67 PROJ
  68 project ID
  69 .TP
  70 UID
  71 user ID
  72 .TP
  73 PID
  74 process ID
  75 .TP
  76 PPID
  77 parent process ID
  78 .TP
  79 CMD
  80 command name for the process
  81 .TP
  82 D
  83 direction, Read or Write
  84 .TP
  85 BYTES
  86 total bytes during sample
  87 .TP
  88 FILE
  89 filename, if file based.
  90 Reads and writes that are not file based, for example with sockets, will
  91 print "<unknown>" as the filename.
  92 .PP
  93 .SH DOCUMENTATION
  94 See the DTraceToolkit for further documentation under the
  95 Docs directory. The DTraceToolkit docs may include full worked
  96 examples with verbose descriptions explaining the output.
  97 .SH EXIT
  98 rwsnoop will run forever until Ctrl\-C is hit.
  99 .SH AUTHOR
 100 Brendan Gregg
 101 [Sydney, Australia]
 102 .SH SEE ALSO
 103 rwtop(1M), dtrace(1M)
 104