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

   1 .TH fspaging.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 fspaging.d \- file system read/write and paging tracing. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B fspaging.d
   6 .SH DESCRIPTION
   7 This traces file related activity: system call reads and writes,
   8 vnode logical read and writes (fop), vnode putpage and getpage activity,
   9 and disk I/O. It can be used to examine the behaviour of each I/O
  10 layer, from the syscall interface to what the disk is doing. Behaviour
  11 such as read-ahead, and max I/O size breakup can be observed.
  12
  13 This is a verbose version of fsrw.d, as this also traces paging activity.
  14
  15 Since this uses DTrace, only the root user or users with the
  16 dtrace_kernel privilege can run this command.
  17 .SH OS
  18 Solaris
  19 .SH STABILITY
  20 unstable - this script uses fbt provider probes which may change for
  21 future updates of the OS, invalidating this script. Please read
  22 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  23 .SH EXAMPLES
  24 .TP
  25 Trace file system read/write/paging events,
  26 #
  27 .B fspaging.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 Event
  32 traced event (see EVENTS below)
  33 .TP
  34 Device
  35 device, for disk I/O
  36 .TP
  37 RW
  38 either Read or Write
  39 .TP
  40 Size
  41 size of I/O in bytes
  42 .TP
  43 Offset
  44 offset of I/O in kilobytes
  45 .TP
  46 Path
  47 path to file on disk
  48 .PP
  49 .SH EVENTS
  50 .TP
  51 sc-read
  52 system call read
  53 .TP
  54 sc-write
  55 system call write
  56 .TP
  57 fop_read
  58 logical read
  59 .TP
  60 fop_write
  61 logical write
  62 .TP
  63 fop_getpage
  64 logical get page
  65 .TP
  66 fop_putpage
  67 logical put page
  68 .TP
  69 disk_io
  70 physical disk I/O
  71 .TP
  72 disk_ra
  73 physical disk I/O, read ahead
  74 .PP
  75 .SH IDEA
  76 Richard McDougall, Solaris Internals 2nd Ed, FS Chapter.
  77 .PP
  78 .SH DOCUMENTATION
  79 See the DTraceToolkit for further documentation under the
  80 Docs directory. The DTraceToolkit docs may include full worked
  81 examples with verbose descriptions explaining the output.
  82 .SH EXIT
  83 fspaging.d will trace until Ctrl\-C is hit.
  84 .SH AUTHOR
  85 Brendan Gregg
  86 [Sydney, Australia]
  87 .SH SEE ALSO
  88 fsrw.d(1M), dtrace(1M)