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

   1 .TH iofileb.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 iofileb.d \- I/O bytes by file and process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B iofileb.d
   6 .SH DESCRIPTION
   7 This prints a summary of requested disk activity by pathname,
   8 providing totals of the I/O events in bytes. It is a companion to the
   9 iofile.d script - which prints in terms of I/O wait time, not bytes.
  10 I/O wait time is a better metric for understanding performance issues.
  11 Both disk and NFS I/O are measured.
  12
  13 Since this uses DTrace, only the root user or users with the
  14 dtrace_kernel privilege can run this command.
  15 .SH OS
  16 Solaris
  17 .SH STABILITY
  18 stable - needs the io provider.
  19 .SH EXAMPLES
  20 .TP
  21 Sample until Ctrl\-C is hit then print report,
  22 #
  23 .B iofileb.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 PID
  28 process ID
  29 .TP
  30 CMD
  31 process name
  32 .TP
  33 KB
  34 kilobytes of disk I/O
  35 .TP
  36 FILE
  37 file pathname
  38 .PP
  39 .SH DOCUMENTATION
  40 See the DTraceToolkit for further documentation under the
  41 Docs directory. The DTraceToolkit docs may include full worked
  42 examples with verbose descriptions explaining the output.
  43 .SH EXIT
  44 iofileb.d will sample until Ctrl\-C is hit.
  45 .SH SEE ALSO
  46 iofile.d(1M), iosnoop(1M), dtrace(1M)