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

   1 .TH py_flowtime.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 py_flowtime.d - snoop Python functions with flow and delta times.
   4 .SH SYNOPSIS
   5 .B py_flowtime.d
   6
   7 .SH DESCRIPTION
   8 This traces shell activity from Python programs on the system that are
   9 running with Python provider support.
  10
  11 This watches Python function entries and returns, and indents child
  12 function calls.
  13
  14 Filename and function names are printed if available.
  15 .SH OS
  16 Any
  17 .SH STABILITY
  18 Evolving - uses the DTrace Python provider, which may change
  19 as additional features are introduced. Check Python/Readme
  20 to see what version these scripts are based on.
  21 .SH EXAMPLES
  22 .TP
  23 Default output,
  24 #
  25 .B py_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 function belongs to
  37 .TP
  38 DELTA(us)
  39 Elapsed time from previous line to this line
  40 .TP
  41 FUNC
  42 Python function name
  43 .SH LEGEND
  44 .TP
  45 \->
  46 function entry
  47 .TP
  48 <\-
  49 function 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 py_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)