1235368Sgnn#!/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 41 2007-09-17 02:20:10Z brendan $
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
51self int depth;
52
53dtrace:::BEGIN
54{
55	printf("%3s %-16s %-16s -- %s\n", "C", "TIME(us)", "FILE", "SUB");
56}
57
58perl*:::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
65perl*:::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