xref: /netbsd-src/external/cddl/dtracetoolkit/dist/Perl/pl_flow.d (revision c29d51755812ace2e87aeefdb06cb2b4dac7087a)
1 #!/usr/sbin/dtrace -Zs
2 /*
3  * pl_flow.d - snoop Perl execution showing subroutine flow.
4  *             Written for the Solaris Perl DTrace provider.
5  *
6  * $Id: pl_flow.d,v 1.1.1.1 2015/09/30 22:01:09 christos Exp $
7  *
8  * This traces Perl activity from all Perl programs on the system
9  * running with Perl provider support.
10  *
11  * USAGE: pl_flow.d			# hit Ctrl-C to end
12  *
13  * This watches Perl subroutine entries and returns, and indents child
14  * subroutine calls.
15  *
16  * FIELDS:
17  *		C		CPU-id
18  *		TIME(us)	Time since boot, us
19  *		FILE		Filename that this subroutine belongs to
20  *		SUB		Subroutine name
21  *
22  * LEGEND:
23  *		->		subroutine entry
24  *		<-		subroutine return
25  *
26  * WARNING: Watch the first column carefully, it prints the CPU-id. If it
27  * changes, then it is very likely that the output has been shuffled.
28  *
29  * COPYRIGHT: Copyright (c) 2007 Brendan Gregg.
30  *
31  * CDDL HEADER START
32  *
33  *  The contents of this file are subject to the terms of the
34  *  Common Development and Distribution License, Version 1.0 only
35  *  (the "License").  You may not use this file except in compliance
36  *  with the License.
37  *
38  *  You can obtain a copy of the license at Docs/cddl1.txt
39  *  or http://www.opensolaris.org/os/licensing.
40  *  See the License for the specific language governing permissions
41  *  and limitations under the License.
42  *
43  * CDDL HEADER END
44  *
45  * 09-Sep-2007	Brendan Gregg	Created this.
46  */
47 
48 #pragma D option quiet
49 #pragma D option switchrate=10
50 
51 self int depth;
52 
53 dtrace:::BEGIN
54 {
55 	printf("%3s %-16s %-16s -- %s\n", "C", "TIME(us)", "FILE", "SUB");
56 }
57 
58 perl*:::sub-entry
59 {
60 	printf("%3d %-16d %-16s %*s-> %s\n", cpu, timestamp / 1000,
61 	    basename(copyinstr(arg1)), self->depth * 2, "", copyinstr(arg0));
62 	self->depth++;
63 }
64 
65 perl*:::sub-return
66 {
67 	self->depth -= self->depth > 0 ? 1 : 0;
68 	printf("%3d %-16d %-16s %*s<- %s\n", cpu, timestamp / 1000,
69 	    basename(copyinstr(arg1)), self->depth * 2, "", copyinstr(arg0));
70 }
71