diff options
author | Marco Pesenti Gritti <marco@localhost.localdomain> | 2006-10-12 10:47:17 (GMT) |
---|---|---|
committer | Marco Pesenti Gritti <marco@localhost.localdomain> | 2006-10-12 10:47:17 (GMT) |
commit | 62a46ff92b234d07437f9f36efea576996eb84e2 (patch) | |
tree | 8bcb898523a5c907e38eb4fc006a2e31d814cef8 /lib/threadframe/README | |
parent | 5cc6ee3235b6b1301f14f7aae9d1a36abef45557 (diff) |
Create a private sugar lib and put our extensions there.
Diffstat (limited to 'lib/threadframe/README')
-rw-r--r-- | lib/threadframe/README | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/lib/threadframe/README b/lib/threadframe/README new file mode 100644 index 0000000..ec63fa2 --- /dev/null +++ b/lib/threadframe/README @@ -0,0 +1,34 @@ +Note on the License +Dan Williams <dcbw at redhat com> 2006-08-16 + +Since 'setup.py' specifies the "Python" license, it is assumed that the +threadframe package is distributed under that license, even though there +is no license header at the top of the source file. + + + +Obtaining tracebacks on other threads in Python +=============================================== +by Fazal Majid (www.majid.info), 2004-06-10 + +David Beazley added advanced debugging functions to the Python interpreter, +and they have been folded into the 2.2 release. Guido van Rossum added in +Python 2.3 the thread ID to the interpreter state structure, and this allows +us to produce a dictionary mapping thread IDs to frames. + +I used these hooks to build a debugging module that is useful when you +are looking for deadlocks in a multithreaded application. I've built +and tested this only on Solaris 8/x86, but the code should be pretty +portable. + +Of course, I disclaim any liability if this code should crash your system, +erase your homework, eat your dog (who also ate your homework) or otherwise +have any undesirable effect. + +Building and installing +======================= + +Download threadframe-0.2.tar.gz. You can use the Makefile or the setup.py +script. There is a small test program test.py that illustrates how to use this +module to dump stack frames of all the Python interpreter threads. A sample +run is available for your perusal. |