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

   1 .TH py_syscolors.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 py_syscolors.d - trace Python function flow plus syscalls, in color.
   4 .SH SYNOPSIS
   5 .B py_syscolors.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This watches Python function entries and returns, and indents child
   9 function calls.
  10
  11 Filename and function names are printed if available.
  12 .SH OS
  13 Any
  14 .SH STABILITY
  15 Evolving - uses the DTrace Python provider, which may change
  16 as additional features are introduced. Check Python/Readme
  17 to see what version these scripts are based on.
  18 .SH EXAMPLES
  19 .TP
  20 Default output,
  21 #
  22 .B py_syscolors.d
  23 .PP
  24 .SH FIELDS
  25 .TP
  26 C
  27 CPU-id
  28 .TP
  29 PID
  30 Process ID
  31 .TP
  32 DELTA(us)
  33 Elapsed time from previous line to this line
  34 .TP
  35 FILE
  36 Filename of the Python program
  37 .TP
  38 LINE
  39 Line number of filename
  40 .TP
  41 TYPE
  42 Type of call (func/syscall)
  43 .TP
  44 NAME
  45 Python function or syscall name
  46 .SH WARNING
  47 Watch the first column carefully, it prints the CPU-id. If it
  48 changes, then it is very likely that the output has been shuffled.
  49 .PP
  50 .SH DOCUMENTATION
  51 See the DTraceToolkit for further documentation under the
  52 Examples, Notes and Docs directories. The example files may be
  53 especially useful as they aim to demonstrate how to interpret
  54 the output.
  55 .SH EXIT
  56 py_syscolors.d will run until Ctrl-C is hit.
  57 .SH AUTHOR
  58 Brendan Gregg
  59 [CA, USA]
  60 .SH SEE ALSO
  61 dtrace(1M)