1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  *
26  * This D script is used as an example in the Solaris Dynamic Tracing Guide
27  * wiki in the "Structs and Unions" Chapter.
28  *
29  * The full text of the this chapter may be found here:
30  *
31  *   http://wikis.sun.com/display/DTrace/Structs+and+Unions
32  *
33  * On machines that have DTrace installed, this script is available as
34  * ksyms.d in /usr/demo/dtrace, a directory that contains all D scripts
35  * used in the Solaris Dynamic Tracing Guide.  A table of the scripts and their
36  * corresponding chapters may be found here:
37  *
38  *   file:///usr/demo/dtrace/index.html
39  */
40 
41 /*
42  * When our strings(1) invocation starts a read(2), set a watched flag on
43  * the current thread.  When the read(2) finishes, clear the watched flag.
44  */
45 syscall::read:entry
46 /curpsinfo->pr_psargs == "strings -a /dev/ksyms"/
47 {
48 	printf("read %u bytes to user address %x\n", arg2, arg1);
49 	self->watched = 1;
50 }
51 
52 syscall::read:return
53 /self->watched/
54 {
55 	self->watched = 0;
56 }
57 
58 /*
59  * Instrument uiomove(9F).  The prototype for this function is as follows:
60  * int uiomove(caddr_t addr, size_t nbytes, enum uio_rw rwflag, uio_t *uio);
61  */
62 fbt::uiomove:entry
63 /self->watched/
64 {
65 	this->iov = args[3]->uio_iov;
66 
67 	printf("uiomove %u bytes to %p in pid %d\n",
68 	    this->iov->iov_len, this->iov->iov_base, pid);
69 }
70