passenger 2.2.8 → 2.2.9

data/NEWS

@@ -1,3 +1,59 @@
+Release 2.2.9
+-------------
+
+ * Fixed compatibility with Rails 3.
+   Actually, previous Phusion Passenger releases were already compatible
+   with Rails 3, depending on the spawn method that would be invoked. Here's
+   the story:
+   
+   Since Phusion Passenger 2.2.8, when the file config.ru exists, Phusion
+   Passenger will treat the app as a Rack app, not as a Rails app. This is
+   in contrast to earlier versions which gave Rails detection more priority
+   than Rack detection. Phusion Passenger loads Rack apps and Rails apps in
+   different ways. The Rails loader was not compatible with Rails 3, which
+   is what we've fixed in this release.
+   
+   That said, a Rails 3 app would have worked out-of-the-box on Phusion
+   Passenger 2.2.8 as well because Rails 3 apps include a config.ru file
+   by default, causing Phusion Passenger 2.2.8 to use the Rack loader.
+   Earlier versions of Phusion Passenger would just completely bail out
+   because they'd use the Rails loader.
+   
+   That said, with 2.2.9 there are still some caveats:
+   - Smart spawning (the mechanism with which REE's 33% memory reduction
+     is implemented) is *not* supported for Rack apps. This means that if
+     you want to utilize smart spawning with Rails 3, then you should
+     remove your config.ru file.
+   - Rails 3 depends on Rack 1.1.0. You must have Rack 1.1.0 installed as
+     a gem, even if you've bundled it with the gem bundler. This is because
+     Phusion Passenger itself depends on Rack.
+   
+   Both of these caveats are temporary. We have plans to solve both of these
+   properly in the future.
+ * What's up with the Gem Bundler?
+   There has been some reports that Phusion Passenger is not compatible with
+   Yehuda Katz's gem bundler (http://github.com/wycats/bundler). This might
+   have been true for an earlier version of the gem bundler, but the latest
+   version seems to work fine. Please note that you need to insert the
+   following snippet in config/preinitializer.rb, as instructed by the gem
+   bundler's README:
+   
+     require "#{RAILS_ROOT}/vendor/gems/environment"
+   
+   The Rails::Boot monkey patching code as posted at
+   http://yehudakatz.com/2009/11/03/using-the-new-gem-bundler-today/
+   does not seem to be required anymore.
+ * Fixed support for ActiveRecord subclasses that connect to another database.
+   ActiveRecord subclasses that connect to a database other than the default
+   one did not have their connection correctly cleared after forking.
+   This can result in weird errors along the lines of "Lost connection to
+   MySQL server during query". Issue #429.
+ * [Nginx] Fixed PCRE URL.
+   passenger-install-nginx-module downloads PCRE 7.8 if PCRE is not already
+   installed. However PCRE 7.8 has been removed from their FTP server,
+   so we've updated the URL to point to the latest version, 8.0.
+
+
 Release 2.2.8
 -------------
 

data/bin/passenger-install-nginx-module

@@ -149,8 +149,8 @@ private
 		new_screen
 		color_puts "<banner>PCRE (required by Nginx) not installed, downloading it...</banner>"
 		
-		basename = "pcre-7.8.tar.gz"
-		dirname = "pcre-7.8"
+		basename = "pcre-8.00.tar.gz"
+		dirname = "pcre-8.00"
 		url = "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/#{basename}"
 		File.unlink("/tmp/#{basename}") rescue nil
 		FileUtils.rm_rf("/tmp/#{dirname}")

data/doc/Users guide Apache.html

@@ -3425,7 +3425,20 @@ Passenger is creating a new worker process. Phusion Passenger provides the API
 call <tt>PhusionPassenger.on_event(:starting_worker_process)</tt> to do so. So you
 could insert the following code in your <em>environment.rb</em>:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            <span style="color: #990000">...</span> code to reestablish socket connections here <span style="color: #990000">...</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <div class="paragraph"><p>Note that Phusion Passenger automatically reestablishes the connection to the
 database upon creating a new worker process, which is why you normally do not
 encounter any database issues when using smart spawning mode.</p></div>
@@ -3505,7 +3518,20 @@ Memcached is forced to handle this as an error.</p></div>
 <div class="paragraph"><p>Worker process 2 now has its own, separate communication channel with Memcached.
 The code in <em>environment.rb</em> looks like this:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            reestablish_connection_to_memcached
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <h4 id="_example_2_log_file_sharing_not_harmful">12.3.2. Example 2: Log file sharing (not harmful)</h4>
 <div class="paragraph"><p>There are also cases in which unintential file descriptor sharing is not harmful.
 One such case is log file file descriptor sharing. Even if two processes write
@@ -3522,7 +3548,20 @@ then those threads will no longer be running in newly created worker process.
 You need to revive them when a new worker process is created. Use the
 <tt>:starting_worker_process</tt> event that Phusion Passenger provides, like this:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            <span style="color: #990000">...</span> code to revive threads here <span style="color: #990000">...</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <h3 id="_smart_spawning_gotcha_3_code_load_order">12.5. Smart spawning gotcha #3: code load order</h3>
 <div class="paragraph"><p>This gotcha is only applicable to the <em>smart</em> spawn method, not the <em>smart-lv2</em>
 spawn method.</p></div>
@@ -3542,7 +3581,7 @@ has no effect.</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2009-12-15 11:58:38 PDT
+Last updated 2010-01-08 11:24:06 CEST
 </div>
 </div>
 </body>

data/doc/Users guide Nginx.html

@@ -2103,7 +2103,20 @@ Passenger is creating a new worker process. Phusion Passenger provides the API
 call <tt>PhusionPassenger.on_event(:starting_worker_process)</tt> to do so. So you
 could insert the following code in your <em>environment.rb</em>:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            <span style="color: #990000">...</span> code to reestablish socket connections here <span style="color: #990000">...</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <div class="paragraph"><p>Note that Phusion Passenger automatically reestablishes the connection to the
 database upon creating a new worker process, which is why you normally do not
 encounter any database issues when using smart spawning mode.</p></div>
@@ -2183,7 +2196,20 @@ Memcached is forced to handle this as an error.</p></div>
 <div class="paragraph"><p>Worker process 2 now has its own, separate communication channel with Memcached.
 The code in <em>environment.rb</em> looks like this:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            reestablish_connection_to_memcached
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <h4 id="_example_2_log_file_sharing_not_harmful">10.3.2. Example 2: Log file sharing (not harmful)</h4>
 <div class="paragraph"><p>There are also cases in which unintential file descriptor sharing is not harmful.
 One such case is log file file descriptor sharing. Even if two processes write
@@ -2200,7 +2226,20 @@ then those threads will no longer be running in newly created worker process.
 You need to revive them when a new worker process is created. Use the
 <tt>:starting_worker_process</tt> event that Phusion Passenger provides, like this:</p></div>
 <div class="listingblock">
-<div class="content"></div></div>
+<div class="content"><!-- Generator: GNU source-highlight 2.11.1
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre><tt><span style="font-weight: bold"><span style="color: #0000FF">if</span></span> <span style="font-weight: bold"><span style="color: #0000FF">defined</span></span><span style="color: #990000">?(</span>PhusionPassenger<span style="color: #990000">)</span>
+    PhusionPassenger<span style="color: #990000">.</span>on_event<span style="color: #990000">(:</span>starting_worker_process<span style="color: #990000">)</span> <span style="font-weight: bold"><span style="color: #0000FF">do</span></span> <span style="color: #990000">|</span>forked<span style="color: #990000">|</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">if</span></span> forked
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in smart spawning mode.</span></span>
+            <span style="color: #990000">...</span> code to revive threads here <span style="color: #990000">...</span>
+        <span style="font-weight: bold"><span style="color: #0000FF">else</span></span>
+            <span style="font-style: italic"><span style="color: #9A1900"># We're in conservative spawning mode. We don't need to do anything.</span></span>
+        <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+    <span style="font-weight: bold"><span style="color: #0000FF">end</span></span>
+<span style="font-weight: bold"><span style="color: #0000FF">end</span></span></tt></pre></div></div>
 <h3 id="_smart_spawning_gotcha_3_code_load_order">10.5. Smart spawning gotcha #3: code load order</h3>
 <div class="paragraph"><p>This gotcha is only applicable to the <em>smart</em> spawn method, not the <em>smart-lv2</em>
 spawn method.</p></div>
@@ -2220,7 +2259,7 @@ has no effect.</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2009-12-15 11:58:38 PDT
+Last updated 2010-01-08 11:24:06 CEST
 </div>
 </div>
 </body>

data/doc/cxxapi/Bucket_8h-source.html

@@ -107,7 +107,7 @@
 <a name="l00086"></a>00086 
 <a name="l00087"></a>00087 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_BUCKET_H_ */</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/Configuration_8h-source.html

@@ -425,7 +425,7 @@
 <a name="l00404"></a>00404 
 <a name="l00405"></a>00405 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_CONFIGURATION_H_ */</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/DirectoryMapper_8h-source.html

@@ -316,7 +316,7 @@
 <a name="l00295"></a>00295 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_DIRECTORY_MAPPER_H_ */</span>
 <a name="l00296"></a>00296 
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/Hooks_8h-source.html

@@ -65,7 +65,7 @@
 <a name="l00044"></a>00044 <span class="preprocessor"></span>
 <a name="l00045"></a>00045 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_HOOKS_H_ */</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/annotated.html

@@ -27,7 +27,7 @@
   <tr><td class="indexkey"><a class="el" href="classHooks.html">Hooks</a></td><td class="indexvalue">Apache hook functions, wrapped in a class </td></tr>
 </table>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/classHooks-members.html

@@ -28,7 +28,7 @@
   <tr class="memlist"><td><a class="el" href="classHooks.html#d6cca64be8a9075b4b92efdb4d9020a5">startBlockingModAutoIndex</a>(request_rec *r)</td><td><a class="el" href="classHooks.html">Hooks</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classHooks.html#e3091c57c95b2f8269f566099802f0ec">startBlockingModDir</a>(request_rec *r)</td><td><a class="el" href="classHooks.html">Hooks</a></td><td><code> [inline]</code></td></tr>
 </table></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/classHooks.html

@@ -148,7 +148,7 @@ So in <a class="el" href="classHooks.html#e3091c57c95b2f8269f566099802f0ec" titl
 <hr>The documentation for this class was generated from the following file:<ul>
 <li>Hooks.cpp</ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html

@@ -30,7 +30,7 @@
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#f5091e3cef3878e160e5d3b2181d82fb">getEnvironment</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#ef969f27622fb215990a870076648aa1">getPublicDirectory</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
 </table></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html

@@ -251,7 +251,7 @@ Returns an empty string if the document root of the HTTP request cannot be deter
 <hr>The documentation for this class was generated from the following file:<ul>
 <li><a class="el" href="DirectoryMapper_8h-source.html">DirectoryMapper.h</a></ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/classes.html

@@ -28,7 +28,7 @@
 </td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">DirectoryMapper</a> (Passenger)&nbsp;&nbsp;&nbsp;</td><td><a name="letter_H"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&nbsp;&nbsp;H&nbsp;&nbsp;</div></td></tr></table>
 </td><td><a class="el" href="classHooks.html">Hooks</a>&nbsp;&nbsp;&nbsp;</td></tr></table><p><div class="qindex"><a class="qindex" href="#letter_D">D</a>&nbsp;|&nbsp;<a class="qindex" href="#letter_H">H</a></div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/definitions_8h-source.html

@@ -25,7 +25,7 @@
 <a name="l00004"></a>00004 <span class="comment">@defgroup Support Apache-independent support classes and function</span>
 <a name="l00005"></a>00005 <span class="comment">*/</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/files.html

@@ -29,7 +29,7 @@
   <tr><td class="indexkey"><b>Hooks.h</b> <a href="Hooks_8h-source.html">[code]</a></td><td class="indexvalue"></td></tr>
 </table>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/functions.html

@@ -53,7 +53,7 @@ Here is a list of all documented class members with links to the class documenta
 : <a class="el" href="classHooks.html#e3091c57c95b2f8269f566099802f0ec">Hooks</a>
 </ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/functions_func.html

@@ -53,7 +53,7 @@
 : <a class="el" href="classHooks.html#e3091c57c95b2f8269f566099802f0ec">Hooks</a>
 </ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/graph_legend.html

@@ -79,7 +79,7 @@ A purple dashed arrow is used if a class is contained or used by another class.
 A yellow dashed arrow denotes a relation between a template instance and the template class it was instantiated from. The arrow is labeled with the template parameters of the instance. </li>
 </ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/group__Configuration.html

@@ -204,7 +204,7 @@ Apache module commands array.
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/group__Core.html

@@ -41,7 +41,7 @@ Collaboration diagram for Core Apache-related classes and functions:</div>
 
 </table>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/group__Hooks.html

@@ -32,7 +32,7 @@ Collaboration diagram for Apache hooks:</div>
 <tr><td></td></tr>
 </table>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/group__Support.html

@@ -20,7 +20,7 @@
 <tr><td></td></tr>
 </table>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/main.html

@@ -19,7 +19,7 @@
 <h1>Passenger Documentation</h1>
 <p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:56 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/cxxapi/modules.html

@@ -25,7 +25,7 @@
 <li><a class="el" href="group__Support.html">Apache-independent support classes and function</a>
 </ul>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Dec 15 17:41:30 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 8 11:42:57 2010 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>

data/doc/rdoc/classes/PhusionPassenger.html

@@ -135,7 +135,7 @@ Class <a href="PhusionPassenger/VersionNotFound.html" class="link">PhusionPassen
   <tr valign='top'>
     <td class="attr-name">VERSION_STRING</td>
     <td>=</td>
-    <td class="attr-value">'2.2.8'</td>
+    <td class="attr-value">'2.2.9'</td>
   </tr>
   <tr valign='top'>
     <td>&nbsp;</td>

data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html

@@ -0,0 +1,247 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Class: PhusionPassenger::Utils::RewindableInput</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+        function toggleSource( id )
+        {
+          var elem
+          var link
+
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
+        }
+      // ]]>
+    </script>
+  </head>
+
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::Utils::RewindableInput</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../files/lib/phusion_passenger/utils/rewindable_input_rb.html">lib/phusion_passenger/utils/rewindable_input.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+Object
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+
+  <div id="bodyContent">
+      <div id="content">
+
+  <div class="description"><p>
+Class which can make any <a href="../../IO.html">IO</a> object rewindable,
+including non-rewindable ones. It does this by buffering the data into a
+tempfile, which is rewindable.
+</p>
+<p>
+rack.input is required to be rewindable, so if your input stream <a
+href="../../IO.html">IO</a> is non-rewindable by nature (e.g. a pipe or a
+socket) then you can wrap it in an object of this class to easily make it
+rewindable.
+</p>
+<p>
+Don&#8216;t forget to call <a
+href="RewindableInput.html#M000100">#close</a> when you&#8216;re done. This
+frees up temporary resources that <a
+href="RewindableInput.html">RewindableInput</a> uses, though it does
+<b>not</b> <a href="RewindableInput.html#M000100">close</a> the original <a
+href="../../IO.html">IO</a> object.
+</p>
+</div>
+
+
+
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000100">close</a></li>
+  <li><a href="#M000098">each</a></li>
+  <li><a href="#M000096">gets</a></li>
+  <li><a href="#M000095">new</a></li>
+  <li><a href="#M000097">read</a></li>
+  <li><a href="#M000099">rewind</a></li>
+  </ul>
+
+
+
+  <div class="sectiontitle">Classes and Modules</div>
+  Class <a href="RewindableInput/Tempfile.html" class="link">PhusionPassenger::Utils::RewindableInput::Tempfile</a><br />
+
+
+
+
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000095"></a><b>new</b>(io)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000095_source')" id="l_M000095_source">show source</a> ]</p>
+  <div id="M000095_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 18</span>
+18:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">io</span>)
+19:       <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</span>
+20:       <span class="ruby-ivar">@rewindable_io</span> = <span class="ruby-keyword kw">nil</span>
+21:       <span class="ruby-ivar">@unlinked</span> = <span class="ruby-keyword kw">false</span>
+22:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000100"></a><b>close</b>()
+  </div>
+  <div class="description">
+  <p>
+Closes this <a href="RewindableInput.html">RewindableInput</a> object
+without closing the originally wrapped <a href="../../IO.html">IO</a>
+oject. Cleans up any temporary resources that this <a
+href="RewindableInput.html">RewindableInput</a> has created.
+</p>
+<p>
+This method may be called multiple times. It does nothing on subsequent
+calls.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000100_source')" id="l_M000100_source">show source</a> ]</p>
+  <div id="M000100_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 49</span>
+49:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
+50:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@rewindable_io</span>
+51:         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@unlinked</span>
+52:           <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">close</span>
+53:         <span class="ruby-keyword kw">else</span>
+54:           <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">close!</span>
+55:         <span class="ruby-keyword kw">end</span>
+56:         <span class="ruby-ivar">@rewindable_io</span> = <span class="ruby-keyword kw">nil</span>
+57:       <span class="ruby-keyword kw">end</span>
+58:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000098"></a><b>each</b>(&amp;block)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000098_source')" id="l_M000098_source">show source</a> ]</p>
+  <div id="M000098_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 34</span>
+34:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+35:       <span class="ruby-identifier">make_rewindable</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@rewindable_io</span>
+36:       <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+37:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000096"></a><b>gets</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000096_source')" id="l_M000096_source">show source</a> ]</p>
+  <div id="M000096_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 24</span>
+24:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">gets</span>
+25:       <span class="ruby-identifier">make_rewindable</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@rewindable_io</span>
+26:       <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">gets</span>
+27:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000097"></a><b>read</b>(*args)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000097_source')" id="l_M000097_source">show source</a> ]</p>
+  <div id="M000097_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 29</span>
+29:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+30:       <span class="ruby-identifier">make_rewindable</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@rewindable_io</span>
+31:       <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+32:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000099"></a><b>rewind</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000099_source')" id="l_M000099_source">show source</a> ]</p>
+  <div id="M000099_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils/rewindable_input.rb, line 39</span>
+39:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rewind</span>
+40:       <span class="ruby-identifier">make_rewindable</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@rewindable_io</span>
+41:       <span class="ruby-ivar">@rewindable_io</span>.<span class="ruby-identifier">rewind</span>
+42:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>