.TH fspaging.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
.SH NAME
fspaging.d \- file system read/write and paging tracing. Uses DTrace.
.SH SYNOPSIS
.B fspaging.d
.SH DESCRIPTION
This traces file related activity: system call reads and writes,
vnode logical read and writes (fop), vnode putpage and getpage activity,
and disk I/O. It can be used to examine the behaviour of each I/O
layer, from the syscall interface to what the disk is doing. Behaviour
such as read-ahead, and max I/O size breakup can be observed.

This is a verbose version of fsrw.d, as this also traces paging activity.

Since this uses DTrace, only the root user or users with the
dtrace_kernel privilege can run this command.
.SH OS
Solaris
.SH STABILITY
unstable - this script uses fbt provider probes which may change for
future updates of the OS, invalidating this script. Please read
Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
.SH EXAMPLES
.TP
Trace file system read/write/paging events,
# 
.B fspaging.d
.PP
.SH FIELDS
.TP
Event
traced event (see EVENTS below)
.TP
Device
device, for disk I/O
.TP
RW
either Read or Write
.TP
Size
size of I/O in bytes
.TP
Offset
offset of I/O in kilobytes
.TP
Path
path to file on disk
.PP
.SH EVENTS
.TP
sc-read
system call read
.TP
sc-write
system call write
.TP
fop_read
logical read
.TP
fop_write
logical write
.TP
fop_getpage
logical get page
.TP
fop_putpage
logical put page
.TP
disk_io
physical disk I/O
.TP
disk_ra
physical disk I/O, read ahead
.PP
.SH IDEA
Richard McDougall, Solaris Internals 2nd Ed, FS Chapter.
.PP
.SH DOCUMENTATION
See the DTraceToolkit for further documentation under the 
Docs directory. The DTraceToolkit docs may include full worked
examples with verbose descriptions explaining the output.
.SH EXIT
fspaging.d will trace until Ctrl\-C is hit. 
.SH AUTHOR
Brendan Gregg
[Sydney, Australia]
.SH SEE ALSO
fsrw.d(1M), dtrace(1M)