xref: /netbsd-src/external/cddl/dtracetoolkit/dist/Python/Readme (revision c29d51755812ace2e87aeefdb06cb2b4dac7087a)
1*c29d5175SchristosPython - DTracing Python
2*c29d5175Schristos
3*c29d5175Schristos   These scripts trace the Python programming language, and require a version
4*c29d5175Schristos   of Python which has been built with DTrace probes.
5*c29d5175Schristos
6*c29d5175Schristos   The Python DTrace provider was originally written by John Levon, and
7*c29d5175Schristos   was integrated into Solaris Nevada in build 65. If you are on a different
8*c29d5175Schristos   OS with DTrace and would like to use these scripts, you could download
9*c29d5175Schristos   Python and the Python DTrace provider patch listed in the comments here,
10*c29d5175Schristos
11*c29d5175Schristos	http://blogs.sun.com/levon/entry/python_and_dtrace_in_build
12*c29d5175Schristos
13*c29d5175Schristos   You will need patch and build Python for these probes to work.
14*c29d5175Schristos   Or, check if a pre-built package is available someone on opensolaris.org.
15*c29d5175Schristos
16*c29d5175Schristos   Since the DTrace Python provider may be developed further, there is a chance
17*c29d5175Schristos   that it has changed slightly by the time you are reading this, causing
18*c29d5175Schristos   these scripts to either break or behave oddly. Firstly, check for newer
19*c29d5175Schristos   versions of the DTraceToolkit; if it hasn't been updated and you need
20*c29d5175Schristos   to use these scripts immediately, then updating them shouldn't take
21*c29d5175Schristos   too long. The following was the state of the provider when these scripts
22*c29d5175Schristos   were written - check for changes and update the scripts accordingly,
23*c29d5175Schristos
24*c29d5175Schristos	provider python {
25*c29d5175Schristos	    probe function-entry(file, subroutine, lineno)
26*c29d5175Schristos	    probe function-return(file, subroutine, lineno)
27*c29d5175Schristos	};
28*c29d5175Schristos
29