3 * fspaging.d - file system read/write and paging tracing.
4 * Written using DTrace (Solaris 10 3/05)
6 * This traces file related activity: system call reads and writes,
7 * vnode logical read and writes (fop), vnode putpage and getpage activity,
8 * and disk I/O. It can be used to examine the behaviour of each I/O
9 * layer, from the syscall interface to what the disk is doing. Behaviour
10 * such as read-ahead, and max I/O size breakup can be observed.
12 * This is a verbose version of fsrw.d, as this also traces paging activity.
14 * $Id: fspaging.d 3 2007-08-01 10:50:08Z brendan $
19 * Event Traced event (see EVENTS below)
20 * Device Device, for disk I/O
21 * RW Either Read or Write
22 * Size Size of I/O in bytes, if known
23 * Offset Offset of I/O in kilobytes, if known
24 * Path Path to file on disk
27 * sc-read System call read
28 * sc-write System call write
29 * fop_read Logical read
30 * fop_write Logical write
31 * fop_getpage Logical get page
32 * fop_putpage Logical put page
33 * disk_io Physical disk I/O
34 * disk_ra Physical disk I/O, read ahead
36 * The events are drawn with a level of indentation, which can sometimes
37 * help identify related events.
41 * IDEA: Richard McDougall, Solaris Internals 2nd Ed, FS Chapter.
43 * COPYRIGHT: Copyright (c) 2006 Brendan Gregg.
47 * The contents of this file are subject to the terms of the
48 * Common Development and Distribution License, Version 1.0 only
49 * (the "License"). You may not use this file except in compliance
52 * You can obtain a copy of the license at Docs/cddl1.txt
53 * or http://www.opensolaris.org/os/licensing.
54 * See the License for the specific language governing permissions
55 * and limitations under the License.
61 * 20-Mar-2006 Brendan Gregg Created this.
62 * 23-Apr-2006 " " Last update.
65 #pragma D option quiet
66 #pragma D option switchrate=10hz
70 printf("%-13s %10s %2s %8s %6s %s\n",
71 "Event", "Device", "RW", "Size", "Offset", "Path");
75 syscall::*write*:entry
78 * starting with a file descriptior, dig out useful info
79 * from the corresponding file_t and vnode_t.
81 this->filistp = curthread->t_procp->p_user.u_finfo.fi_list;
82 this->ufentryp = (uf_entry_t *)((uint64_t)this->filistp +
83 (uint64_t)arg0 * (uint64_t)sizeof (uf_entry_t));
84 this->filep = this->ufentryp->uf_file;
85 self->offset = this->filep->f_offset;
86 this->vnodep = this->filep != 0 ? this->filep->f_vnode : 0;
87 self->vpath = this->vnodep ? (this->vnodep->v_path != 0 ?
88 cleanpath(this->vnodep->v_path) : "<unknown>") : "<unknown>";
89 self->sc_trace = this->vnodep ? this->vnodep->v_type == 1 ||
90 this->vnodep->v_type == 2 ? 1 : 0 : 0;
96 printf("sc-%-10s %10s %2s %8d %6d %s\n", probefunc, ".", "R",
97 (int)arg2, self->offset / 1024, self->vpath);
100 syscall::*write*:entry
103 printf("sc-%-10s %10s %2s %8d %6d %s\n", probefunc, ".", "W",
104 (int)arg2, self->offset / 1024, self->vpath);
107 syscall::*read:return,
108 syscall::*write*:return
115 fbt::fop_putpage:entry,
116 fbt::fop_getpage:entry
117 /self->sc_trace && args[0]->v_path/
119 printf(" %-11s %10s %2s %8d %6d %s\n", probefunc, ".",
120 probefunc == "fop_getpage" ? "R" : "W", (uint64_t)arg2,
121 args[1] / 1024, cleanpath(args[0]->v_path));
127 /self->sc_trace && args[0]->v_path/
129 printf(" %-11s %10s %2s %8d %6d %s\n", probefunc, ".",
130 probefunc == "fop_read" ? "R" : "W", args[1]->uio_resid,
131 args[1]->_uio_offset._f / 1024, cleanpath(args[0]->v_path));
134 fbt:ufs:ufs_getpage_ra:entry
136 /* fetch the real offset (file_t is unaware of this) */
137 self->offset = ((inode_t *)args[0]->v_data)->i_nextrio;
138 self->read_ahead = 1;
141 fbt:ufs:ufs_getpage_ra:return
143 self->read_ahead = 0;
147 io::bdev_strategy:start
149 this->offset = self->read_ahead ? self->offset : args[2]->fi_offset;
150 printf(" %-9s %10s %2s %8d %6d %s\n",
151 self->read_ahead ? "disk_ra" : "disk_io", args[1]->dev_statname,
152 args[0]->b_flags & B_READ ? "R" : "W", args[0]->b_bcount,
153 this->offset / 1024, args[2]->fi_pathname);