diff options
Diffstat (limited to 'Doc/library/autogil.rst')
-rw-r--r-- | Doc/library/autogil.rst | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/Doc/library/autogil.rst b/Doc/library/autogil.rst new file mode 100644 index 0000000..93f0d04 --- /dev/null +++ b/Doc/library/autogil.rst @@ -0,0 +1,30 @@ + +:mod:`autoGIL` --- Global Interpreter Lock handling in event loops +================================================================== + +.. module:: autoGIL + :platform: Mac + :synopsis: Global Interpreter Lock handling in event loops. +.. moduleauthor:: Just van Rossum <just@letterror.com> + + +The :mod:`autoGIL` module provides a function :func:`installAutoGIL` that +automatically locks and unlocks Python's Global Interpreter Lock when running an +event loop. + + +.. exception:: AutoGILError + + Raised if the observer callback cannot be installed, for example because the + current thread does not have a run loop. + + +.. function:: installAutoGIL() + + Install an observer callback in the event loop (CFRunLoop) for the current + thread, that will lock and unlock the Global Interpreter Lock (GIL) at + appropriate times, allowing other Python threads to run while the event loop is + idle. + + Availability: OSX 10.1 or later. + |