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

   1 .TH fsrw.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 fsrw.d \- file system read/write event tracing. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B fsrw.d
   6 .SH DESCRIPTION
   7 This traces file related activity: system call reads and writes,
   8 vnode logical read and writes (fop), and disk I/O. It can be used
   9 to examine the behaviour of each I/O layer, from the syscall
  10 interface to what the disk is doing. Behaviour such as read-ahead, and
  11 max I/O size breakup can be observed.
  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 Trace file system read/write events,
  24 #
  25 .B fsrw.d
  26 .PP
  27 .SH FIELDS
  28 .TP
  29 Event
  30 traced event (see EVENTS below)
  31 .TP
  32 Device
  33 device, for disk I/O
  34 .TP
  35 RW
  36 either Read or Write
  37 .TP
  38 Size
  39 size of I/O in bytes
  40 .TP
  41 Offset
  42 offset of I/O in kilobytes
  43 .TP
  44 Path
  45 path to file on disk
  46 .PP
  47 .SH EVENTS
  48 .TP
  49 sc-read
  50 system call read
  51 .TP
  52 sc-write
  53 system call write
  54 .TP
  55 fop_read
  56 logical read
  57 .TP
  58 fop_write
  59 logical write
  60 .TP
  61 disk_io
  62 physical disk I/O
  63 .TP
  64 disk_ra
  65 physical disk I/O, read ahead
  66 .PP
  67 .SH IDEA
  68 Richard McDougall, Solaris Internals 2nd Ed, FS Chapter.
  69 .PP
  70 .SH DOCUMENTATION
  71 See the DTraceToolkit for further documentation under the
  72 Docs directory. The DTraceToolkit docs may include full worked
  73 examples with verbose descriptions explaining the output.
  74 .SH EXIT
  75 fsrw.d will trace until Ctrl\-C is hit.
  76 .SH AUTHOR
  77 Brendan Gregg
  78 [Sydney, Australia]
  79 .SH SEE ALSO
  80 fspaging.d(1M), dtrace(1M)