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

   1 .TH py_profile.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 py_profile.d - sample stack traces with Python translations using DTrace.
   4 .SH SYNOPSIS
   5 .B py_profile.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This samples stack traces for the process specified. This stack trace
   9 will cross the Python engine and system libraries, and insert
  10 translations for Python stack frames where appropriate. This is best
  11 explained with an example stack frame output,
  12
  13 libpython2.4.so.1.0`PyEval_EvalFrame+0x2fbf
  14 [ ./func_loop.py:5 (func_c) ]
  15 libpython2.4.so.1.0`fast_function+0xa8
  16 libpython2.4.so.1.0`call_function+0xda
  17 libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
  18 [ ./func_loop.py:11 (func_b) ]
  19 libpython2.4.so.1.0`fast_function+0xa8
  20 libpython2.4.so.1.0`call_function+0xda
  21 libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
  22 [ ./func_loop.py:14 (func_a) ]
  23 libpython2.4.so.1.0`fast_function+0xa8
  24 libpython2.4.so.1.0`call_function+0xda
  25 libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
  26 [ ./func_loop.py:16 (?) ]
  27
  28 The lines in square brackets are the native Python frames, the rest
  29 are the Python engine.
  30 .SH OS
  31 Any
  32 .SH STABILITY
  33 Evolving - uses the DTrace Python provider, which may change
  34 as additional features are introduced. Check Python/Readme
  35 to see what version these scripts are based on.
  36 .SH EXAMPLES
  37 .TP
  38 Default output,
  39 #
  40 .B py_profile.d
  41 .PP
  42 .PP
  43 .SH DOCUMENTATION
  44 See the DTraceToolkit for further documentation under the
  45 Examples, Notes and Docs directories. The example files may be
  46 especially useful as they aim to demonstrate how to interpret
  47 the output.
  48 .SH EXIT
  49 py_profile.d will run until Ctrl-C is hit.
  50 .SH AUTHOR
  51 Brendan Gregg
  52 [CA, USA]
  53 .SH SEE ALSO
  54 dtrace(1M)