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