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

   1 .TH rfileio.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 rfileio.d \- read file I/O stats, with cache miss rate. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B rfileio.d
   6 .SH DESCRIPTION
   7 This script provides statistics on the number of reads and the bytes
   8 read from filesystems (logical), and the number of bytes read from
   9 disk (physical). A summary is printed every five seconds by file.
  10
  11 A total miss-rate is also provided for the file system cache.
  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 unstable - this script uses fbt provider probes which may change for
  19 future updates of the OS, invalidating this script. Please read
  20 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  21 .SH EXAMPLES
  22 .TP
  23 Print a summary of activity every five seconds.
  24 #
  25 .B rfileio.d
  26 .PP
  27 .SH IDEA
  28 Richard McDougall, Solaris Internals 2nd Ed, FS Chapter.
  29 .PP
  30 .SH DOCUMENTATION
  31 See the DTraceToolkit for further documentation under the
  32 Docs directory. The DTraceToolkit docs may include full worked
  33 examples with verbose descriptions explaining the output.
  34 .SH EXIT
  35 rfileio.d will run until Ctrl\-C is hit.
  36 .SH AUTHOR
  37 Brendan Gregg
  38 [Sydney, Australia]
  39 .SH SEE ALSO
  40 rfsio.d(1M), dtrace(1M)
  41