This file is indexed.

/usr/share/doc/libapache2-mod-python-doc/doc-html/pyapi-interps.html is in libapache2-mod-python-doc 3.3.1-11ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="modpython.css" type='text/css' />
<link rel="first" href="modpython.html" title='Mod_python Manual' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="pyapi-handler.html" />
<link rel="prev" href="pythonapi.html" />
<link rel="parent" href="pythonapi.html" />
<link rel="next" href="pyapi-handler.html" />
<meta name='aesop' content='information' />
<title>4.1 Multiple Interpreters</title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="4. Python API"
  href="pythonapi.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="4. Python API"
  href="pythonapi.html"><img src='up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="4.2 Overview of a"
  href="pyapi-handler.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pythonapi.html">4. Python API</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pythonapi.html">4. Python API</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-handler.html">4.2 Overview of a</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION006100000000000000000"></A><A NAME="pyapi-interps"></A>
<BR>
4.1 Multiple Interpreters
</H1>

<P>
When working with mod_python, it is important to be aware of a feature
of Python that is normally not used when using the language for
writing scripts to be run from command line. This feature is not
available from within Python itself and can only be accessed through
the <em class="citetitle"><a
 href="http://www.python.org/doc/current/api/api.html"
 title="C
language API"
 >C
language API</a></em>.

<P>
Python C API provides the ability to create <i class="dfn">subinterpreters</i>. A
more detailed description of a subinterpreter is given in the
documentation for the
<em class="citetitle"><a
 href="http://www.python.org/doc/current/api/initialization.html"
 title="Py_NewInterpreter()"
 ><tt class="cfunction">Py_NewInterpreter()</tt></a></em>
function. For this discussion, it will suffice to say that each
subinterpreter has its own separate namespace, not accessible from
other subinterpreters. Subinterpreters are very useful to make sure
that separate programs running under the same Apache server do not
interfere with one another.

<P>
At server start-up or mod_python initialization time, mod_python
initializes an interpreter called <i class="dfn">main</i> interpreter.  The main
interpreter contains a dictionary of subinterpreters. Initially, this
dictionary is empty. With every request, as needed, subinterpreters
are created, and references to them are stored in this dictionary. The
dictionary is keyed on a string, also known as <em>interpreter
name</em>. This name can be any string.  The main interpreter is named
"<tt class="samp">main_interpreter</tt>".  The way all other interpreters are named can
be controlled by <code>PythonInterp*</code> directives. Default behaviour is
to name interpreters using the Apache virtual server name
(<code>ServerName</code> directive). This means that all scripts in the same
virtual server execute in the same subinterpreter, but scripts in
different virtual servers execute in different subinterpreters with
completely separate namespaces.
<em class="citetitle"><a
 href="dir-other-ipd.html"
 title="PythonInterpPerDirectory"
 ><code>PythonInterpPerDirectory</code></a></em> and
<em class="citetitle"><a
 href="dir-other-ipdv.html"
 title="PythonInterpPerDirective"
 ><code>PythonInterpPerDirective</code></a></em>
directives alter the naming convention to use the absolute path of the
directory being accessed, or the directory in which the
<code>Python*Handler</code> was encountered, respectively.
<em class="citetitle"><a
 href="dir-other-pi.html"
 title="PythonInterpreter"
 ><code>PythonInterpreter</code></a></em> can be used to
force the interpreter name to a specific string overriding any naming
conventions.

<P>
Once created, a subinterpreter will be reused for subsequent requests.
It is never destroyed and exists until the Apache process dies.

<P>
You can find out the name of the interpreter under which you're
running by peeking at <tt class="member">req.interpreter</tt>.

<P>
Note that if any third party module is being used which has a C code
component that uses the simplified API for access to the Global
Interpreter Lock (GIL) for Python extension modules, then the interpreter
name must be forcibly set to be "<tt class="samp">main_interpreter</tt>". This is necessary
as such a module will only work correctly if run within the context of
the first Python interpreter created by the process. If not forced to
run under the "<tt class="samp">main_interpreter</tt>", a range of Python errors can arise,
each typically referring to code being run in <em>restricted mode</em>.

<P>
<div class="seealso">
  <p class="heading">See Also:</p>

  <dl compact="compact" class="seetitle">
    <dt><em class="citetitle"><a href="http://www.python.org/doc/current/api/api.html"
        >Python C Language API</a></em></dt>
    <dd>Python C Language API</dd>
  </dl>
  <dl compact="compact" class="seetitle">
    <dt><em class="citetitle"><a href="http://www.python.org/peps/pep-0311.html"
        >PEP 0311 - Simplified Global Interpreter Lock Acquisition for Extensions</a></em></dt>
    <dd>PEP 0311 - Simplified Global Interpreter Lock Acquisition for Extensions</dd>
  </dl>
</div>

<P>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="4. Python API"
  href="pythonapi.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="4. Python API"
  href="pythonapi.html"><img src='up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="4.2 Overview of a"
  href="pyapi-handler.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pythonapi.html">4. Python API</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pythonapi.html">4. Python API</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-handler.html">4.2 Overview of a</A>
</div>
</div>
<hr />
<span class="release-info">Release 3.3.1, documentation updated on January 29, 2007.</span>
</DIV>
<!--End of Navigation Panel-->

</BODY>
</HTML>