Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / src / nas,5.n2.os.2 / lib / python / html / python / mac / module-autoGIL.html
CommitLineData
86530b38
AT
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3<head>
4<link rel="STYLESHEET" href="mac.css" type='text/css' />
5<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
6<link rel='start' href='../index.html' title='Python Documentation Index' />
7<link rel="first" href="mac.html" title='Macintosh Library Modules' />
8<link rel='contents' href='contents.html' title="Contents" />
9<link rel='index' href='genindex.html' title='Index' />
10<link rel='last' href='about.html' title='About this document...' />
11<link rel='help' href='about.html' title='About this document...' />
12<link rel="prev" href="module-FrameWork.html" />
13<link rel="parent" href="macpython-modules.html" />
14<link rel="next" href="scripting.html" />
15<meta name='aesop' content='information' />
16<title>2.9 autoGIL -- Global Interpreter Lock handling in event loops</title>
17</head>
18<body>
19<DIV CLASS="navigation">
20<div id='top-navigation-panel' xml:id='top-navigation-panel'>
21<table align="center" width="100%" cellpadding="0" cellspacing="2">
22<tr>
23<td class='online-navigation'><a rel="prev" title="2.8.5 DialogWindow Objects"
24 href="dialogwindow-objects.html"><img src='../icons/previous.png'
25 border='0' height='32' alt='Previous Page' width='32' /></A></td>
26<td class='online-navigation'><a rel="parent" title="2. MacPython Modules"
27 href="macpython-modules.html"><img src='../icons/up.png'
28 border='0' height='32' alt='Up One Level' width='32' /></A></td>
29<td class='online-navigation'><a rel="next" title="3. MacPython OSA Modules"
30 href="scripting.html"><img src='../icons/next.png'
31 border='0' height='32' alt='Next Page' width='32' /></A></td>
32<td align="center" width="100%">Macintosh Library Modules</td>
33<td class='online-navigation'><a rel="contents" title="Table of Contents"
34 href="contents.html"><img src='../icons/contents.png'
35 border='0' height='32' alt='Contents' width='32' /></A></td>
36<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
37 border='0' height='32' alt='Module Index' width='32' /></a></td>
38<td class='online-navigation'><a rel="index" title="Index"
39 href="genindex.html"><img src='../icons/index.png'
40 border='0' height='32' alt='Index' width='32' /></A></td>
41</tr></table>
42<div class='online-navigation'>
43<b class="navlabel">Previous:</b>
44<a class="sectref" rel="prev" href="dialogwindow-objects.html">2.8.5 DialogWindow Objects</A>
45<b class="navlabel">Up:</b>
46<a class="sectref" rel="parent" href="macpython-modules.html">2. MacPython Modules</A>
47<b class="navlabel">Next:</b>
48<a class="sectref" rel="next" href="scripting.html">3. MacPython OSA Modules</A>
49</div>
50<hr /></div>
51</DIV>
52<!--End of Navigation Panel-->
53
54<H1><A NAME="SECTION004900000000000000000">
552.9 <tt class="module">autoGIL</tt> --
56 Global Interpreter Lock handling in event loops</A>
57</H1>
58
59<P>
60<A NAME="module-autoGIL"></A>
61<p class="availability">Availability: <span
62 class="platform">Macintosh</span>.</p>
63
64<P>
65The <tt class="module">autoGIL</tt> module provides a function <tt class="function">installAutoGIL</tt> that
66automatically locks and unlocks Python's Global Interpreter Lock
67when running an event loop.
68
69<P>
70<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-135' xml:id='l2h-135' class="exception">AutoGILError</tt></b></dt>
71<dd>
72Raised if the observer callback cannot be installed, for example because
73the current thread does not have a run loop.
74</dd></dl>
75
76<P>
77<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
78 <td><nobr><b><tt id='l2h-136' xml:id='l2h-136' class="function">installAutoGIL</tt></b>(</nobr></td>
79 <td><var></var>)</td></tr></table></dt>
80<dd>
81 Install an observer callback in the event loop (CFRunLoop) for the
82 current thread, that will lock and unlock the Global Interpreter Lock
83 (GIL) at appropriate times, allowing other Python threads to run while
84 the event loop is idle.
85
86<P>
87Availability: OSX 10.1 or later.
88</dl>
89
90<P>
91
92<DIV CLASS="navigation">
93<div class='online-navigation'>
94<p></p><hr />
95<table align="center" width="100%" cellpadding="0" cellspacing="2">
96<tr>
97<td class='online-navigation'><a rel="prev" title="2.8.5 DialogWindow Objects"
98 href="dialogwindow-objects.html"><img src='../icons/previous.png'
99 border='0' height='32' alt='Previous Page' width='32' /></A></td>
100<td class='online-navigation'><a rel="parent" title="2. MacPython Modules"
101 href="macpython-modules.html"><img src='../icons/up.png'
102 border='0' height='32' alt='Up One Level' width='32' /></A></td>
103<td class='online-navigation'><a rel="next" title="3. MacPython OSA Modules"
104 href="scripting.html"><img src='../icons/next.png'
105 border='0' height='32' alt='Next Page' width='32' /></A></td>
106<td align="center" width="100%">Macintosh Library Modules</td>
107<td class='online-navigation'><a rel="contents" title="Table of Contents"
108 href="contents.html"><img src='../icons/contents.png'
109 border='0' height='32' alt='Contents' width='32' /></A></td>
110<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
111 border='0' height='32' alt='Module Index' width='32' /></a></td>
112<td class='online-navigation'><a rel="index" title="Index"
113 href="genindex.html"><img src='../icons/index.png'
114 border='0' height='32' alt='Index' width='32' /></A></td>
115</tr></table>
116<div class='online-navigation'>
117<b class="navlabel">Previous:</b>
118<a class="sectref" rel="prev" href="dialogwindow-objects.html">2.8.5 DialogWindow Objects</A>
119<b class="navlabel">Up:</b>
120<a class="sectref" rel="parent" href="macpython-modules.html">2. MacPython Modules</A>
121<b class="navlabel">Next:</b>
122<a class="sectref" rel="next" href="scripting.html">3. MacPython OSA Modules</A>
123</div>
124</div>
125<hr />
126<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
127</DIV>
128<!--End of Navigation Panel-->
129<ADDRESS>
130See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
131</ADDRESS>
132</BODY>
133</HTML>