EVOLUTION-MANAGER

Edit File: version-2.4.html

<!DOCTYPE html>

 <html class="no-js" lang="en" > 
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Version 2.4 &mdash; mod_wsgi 4.7.1 documentation</title>

</head>

<a href="../index.html" class="icon icon-home"> mod_wsgi

</a>

</div>

<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../project-status.html">Project Status</a></li>
<li class="toctree-l1"><a class="reference internal" href="../security-issues.html">Security Issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="../getting-started.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../requirements.html">Requirements</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../user-guides.html">User Guides</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../finding-help.html">Finding Help</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reporting-bugs.html">Reporting Bugs</a></li>
<li class="toctree-l1"><a class="reference internal" href="../contributing.html">Contributing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../source-code.html">Source Code</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../release-notes.html">Release Notes</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="version-4.7.0.html">Version 4.7.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.7.1.html">Version 4.7.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.8.html">Version 4.6.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.7.html">Version 4.6.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.6.html">Version 4.6.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.5.html">Version 4.6.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.4.html">Version 4.6.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.3.html">Version 4.6.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.2.html">Version 4.6.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.1.html">Version 4.6.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.6.0.html">Version 4.6.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.24.html">Version 4.5.24</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.23.html">Version 4.5.23</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.22.html">Version 4.5.22</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.21.html">Version 4.5.21</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.20.html">Version 4.5.20</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.19.html">Version 4.5.19</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.18.html">Version 4.5.18</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.17.html">Version 4.5.17</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.16.html">Version 4.5.16</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.15.html">Version 4.5.15</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.14.html">Version 4.5.14</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.13.html">Version 4.5.13</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.12.html">Version 4.5.12</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.11.html">Version 4.5.11</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.10.html">Version 4.5.10</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.9.html">Version 4.5.9</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.8.html">Version 4.5.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.7.html">Version 4.5.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.6.html">Version 4.5.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.5.html">Version 4.5.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.4.html">Version 4.5.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.3.html">Version 4.5.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.2.html">Version 4.5.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.1.html">Version 4.5.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.5.0.html">Version 4.5.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.23.html">Version 4.4.23</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.22.html">Version 4.4.22</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.21.html">Version 4.4.21</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.20.html">Version 4.4.20</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.19.html">Version 4.4.19</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.18.html">Version 4.4.18</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.17.html">Version 4.4.17</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.16.html">Version 4.4.16</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.15.html">Version 4.4.15</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.14.html">Version 4.4.14</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.13.html">Version 4.4.13</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.12.html">Version 4.4.12</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.11.html">Version 4.4.11</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.10.html">Version 4.4.10</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.9.html">Version 4.4.9</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.8.html">Version 4.4.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.7.html">Version 4.4.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.6.html">Version 4.4.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.5.html">Version 4.4.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.4.html">Version 4.4.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.3.html">Version 4.4.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.2.html">Version 4.4.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.1.html">Version 4.4.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.4.0.html">Version 4.4.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.3.2.html">Version 4.3.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.3.1.html">Version 4.3.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.3.0.html">Version 4.3.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.8.html">Version 4.2.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.7.html">Version 4.2.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.6.html">Version 4.2.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.5.html">Version 4.2.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.4.html">Version 4.2.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.3.html">Version 4.2.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.2.html">Version 4.2.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.1.html">Version 4.2.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.2.0.html">Version 4.2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.1.3.html">Version 4.1.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.1.2.html">Version 4.1.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.1.1.html">Version 4.1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.1.0.html">Version 4.1.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-4.0.html">Version 4.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.5.html">Version 3.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.4.html">Version 3.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.3.html">Version 3.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.2.html">Version 3.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.1.html">Version 3.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-3.0.html">Version 3.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.8.html">Version 2.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.7.html">Version 2.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.6.html">Version 2.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.5.html">Version 2.5</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="">Version 2.4</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#bug-fixes">Bug Fixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#features-changed">Features Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="#features-added">Features Added</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="version-2.3.html">Version 2.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.2.html">Version 2.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.1.html">Version 2.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-2.0.html">Version 2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.6.html">Version 1.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.5.html">Version 1.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.4.html">Version 1.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.3.html">Version 1.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.2.html">Version 1.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.1.html">Version 1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="version-1.0.html">Version 1.0</a></li>
</ul>
</li>
</ul>

</div>
      </div>
    </nav>

<ul class="wy-breadcrumbs">
    
      <li><a href="../index.html">Docs</a> &raquo;</li>
        
          <li><a href="../release-notes.html">Release Notes</a> &raquo;</li>
        
      <li>Version 2.4</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
            <a href="../_sources/release-notes/version-2.4.txt" rel="nofollow"> View page source</a>
          
        
      </li>
    
  </ul>

<hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="version-2-4">
<h1>Version 2.4<a class="headerlink" href="#version-2-4" title="Permalink to this headline">¶</a></h1>
<p>Version 2.4 of mod_wsgi can be obtained from:</p>
<blockquote>
<div><a class="reference external" href="http://modwsgi.googlecode.com/files/mod_wsgi-2.4.tar.gz">http://modwsgi.googlecode.com/files/mod_wsgi-2.4.tar.gz</a></div></blockquote>
<div class="section" id="bug-fixes">
<h2>Bug Fixes<a class="headerlink" href="#bug-fixes" title="Permalink to this headline">¶</a></h2>
<p>1. Compilation would fail on Windows due to daemon mode specific code not
being conditionally compiled out on that platform. This was a problem
introduced by changes in mod_wsgi 2.3.</p>
<p>2. Fix bug where wrong Apache memory pool used when processing configuration
directives at startup. This could later result in memory corruption and may
account for problems seen with &#8216;fopen()&#8217; errors. See:</p>
<blockquote>
<div><p><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=78">http://code.google.com/p/modwsgi/issues/detail?id=78</a></p>
<p><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=108">http://code.google.com/p/modwsgi/issues/detail?id=108</a></p>
</div></blockquote>
<p>3. Fix bug where Python interpreter not being destroyed correctly in Apache
parent process on an Apache restart. This was resulting in slow memory leak
into Apache parent process on each restart. This additional memory usage
would then be inherited by all child processes forked from Apache parent
process.</p>
<p>Note that this change does not help for case where mod_python is also being
loaded into Apache as in that case mod_python is responsible for
intialising Python and in all available versions of mod_python it still
doesn&#8217;t properly destroy the Python interpreter either and so causes memory
leaks which mod_wsgi cannot work around.</p>
<p>Also, this doesn&#8217;t solve problems with the Python interpreter itself
leaking memory when destroyed and reinitialised. Such memory leaks in
Python seem to occur for some versions of Python on particular platforms.</p>
<p>For further details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=99">http://code.google.com/p/modwsgi/issues/detail?id=99</a></div></blockquote>
<p>4. Fix bug whereby POST requests where 100-continue was expected by client
would see request content actually truncated and not be available to WSGI
application if application running in daemon mode. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=121">http://code.google.com/p/modwsgi/issues/detail?id=121</a></div></blockquote>
<p>5. Fix bug where Apache optimisation related to keep alive connections can
kick in when using wsgi.file_wrapper with result that if amount of data is
between 255 and aproximately 8000 bytes, that a completely empty response
will result. This occurs because Apache isn&#8217;t flushing out the file data
straight away but holding it over in case subsequent request on connection
arrives. By then the file object used with wsgi.file_wrapper can have been
closed and underlying file descriptor will not longer be valid. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=132">http://code.google.com/p/modwsgi/issues/detail?id=132</a></div></blockquote>
<p>6. Modify how daemon process shutdown request is detected such that no need
to block signals in request threads. Doing this caused problems in
processes which were run from daemon mode process and which needed to be
able to receive signals. New mechanism uses a internal pipe to which signal
handler writes a character, with main thread performing a poll on pipe
waiting for that character to know when to shutdown. For additional details
see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=87">http://code.google.com/p/modwsgi/issues/detail?id=87</a></div></blockquote>
<p>7. Fix bug where excessive transient memory usage could occur when calling
read() or readline() on wsgi.input with no argument. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=126">http://code.google.com/p/modwsgi/issues/detail?id=126</a></div></blockquote>
<p>Note that calling read() with no argument is actually a violation of WSGI
specification and any application doing that is not a WSGI compliant
application.</p>
<p>8. Fix bug where daemon process would crash if User/Group directives were
not specified prior to WSGIDaemonProcess in Apache configuration file. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=40">http://code.google.com/p/modwsgi/issues/detail?id=40</a></div></blockquote>
<p>9. Fix bug whereby Python exception state wasn&#8217;t being cleared correctly
when error occurred in loading target of WSGIImportScript. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=117">http://code.google.com/p/modwsgi/issues/detail?id=117</a></div></blockquote>
</div>
<div class="section" id="features-changed">
<h2>Features Changed<a class="headerlink" href="#features-changed" title="Permalink to this headline">¶</a></h2>
<p>1. No longer populate &#8216;error-notes&#8217; field in Apache request object notes
table, with details of why WSGI script failed. This has been removed as
information can be seen in default Apache multilanguage error documents.
Because errors may list paths or user/group information, could be seen as
a security risk.</p>
</div>
<div class="section" id="features-added">
<h2>Features Added<a class="headerlink" href="#features-added" title="Permalink to this headline">¶</a></h2>
<p>1. Added &#8216;mod_wsgi.version&#8217; to WSGI environment passed to WSGI application.
For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=93">http://code.google.com/p/modwsgi/issues/detail?id=93</a></div></blockquote>
<p>2. Added &#8216;process_group&#8217; and &#8216;application_group&#8217; attributes to mod_wsgi module
that is created within each Python interpreter instance. This allows code
executed outside of the context of a request handler to know whether it is
running in a daemon process group and what it may be called. Similarly, can
determine if running in first interpreter or some other sub interpreter.
For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=27">http://code.google.com/p/modwsgi/issues/detail?id=27</a></div></blockquote>
<p>3. Added closed and isatty attributes to Log object as well as close() method.
For wsgi.errors these aren&#8217;t required, but log object also used for stderr
and stdout (when enabled) and code may assume these methods may exist for
stderr and stdout. The closed and isatty attributes always yield false and
close() will raise a run time error indicating that log cannot be closed.
For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=82">http://code.google.com/p/modwsgi/issues/detail?id=82</a></div></blockquote>
<p>4. Apache scoreboard cleaned up when daemon processes first initialised to
prevent any user code interfering with operation of Apache. For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=104">http://code.google.com/p/modwsgi/issues/detail?id=104</a></div></blockquote>
<p>5. When running configure script, can now supply additional options for
CPPFLAGS, LDFLAGS and LDLIBS through environment variables. For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=107">http://code.google.com/p/modwsgi/issues/detail?id=107</a></div></blockquote>
<p>6. Better checking done on response headers and an explicit error will now
be produce if name or value of response header contains an embedded newline.
This is done as by allowing embedded newline would cause daemon mode to fail
when handing response in Apache child process. In embedded mode, could allow
application to pass back malformed response headers to client. For details
see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=81">http://code.google.com/p/modwsgi/issues/detail?id=81</a></div></blockquote>
<p>7: Ensure that SYSLIBS linker options from Python configuration used when
linking mod_wsgi Apache module. This is now prooving necessary as some Apache
distributions are no longer linking system maths library and Python requires
it. To avoid problem simply link against mod_wsgi Apache module and system
libraries that Python needs. For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=115">http://code.google.com/p/modwsgi/issues/detail?id=115</a></div></blockquote>
<p>8: Reorder sys.path after having called site.addsitedir() in WSGIPythonPath
and python-path option for WSGIDaemonProcess. This ensures that newly added
directories get moved to front of sys.path and that they take precedence over
standard directories. This in part avoids need to ensure &#8211;no-site-packages
option used when creating virtual environments, as shouldn&#8217;t have an issue
with standard directories still overriding additions. For details see:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=112">http://code.google.com/p/modwsgi/issues/detail?id=112</a></div></blockquote>
<p>9. Update USER, USERNAME and LOGNAME environment variables if set in
daemon process to be the actual user that the process runs as rather than
what may be inherited from Apache root process, which would typically be
&#8216;root&#8217; or the user that executed &#8216;sudo&#8217; to start Apache, if they hadn&#8217;t
used &#8216;-H&#8217; option to &#8216;sudo&#8217;. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=129">http://code.google.com/p/modwsgi/issues/detail?id=129</a></div></blockquote>
<p>10. Build process now inserts what is believed to be the directory where
Python shared library is installed, into the library search path before the
Python config directory. This should negate the need to ensure that Python
shared library is also symlink into the config directory next to the static
library as linkers would normally expect it. See:</p>
<blockquote>
<div><a class="reference external" href="http://code.google.com/p/modwsgi/issues/detail?id=136">http://code.google.com/p/modwsgi/issues/detail?id=136</a></div></blockquote>
</div>
</div>

</div>
           <div class="articleComments">
            
           </div>
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="version-2.3.html" class="btn btn-neutral float-right" title="Version 2.3" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="version-2.5.html" class="btn btn-neutral" title="Version 2.5" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>

<hr/>

</p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.

</footer>

</div>
      </div>

</section>

</div>

</body>
</html>