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

   1 .TH diskhits 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 diskhits \- disk access by file offset. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B diskhits pathname
   6 .SH DESCRIPTION
   7 This prints how a file was accessed, the locations on a distribution plot.
   8 This is for the cache misses only - the file activity that resulted in
   9 disk events.
  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 io provider.
  17 .SH EXAMPLES
  18 .TP
  19 Sample /var/adm/messages disk activity,
  20 #
  21 .B diskhits /var/adm/messages
  22 .PP
  23 .SH FIELDS
  24 .TP
  25 Location (KB)
  26 the file offset of the disk activity, Kbytes
  27 .TP
  28 Size (KB)
  29 size of the disk activity, Kbytes
  30 .TP
  31 Total RW
  32 Total disk activity, reads + writes
  33 .PP
  34 .SH BASED ON
  35 /usr/demo/dtrace/applicat.d
  36 .PP
  37 .SH DOCUMENTATION
  38 DTrace Guide "io Provider" chapter (docs.sun.com)
  39
  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 diskhits will sample until Ctrl\-C is hit.
  45 .SH SEE ALSO
  46 dtrace(1M)