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

   1 .TH seeksize.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 seeksize.d \- print disk event seek report. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B seeksize.d
   6 .SH DESCRIPTION
   7 seeksize.d is a simple DTrace program to print a report of disk
   8 event seeks by process.
   9
  10 This can be used to identify whether processes are accessing the
  11 disks in a "random" or "sequential" manner. Sequential is often
  12 desirable, indicated by mostly zero length seeks.
  13
  14 Since this uses DTrace, only the root user or users with the
  15 dtrace_kernel privilege can run this command.
  16 .SH OS
  17 Solaris
  18 .SH STABILITY
  19 stable - needs the io provider.
  20 .SH EXAMPLES
  21 .TP
  22 Sample until Ctrl\-C is hit then print report,
  23 #
  24 .B seeksize.d
  25 .PP
  26 .SH FIELDS
  27 .TP
  28 PID
  29 process ID
  30 .TP
  31 CMD
  32 command and argument list
  33 .TP
  34 value
  35 distance in disk blocks (sectors)
  36 .TP
  37 count
  38 number of I/O operations
  39 .PP
  40 .SH DOCUMENTATION
  41 See the DTraceToolkit for further documentation under the
  42 Docs directory. The DTraceToolkit docs may include full worked
  43 examples with verbose descriptions explaining the output.
  44 .SH EXIT
  45 seeksize.d will sample until Ctrl\-C is hit.
  46 .SH AUTHOR
  47 Brendan Gregg
  48 [Sydney, Australia]
  49 .SH SEE ALSO
  50 iosnoop(1M), bitesize.d(1M), dtrace(1M)
  51