cddl/contrib/dtracetoolkit/Man/man1m/tcl_flow.d.1m

   1 .TH tcl_flow.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 tcl_flow.d - snoop Tcl execution showing procedure flow using DTrace.
   4 .SH SYNOPSIS
   5 .B tcl_flow.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_flow.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 C
  28 CPU-id
  29 .TP
  30 TIME(us)
  31 Time since boot, us
  32 .TP
  33 PID
  34 Process ID
  35 .TP
  36 CALL
  37 Tcl command or procedure name
  38 .SH LEGEND
  39 .TP
  40 \->
  41 procedure entry
  42 .TP
  43 <\-
  44 procedure return
  45 .TP
  46 >
  47 command entry
  48 .TP
  49 <
  50 command return
  51 .SH WARNING
  52 Watch the first column carefully, it prints the CPU-id. If it
  53 changes, then it is very likely that the output has been shuffled.
  54 .PP
  55 .SH DOCUMENTATION
  56 See the DTraceToolkit for further documentation under the
  57 Examples, Notes and Docs directories. The example files may be
  58 especially useful as they aim to demonstrate how to interpret
  59 the output.
  60 .SH EXIT
  61 tcl_flow.d will run until Ctrl-C is hit.
  62 .SH AUTHOR
  63 Brendan Gregg
  64 [CA, USA]
  65 .SH SEE ALSO
  66 dtrace(1M)