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