mirror of
https://github.com/Stichting-MINIX-Research-Foundation/netbsd.git
synced 2025-09-11 08:07:30 -04:00
89 lines
1.9 KiB
Plaintext
89 lines
1.9 KiB
Plaintext
.TH fspaging.d 1m "$Date: 2015/09/30 22:01:09 $" "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)
|