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

   1 .TH tcl_flowtime.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 tcl_flowtime.d - snoop Tcl execution showing procedure flow and delta times.
   4 .SH SYNOPSIS
   5 .B tcl_flowtime.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_flowtime.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 CALL
  40 Tcl command or procedure name
  41 .SH LEGEND
  42 .TP
  43 \->
  44 procedure entry
  45 .TP
  46 <\-
  47 procedure return
  48 .TP
  49 >
  50 command entry
  51 .TP
  52 <
  53 command return
  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_flowtime.d will run until Ctrl-C is hit.
  65 .SH AUTHOR
  66 Brendan Gregg
  67 [CA, USA]
  68 .SH SEE ALSO
  69 dtrace(1M)