aboutsummaryrefslogtreecommitdiff
path: root/Python/Readme
diff options
context:
space:
mode:
Diffstat (limited to 'Python/Readme')
-rw-r--r--Python/Readme28
1 files changed, 28 insertions, 0 deletions
diff --git a/Python/Readme b/Python/Readme
new file mode 100644
index 000000000000..f183c74fe64d
--- /dev/null
+++ b/Python/Readme
@@ -0,0 +1,28 @@
+Python - DTracing Python
+
+ These scripts trace the Python programming language, and require a version
+ of Python which has been built with DTrace probes.
+
+ The Python DTrace provider was originally written by John Levon, and
+ was integrated into Solaris Nevada in build 65. If you are on a different
+ OS with DTrace and would like to use these scripts, you could download
+ Python and the Python DTrace provider patch listed in the comments here,
+
+ http://blogs.sun.com/levon/entry/python_and_dtrace_in_build
+
+ You will need patch and build Python for these probes to work.
+ Or, check if a pre-built package is available someone on opensolaris.org.
+
+ Since the DTrace Python provider may be developed further, there is a chance
+ that it has changed slightly by the time you are reading this, causing
+ these scripts to either break or behave oddly. Firstly, check for newer
+ versions of the DTraceToolkit; if it hasn't been updated and you need
+ to use these scripts immediately, then updating them shouldn't take
+ too long. The following was the state of the provider when these scripts
+ were written - check for changes and update the scripts accordingly,
+
+ provider python {
+ probe function-entry(file, subroutine, lineno)
+ probe function-return(file, subroutine, lineno)
+ };
+