xref: /illumos-gate/usr/src/cmd/dtrace/test/tst/common/dtraceUtil/man.TraceFunctions (revision bea83d026ee1bd1b2a2419e1d0232f107a5d7d9b)
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#pragma ident	"%Z%%M%	%I%	%E% SMI"
28
29/*
30 * ASSERTION:
31 * Using -f option.
32 *
33 * SECTION: dtrace Utility/-f Option
34 *
35 * NOTES: Manually check:
36 *
37 * 1) automated in tst.InvalidTraceFunc1.d.ksh
38 * /usr/sbin/dtrace -f profile
39 * RESULT: invalid probe specifier
40 *
41 * 2) automated in tst.InvalidTraceFunc2.d.ksh
42 * /usr/sbin/dtrace -f genunix
43 * RESULT: invalid probe specifier
44 *
45 * 3)
46 * /usr/sbin/dtrace -f read
47 * RESULT: tracing of matching list of probes with function read.
48 *
49 * 4) automated in tst.InvalidTraceFunc3.d.ksh
50 * /usr/sbin/dtrace -f read:
51 * RESULT: invalid probe specifier
52 *
53 * 5)
54 * /usr/sbin/dtrace -f ::read
55 * RESULT: tracing of matching list of probes with function read.
56 *
57 * 6) automated in tst.InvalidTraceFunc4.d.ksh
58 * /usr/sbin/dtrace -f ::read:
59 * RESULT: invalid probe specifier
60 *
61 * 7)
62 * /usr/sbin/dtrace -f genunix:read
63 * RESULT: tracing of probes with module genunix and function read.
64 *
65 * 8)
66 * /usr/sbin/dtrace -f sysinfo:genunix:read
67 * RESULT: tracing of probes with provider sysinfo, module genunix
68 * and function read.
69 *
70 * 9)
71 * /usr/sbin/dtrace -f sysinfo::read
72 * RESULT: tracing of probes with provider sysinfo and function read.
73 *
74 * 10) automated in tst.InvalidTraceFunc5.d.ksh
75 * /usr/sbin/dtrace -f :genunix::
76 * RESULT: invalid probe specifier
77 *
78 * 11) automated in tst.InvalidTraceFunc6.d.ksh
79 * /usr/sbin/dtrace -f profile:::profile-97
80 * RESULT: invalid probe specifier.
81 *
82 * 12)
83 * /usr/sbin/dtrace -f read -f write
84 * RESULT: tracing of both read and write probes.
85 *
86 * 13)
87 * /usr/sbin/dtrace -f read -f fight
88 * RESULT: Count of matching read probes and invalid probe specifier
89 * for fight
90 *
91 * 14) automated in tst.InvalidTraceFunc8.d.ksh
92 * /usr/sbin/dtrace -f fight -f write
93 * RESULT: invalid probe specifier.
94 *
95 * 15) automated in tst.InvalidTraceFunc7.d.ksh
96 * /usr/sbin/dtrace -f fbt:des:des3_crunch_block:return
97 * RESULT: invalid probe specifier.
98 *
99 * 16)
100 * /usr/sbin/dtrace -f read'{printf("FOUND");}'
101 * RESULT: tracing of probes with function read and with message FOUND
102 *
103 * 17)
104 * /usr/sbin/dtrace -f ::read'{printf("FOUND");}'
105 * RESULT: tracing of probes with function read and with message FOUND
106 *
107 * 18) automated in tst.InvalidTraceFunc9.d.ksh
108 * /usr/sbin/dtrace -f read '{printf("FOUND");}'
109 * RESULT: invalid probe specifier.
110 *
111 * 19)
112 * /usr/sbin/dtrace -f read'/probename == "entry"/{printf("FOUND");}'
113 * RESULT: tracing of probes with function read, name entry and with
114 * message FOUND
115 */
116