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