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

   1 .TH bitesize.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 bitesize.d \- analyse disk I/O size by process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B bitesize.d
   6 .SH DESCRIPTION
   7 This produces a report for the size of disk events caused by
   8 processes. These are the disk events sent by the block I/O driver.
   9
  10 If applications must use the disks, we generally prefer they do so
  11 sequentially with large I/O sizes, or larger "bites".
  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 bitesize.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 PID
  28 process ID
  29 .TP
  30 CMD
  31 command and argument list
  32 .TP
  33 value
  34 size in bytes
  35 .TP
  36 count
  37 number of I/O operations
  38 .PP
  39 .SH NOTES
  40 The application may be requesting smaller sized operations, which
  41 are being rounded up to the nearest sector size or UFS block size.
  42
  43 To analyse what the application is requesting, DTraceToolkit programs
  44 such as Proc/fddist may help.
  45 .PP
  46 .SH DOCUMENTATION
  47 See the DTraceToolkit for further documentation under the
  48 Docs directory. The DTraceToolkit docs may include full worked
  49 examples with verbose descriptions explaining the output.
  50 .SH EXIT
  51 bitesize.d will sample until Ctrl\-C is hit.
  52 .SH AUTHOR
  53 Brendan Gregg
  54 [Sydney, Australia]
  55 .SH SEE ALSO
  56 iosnoop(1M), seeksize(1M), dtrace(1M)
  57