xref: /illumos-gate/usr/src/cmd/dtrace/test/tst/common/dtraceUtil/man.TraceModule (revision 73b80b821da76082173547dd650e417f6916eb8b)
1*9512fe85Sahl/*
2*9512fe85Sahl * CDDL HEADER START
3*9512fe85Sahl *
4*9512fe85Sahl * The contents of this file are subject to the terms of the
5*9512fe85Sahl * Common Development and Distribution License (the "License").
6*9512fe85Sahl * You may not use this file except in compliance with the License.
7*9512fe85Sahl *
8*9512fe85Sahl * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*9512fe85Sahl * or http://www.opensolaris.org/os/licensing.
10*9512fe85Sahl * See the License for the specific language governing permissions
11*9512fe85Sahl * and limitations under the License.
12*9512fe85Sahl *
13*9512fe85Sahl * When distributing Covered Code, include this CDDL HEADER in each
14*9512fe85Sahl * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*9512fe85Sahl * If applicable, add the following below this CDDL HEADER, with the
16*9512fe85Sahl * fields enclosed by brackets "[]" replaced with your own identifying
17*9512fe85Sahl * information: Portions Copyright [yyyy] [name of copyright owner]
18*9512fe85Sahl *
19*9512fe85Sahl * CDDL HEADER END
20*9512fe85Sahl */
21*9512fe85Sahl
22*9512fe85Sahl/*
23*9512fe85Sahl * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
24*9512fe85Sahl * Use is subject to license terms.
25*9512fe85Sahl */
26*9512fe85Sahl
27*9512fe85Sahl/*
28*9512fe85Sahl * ASSERTION:
29*9512fe85Sahl * Tracing a module using the -m option.
30*9512fe85Sahl *
31*9512fe85Sahl * SECTION: dtrace Utility/-m Option
32*9512fe85Sahl *
33*9512fe85Sahl * NOTES: Manually check:
34*9512fe85Sahl *
35*9512fe85Sahl * 1) automated in tst.InvalidTraceModule1.d.ksh
36*9512fe85Sahl * /usr/sbin/dtrace -m profile
37*9512fe85Sahl * RESULT: invalid probe specifier
38*9512fe85Sahl *
39*9512fe85Sahl * 2)
40*9512fe85Sahl * /usr/sbin/dtrace -m genunix
41*9512fe85Sahl * RESULT: trace of all probes with module genunix.
42*9512fe85Sahl *
43*9512fe85Sahl * 3)
44*9512fe85Sahl * /usr/sbin/dtrace -m vtrace:genunix
45*9512fe85Sahl * RESULT: trace of probes with provider vtrace and module genunix.
46*9512fe85Sahl *
47*9512fe85Sahl * 4) automated in tst.InvalidTraceModule2.d.ksh
48*9512fe85Sahl * /usr/sbin/dtrace -m :genunix::
49*9512fe85Sahl * RESULT: invalid probe specifier
50*9512fe85Sahl *
51*9512fe85Sahl * 5)
52*9512fe85Sahl * /usr/sbin/dtrace -m :genunix
53*9512fe85Sahl * RESULT: trace of all probes with module genunix.
54*9512fe85Sahl *
55*9512fe85Sahl * 6) automated in tst.InvalidTraceModule3.d.ksh
56*9512fe85Sahl * /usr/sbin/dtrace -m genunix::
57*9512fe85Sahl * RESULT: invalid probe specifier
58*9512fe85Sahl *
59*9512fe85Sahl * 7) automated in tst.InvalidTraceModule4.d.ksh
60*9512fe85Sahl * /usr/sbin/dtrace -m profile:::profile-97
61*9512fe85Sahl * RESULT: not a valid probe description.
62*9512fe85Sahl *
63*9512fe85Sahl * 8)
64*9512fe85Sahl * /usr/sbin/dtrace -m genunix -m unix
65*9512fe85Sahl * RESULT: tracing of both genunix and unix probes.
66*9512fe85Sahl *
67*9512fe85Sahl * 9)
68*9512fe85Sahl * /usr/sbin/dtrace -m genunix -m foounix
69*9512fe85Sahl * RESULT: Number of probes matching the description genunix
70*9512fe85Sahl * and an invalid probe specifier for foounix.
71*9512fe85Sahl *
72*9512fe85Sahl * 10) automated in tst.InvalidTraceModule5.d.ksh
73*9512fe85Sahl * /usr/sbin/dtrace -m foounix -m unix
74*9512fe85Sahl * RESULT: invalid probe specifier for foounix.
75*9512fe85Sahl *
76*9512fe85Sahl * 11) automated in tst.InvalidTraceModule6.d.ksh
77*9512fe85Sahl * /usr/sbin/dtrace -m fbt:des:des3_crunch_block:return
78*9512fe85Sahl * RESULT: invalid probe description.
79*9512fe85Sahl *
80*9512fe85Sahl * 12)
81*9512fe85Sahl * /usr/sbin/dtrace -m fbt:genunix'{printf("FOUND");}'
82*9512fe85Sahl * RESULT: tracing of all the probes matching provider fbt and module
83*9512fe85Sahl * genunix.
84*9512fe85Sahl *
85*9512fe85Sahl * 13)
86*9512fe85Sahl * /usr/sbin/dtrace -m genunix'{printf("FOUND");}'
87*9512fe85Sahl * RESULT: tracing of all the probes matching module genunix with
88*9512fe85Sahl * message FOUND
89*9512fe85Sahl *
90*9512fe85Sahl * 14)
91*9512fe85Sahl * /usr/sbin/dtrace -m :genunix'{printf("FOUND");}'
92*9512fe85Sahl * RESULT: tracing of all the probes matching module genunix with
93*9512fe85Sahl * message FOUND
94*9512fe85Sahl *
95*9512fe85Sahl * 15) automated in tst.InvalidTraceModule7.d.ksh
96*9512fe85Sahl * /usr/sbin/dtrace -m genunix::'{printf("FOUND");}'
97*9512fe85Sahl * RESULT: invalid probe specifier.
98*9512fe85Sahl *
99*9512fe85Sahl * 16) automated in tst.InvalidTraceModule8.d.ksh
100*9512fe85Sahl * /usr/sbin/dtrace -m genunix:'{printf("FOUND");}'
101*9512fe85Sahl * RESULT: invalid probe specifier.
102*9512fe85Sahl *
103*9512fe85Sahl * 17)
104*9512fe85Sahl * /usr/sbin/dtrace -m unix '{printf("FOUND");}'
105*9512fe85Sahl * RESULT: invalid probe specifier.
106*9512fe85Sahl *
107*9512fe85Sahl * 18)
108*9512fe85Sahl * /usr/sbin/dtrace -m
109*9512fe85Sahl * unix'/probefunc == "preempt"/{printf("FOUND");}'
110*9512fe85Sahl * RESULT: tracing of all the probes matching module genunix,
111*9512fe85Sahl * probe function preempt with message FOUND.
112*9512fe85Sahl */
113