symbian-qemu-0.9.1-12/python-2.6.1/Doc/library/autogil.rst
author Gareth Stockwell <gareth.stockwell@accenture.com>
Fri, 24 Sep 2010 13:44:00 +0100
branchgraphics-phase-3
changeset 117 b7d35cad610d
parent 1 2fb8b9db1c86
permissions -rw-r--r--
Modified path to qemu package source to /sf/adapt/qemu This is to conform with the convention that adaptation-level packages should be located in /sf/adapt rather than /sf/adaptation. This is an interim workaround for bug 3744.


:mod:`autoGIL` --- Global Interpreter Lock handling in event loops
==================================================================

.. module:: autoGIL
   :platform: Mac
   :synopsis: Global Interpreter Lock handling in event loops.
   :deprecated:
.. moduleauthor:: Just van Rossum <just@letterror.com>


The :mod:`autoGIL` module provides a function :func:`installAutoGIL` that
automatically locks and unlocks Python's :term:`Global Interpreter Lock` when
running an event loop.

.. warning::

   This module has been removed in 3.0.


.. 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.