cddl/contrib/dtracetoolkit/Man/man1m/iofile.d.1m

   1 .TH iofile.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 iofile.d \- I/O wait time by file and process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B iofile.d
   6 .SH DESCRIPTION
   7 This prints the total I/O wait times for each filename by process.
   8 This can help determine why an application is performing poorly by
   9 identifying which file they are waiting on, and the total times.
  10 Both disk and NFS I/O are measured.
  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 io provider.
  18 .SH EXAMPLES
  19 .TP
  20 Sample until Ctrl\-C is hit then print report,
  21 #
  22 .B iofile.d
  23 .PP
  24 .SH FIELDS
  25 .TP
  26 PID
  27 process ID
  28 .TP
  29 CMD
  30 process name
  31 .TP
  32 TIME
  33 total wait time for disk events, us
  34 .TP
  35 FILE
  36 file pathname
  37 .PP
  38 .SH BASED ON
  39 /usr/demo/dtrace/iocpu.d
  40 .PP
  41 .SH DOCUMENTATION
  42 See the DTraceToolkit for further documentation under the
  43 Docs directory. The DTraceToolkit docs may include full worked
  44 examples with verbose descriptions explaining the output.
  45 .SH EXIT
  46 iofile.d will sample until Ctrl\-C is hit.
  47 .SH SEE ALSO
  48 iosnoop(1M), dtrace(1M)
  49