]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - cddl/contrib/dtracetoolkit/Man/man1m/pl_flowtime.d.1m
Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.
[FreeBSD/stable/10.git] / cddl / contrib / dtracetoolkit / Man / man1m / pl_flowtime.d.1m
1 .TH pl_flowtime.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
2 .SH NAME
3 pl_flowtime.d - snoop Perl subroutines with flow and delta times.
4 .SH SYNOPSIS
5 .B pl_flowtime.d
6
7 .SH DESCRIPTION
8 This traces shell activity from Perl programs on the system that are
9 running with Perl provider support.
10
11 This watches Perl subroutine entries and returns, and indents child
12 subroutine calls.
13
14 Filename and subroutine names are printed if available.
15 .SH OS
16 Any
17 .SH STABILITY
18 Evolving - uses the DTrace Perl provider, which may change 
19 as additional features are introduced. Check Perl/Readme
20 to see what version these scripts are based on.
21 .SH EXAMPLES
22 .TP
23 Default output,
24
25 .B pl_flowtime.d
26 .PP
27 .SH FIELDS
28 .TP
29 C
30 CPU-id
31 .TP
32 TIME(us)
33 Time since boot, us
34 .TP
35 FILE
36 Filename that this subroutine belongs to
37 .TP
38 DELTA(us)
39 Elapsed time from previous line to this line
40 .TP
41 SUB
42 Perl subroutine name
43 .SH LEGEND
44 .TP
45 \->
46 method entry
47 .TP
48 <\-
49 method return
50 .SH WARNING
51 Watch the first column carefully, it prints the CPU-id. If it
52 changes, then it is very likely that the output has been shuffled.
53 .PP
54 .SH DOCUMENTATION
55 See the DTraceToolkit for further documentation under the 
56 Examples, Notes and Docs directories. The example files may be
57 especially useful as they aim to demonstrate how to interpret
58 the output.
59 .SH EXIT
60 pl_flowtime.d will run until Ctrl-C is hit.
61 .SH AUTHOR
62 Brendan Gregg
63 [CA, USA]
64 .SH SEE ALSO
65 dtrace(1M)