passenger 3.0.0.pre1 → 3.0.0.pre2

data/DEVELOPERS.TXT

@@ -70,8 +70,8 @@ Less important directories:
   Man pages.
 [ misc ]
   Miscellaneous tools.
-[ misc/rake ]
-  Rake tasks.
+[ build ]
+  Rake tasks used by the build system.
 
 == Tests
 

data/NEWS

@@ -1,5 +1,5 @@
-Release 3.0.0 beta 1
---------------------
+Release 3.0.0
+-------------
 
 This is a major release with many changes. Please read our blog for details.
 

data/Rakefile

@@ -48,7 +48,7 @@ end
 
 desc "Remove compiled files"
 task :clean do
-	sh "rm -rf .cache"
+	sh "rm -rf build/cache"
 end
 
 desc "Remove all generated files"

data/build/packaging.rb

@@ -147,7 +147,7 @@ task :fakeroot => [:apache2, :nginx] + Packaging::ASCII_DOCS do
 	sh "cp #{APACHE2_MODULE} #{fake_apache2_module_dir}/"
 	
 	sh "mkdir -p #{fake_certificates_dir}"
-	sh "cp #{CERTIFICATES_DIR}/*.crt #{fake_certificates_dir}/"
+	sh "cp misc/*.crt #{fake_certificates_dir}/"
 	
 	sh "mkdir -p #{fake_source_root}"
 	spec.files.each do |filename|

data/doc/Users guide Apache.html

@@ -2670,9 +2670,8 @@ displaying maintenance.html will work fine even for URLs starting with "/users".
 </div>
 <div class="sect2">
 <h3 id="_logging_and_debugging_options">5.13. Logging and debugging options</h3>
-</div>
-<div class="sect2">
-<h3 id="_passengerloglevel_lt_integer_gt">5.14. PassengerLogLevel &lt;integer&gt;</h3>
+<div class="sect3">
+<h4 id="_passengerloglevel_lt_integer_gt">5.13.1. PassengerLogLevel &lt;integer&gt;</h4>
 <div class="paragraph"><p>This option allows one to specify how much information Phusion Passenger should
 write to the Apache error log file. A higher log level value means that more
 information will be logged.</p></div>
@@ -2704,17 +2703,18 @@ information will be logged.</p></div>
 <div class="paragraph"><p>This option may only occur once, in the global server configuration.
 The default is <em>0</em>.</p></div>
 </div>
-<div class="sect2">
-<h3 id="_passengerdebuglogfile_lt_filename_gt">5.15. PassengerDebugLogFile &lt;filename&gt;</h3>
+<div class="sect3">
+<h4 id="_passengerdebuglogfile_lt_filename_gt">5.13.2. PassengerDebugLogFile &lt;filename&gt;</h4>
 <div class="paragraph"><p>By default Phusion Passenger debugging and error messages are written to the global
 web server error log. This option allows one to specify the file that debugging and
 error messages should be written to instead.</p></div>
 <div class="paragraph"><p>This option may only occur once, in the global server configuration.</p></div>
 </div>
+</div>
 <div class="sect2">
-<h3 id="_ruby_on_rails_specific_options">5.16. Ruby on Rails-specific options</h3>
+<h3 id="_ruby_on_rails_specific_options">5.14. Ruby on Rails-specific options</h3>
 <div class="sect3">
-<h4 id="_railsautodetect_lt_on_off_gt">5.16.1. RailsAutoDetect &lt;on|off&gt;</h4>
+<h4 id="_railsautodetect_lt_on_off_gt">5.14.1. RailsAutoDetect &lt;on|off&gt;</h4>
 <div class="paragraph"><p>Whether Phusion Passenger should automatically detect whether a virtual host&#8217;s
 document root is a Ruby on Rails application. The default is <em>on</em>.</p></div>
 <div class="paragraph"><p>This option may occur in the global server configuration or in a virtual host
@@ -2744,7 +2744,7 @@ application by using the <a href="#RailsBaseURI">RailsBaseURI</a> configuration
 </div></div>
 </div>
 <div class="sect3">
-<h4 id="RailsBaseURI">5.16.2. RailsBaseURI &lt;uri&gt;</h4>
+<h4 id="RailsBaseURI">5.14.2. RailsBaseURI &lt;uri&gt;</h4>
 <div class="paragraph"><p>Used to specify that the given URI is a Rails application. See
 <a href="#deploying_rails_to_sub_uri">Deploying Rails to a sub URI</a> for an example.</p></div>
 <div class="paragraph"><p>It is allowed to specify this option multiple times. Do this to deploy multiple
@@ -2774,7 +2774,7 @@ In <em>.htaccess</em>, if <tt>AllowOverride Options</tt> is on.
 </ul></div>
 </div>
 <div class="sect3">
-<h4 id="rails_env">5.16.3. RailsEnv &lt;string&gt;</h4>
+<h4 id="rails_env">5.14.3. RailsEnv &lt;string&gt;</h4>
 <div class="paragraph"><p>This option allows one to specify the default <tt>RAILS_ENV</tt> value.</p></div>
 <div class="paragraph"><p>This option may occur in the following places:</p></div>
 <div class="ulist"><ul>
@@ -2802,7 +2802,7 @@ In <em>.htaccess</em>, if <tt>AllowOverride Options</tt> is on.
 <div class="paragraph"><p>In each place, it may be specified at most once. The default value is <em>production</em>.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsframeworkspawneridletime_lt_integer_gt">5.16.4. RailsFrameworkSpawnerIdleTime &lt;integer&gt;</h4>
+<h4 id="_railsframeworkspawneridletime_lt_integer_gt">5.14.4. RailsFrameworkSpawnerIdleTime &lt;integer&gt;</h4>
 <div class="paragraph"><p>The FrameworkSpawner server (explained in <a href="#spawning_methods_explained">Spawning methods explained</a>) has an idle timeout, just like the backend processes spawned by
 Phusion Passenger do. That is, it will automatically shutdown if it hasn&#8217;t done
 anything for a given period.</p></div>
@@ -2831,7 +2831,7 @@ In a virtual host configuration block.
 <div class="paragraph"><p>In each place, it may be specified at most once. The default value is <em>1800</em> (30 minutes).</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsappspawneridletime_lt_integer_gt">5.16.5. RailsAppSpawnerIdleTime &lt;integer&gt;</h4>
+<h4 id="_railsappspawneridletime_lt_integer_gt">5.14.5. RailsAppSpawnerIdleTime &lt;integer&gt;</h4>
 <div class="paragraph"><p>The ApplicationSpawner server (explained in <a href="#spawning_methods_explained">Spawning methods explained</a>) has an idle timeout, just like the backend processes spawned by
 Phusion Passenger do. That is, it will automatically shutdown if it hasn&#8217;t done
 anything for a given period.</p></div>
@@ -2861,9 +2861,9 @@ In a virtual host configuration block.
 </div>
 </div>
 <div class="sect2">
-<h3 id="_rack_specific_options">5.17. Rack-specific options</h3>
+<h3 id="_rack_specific_options">5.15. Rack-specific options</h3>
 <div class="sect3">
-<h4 id="_rackautodetect_lt_on_off_gt">5.17.1. RackAutoDetect &lt;on|off&gt;</h4>
+<h4 id="_rackautodetect_lt_on_off_gt">5.15.1. RackAutoDetect &lt;on|off&gt;</h4>
 <div class="paragraph"><p>Whether Phusion Passenger should automatically detect whether a virtual host&#8217;s
 document root is a Rack application. The default is <em>on</em>.</p></div>
 <div class="paragraph"><p>This option may occur in the global server configuration or in a virtual host
@@ -2893,7 +2893,7 @@ application by using the <a href="#RackBaseURI">RackBaseURI</a> configuration op
 </div></div>
 </div>
 <div class="sect3">
-<h4 id="RackBaseURI">5.17.2. RackBaseURI &lt;uri&gt;</h4>
+<h4 id="RackBaseURI">5.15.2. RackBaseURI &lt;uri&gt;</h4>
 <div class="paragraph"><p>Used to specify that the given URI is a Rack application. See
 <a href="#deploying_rack_to_sub_uri">Deploying Rack to a sub URI</a> for an example.</p></div>
 <div class="paragraph"><p>It is allowed to specify this option multiple times. Do this to deploy multiple
@@ -2923,7 +2923,7 @@ In <em>.htaccess</em>, if <tt>AllowOverride Options</tt> is on.
 </ul></div>
 </div>
 <div class="sect3">
-<h4 id="rack_env">5.17.3. RackEnv &lt;string&gt;</h4>
+<h4 id="rack_env">5.15.3. RackEnv &lt;string&gt;</h4>
 <div class="paragraph"><p>The given value will be accessible in Rack applications in the <tt>RACK_ENV</tt>
 environment variable. This allows one to define the environment in which
 Rack applications are run, very similar to <tt>RAILS_ENV</tt>.</p></div>
@@ -2954,27 +2954,27 @@ In <em>.htaccess</em>, if <tt>AllowOverride Options</tt> is on.
 </div>
 </div>
 <div class="sect2">
-<h3 id="_deprecated_options">5.18. Deprecated options</h3>
+<h3 id="_deprecated_options">5.16. Deprecated options</h3>
 <div class="paragraph"><p>The following options have been deprecated, but are still supported for backwards
 compatibility reasons.</p></div>
 <div class="sect3">
-<h4 id="_railsruby">5.18.1. RailsRuby</h4>
+<h4 id="_railsruby">5.16.1. RailsRuby</h4>
 <div class="paragraph"><p>Deprecated in favor of <a href="#PassengerRuby">PassengerRuby</a>.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsuserswitching">5.18.2. RailsUserSwitching</h4>
+<h4 id="_railsuserswitching">5.16.2. RailsUserSwitching</h4>
 <div class="paragraph"><p>Deprecated in favor of <a href="#PassengerUserSwitching">PassengerUserSwitching</a>.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsdefaultuser">5.18.3. RailsDefaultUser</h4>
+<h4 id="_railsdefaultuser">5.16.3. RailsDefaultUser</h4>
 <div class="paragraph"><p>Deprecated in favor of <a href="#PassengerDefaultUser">PassengerDefaultUser</a>.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsallowmodrewrite">5.18.4. RailsAllowModRewrite</h4>
+<h4 id="_railsallowmodrewrite">5.16.4. RailsAllowModRewrite</h4>
 <div class="paragraph"><p>This option doesn&#8217;t do anything anymore in recent versions of Phusion Passenger.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_railsspawnmethod">5.18.5. RailsSpawnMethod</h4>
+<h4 id="_railsspawnmethod">5.16.5. RailsSpawnMethod</h4>
 <div class="paragraph"><p>Deprecated in favor of <a href="#PassengerSpawnMethod">PassengerSpawnMethod</a>.</p></div>
 </div>
 </div>
@@ -4476,7 +4476,7 @@ has no effect.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-09-14 15:23:30 CEST
+Last updated 2010-09-15 16:19:46 CEST
 </div>
 </div>
 </body>

data/doc/Users guide Apache.txt

@@ -1523,7 +1523,7 @@ displaying maintenance.html will work fine even for URLs starting with "/users".
 
 === Logging and debugging options ===
 
-=== PassengerLogLevel <integer> ===
+==== PassengerLogLevel <integer> ====
 This option allows one to specify how much information Phusion Passenger should
 write to the Apache error log file. A higher log level value means that more
 information will be logged.
@@ -1540,7 +1540,7 @@ Possible values are:
 This option may only occur once, in the global server configuration.
 The default is '0'.
 
-=== PassengerDebugLogFile <filename> ===
+==== PassengerDebugLogFile <filename> ====
 By default Phusion Passenger debugging and error messages are written to the global
 web server error log. This option allows one to specify the file that debugging and
 error messages should be written to instead.

data/doc/Users guide Nginx.html

@@ -2240,9 +2240,8 @@ the request ending up at a different web server in the cluster.</p></div>
 </div>
 <div class="sect2">
 <h3 id="_logging_and_debugging_options">5.8. Logging and debugging options</h3>
-</div>
-<div class="sect2">
-<h3 id="_passenger_log_level_lt_integer_gt">5.9. passenger_log_level &lt;integer&gt;</h3>
+<div class="sect3">
+<h4 id="_passenger_log_level_lt_integer_gt">5.8.1. passenger_log_level &lt;integer&gt;</h4>
 <div class="paragraph"><p>This option allows one to specify how much information Phusion Passenger should
 write to the Nginx error log file. A higher log level value means that more
 information will be logged.</p></div>
@@ -2274,17 +2273,18 @@ information will be logged.</p></div>
 <div class="paragraph"><p>This option may only occur once, in the <em>http</em> configuration block.
 The default is <em>0</em>.</p></div>
 </div>
-<div class="sect2">
-<h3 id="_passenger_debug_log_file_lt_filename_gt">5.10. passenger_debug_log_file &lt;filename&gt;</h3>
+<div class="sect3">
+<h4 id="_passenger_debug_log_file_lt_filename_gt">5.8.2. passenger_debug_log_file &lt;filename&gt;</h4>
 <div class="paragraph"><p>By default Phusion Passenger debugging and error messages are written to the global
 web server error log. This option allows one to specify the file that debugging and
 error messages should be written to instead.</p></div>
 <div class="paragraph"><p>This option may only occur once, in the <em>http</em> configuration block.</p></div>
 </div>
+</div>
 <div class="sect2">
-<h3 id="_ruby_on_rails_specific_options">5.11. Ruby on Rails-specific options</h3>
+<h3 id="_ruby_on_rails_specific_options">5.9. Ruby on Rails-specific options</h3>
 <div class="sect3">
-<h4 id="RailsEnv">5.11.1. rails_env &lt;string&gt;</h4>
+<h4 id="RailsEnv">5.9.1. rails_env &lt;string&gt;</h4>
 <div class="paragraph"><p>This option allows one to specify the default <tt>RAILS_ENV</tt> value.</p></div>
 <div class="paragraph"><p>This option may occur in the following places:</p></div>
 <div class="ulist"><ul>
@@ -2312,7 +2312,7 @@ In an <em>if</em> configuration scope.
 <div class="paragraph"><p>In each place, it may be specified at most once. The default value is <em>production</em>.</p></div>
 </div>
 <div class="sect3">
-<h4 id="_rails_framework_spawner_idle_time_lt_integer_gt">5.11.2. rails_framework_spawner_idle_time &lt;integer&gt;</h4>
+<h4 id="_rails_framework_spawner_idle_time_lt_integer_gt">5.9.2. rails_framework_spawner_idle_time &lt;integer&gt;</h4>
 <div class="paragraph"><p>The FrameworkSpawner server (explained in <a href="#spawning_methods_explained">Spawning methods explained</a>) has an idle timeout, just like the backend processes spawned by
 Phusion Passenger do. That is, it will automatically shutdown if it hasn&#8217;t done
 anything for a given period.</p></div>
@@ -2351,7 +2351,7 @@ In an <em>if</em> configuration scope.
 <div class="paragraph"><p>In each place, it may be specified at most once. The default value is <em>1800</em> (30 minutes).</p></div>
 </div>
 <div class="sect3">
-<h4 id="_rails_app_spawner_idle_time_lt_integer_gt">5.11.3. rails_app_spawner_idle_time &lt;integer&gt;</h4>
+<h4 id="_rails_app_spawner_idle_time_lt_integer_gt">5.9.3. rails_app_spawner_idle_time &lt;integer&gt;</h4>
 <div class="paragraph"><p>The ApplicationSpawner server (explained in <a href="#spawning_methods_explained">Spawning methods explained</a>) has an idle timeout, just like the backend processes spawned by
 Phusion Passenger do. That is, it will automatically shutdown if it hasn&#8217;t done
 anything for a given period.</p></div>
@@ -2391,9 +2391,9 @@ In an <em>if</em> configuration scope.
 </div>
 </div>
 <div class="sect2">
-<h3 id="_rack_specific_options">5.12. Rack-specific options</h3>
+<h3 id="_rack_specific_options">5.10. Rack-specific options</h3>
 <div class="sect3">
-<h4 id="RackEnv">5.12.1. rack_env &lt;string&gt;</h4>
+<h4 id="RackEnv">5.10.1. rack_env &lt;string&gt;</h4>
 <div class="paragraph"><p>This option allows one to specify the default <tt>RACK_ENV</tt> value.</p></div>
 <div class="paragraph"><p>This option may occur in the following places:</p></div>
 <div class="ulist"><ul>
@@ -2422,11 +2422,11 @@ In an <em>if</em> configuration scope.
 </div>
 </div>
 <div class="sect2">
-<h3 id="_deprecated_options">5.13. Deprecated options</h3>
+<h3 id="_deprecated_options">5.11. Deprecated options</h3>
 <div class="paragraph"><p>The following options have been deprecated, but are still supported for backwards
 compatibility reasons.</p></div>
 <div class="sect3">
-<h4 id="_rails_spawn_method">5.13.1. rails_spawn_method</h4>
+<h4 id="_rails_spawn_method">5.11.1. rails_spawn_method</h4>
 <div class="paragraph"><p>Deprecated in favor of <a href="#PassengerSpawnMethod">passenger_spawn_method</a>.</p></div>
 </div>
 </div>
@@ -3426,7 +3426,7 @@ has no effect.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-09-14 15:23:30 CEST
+Last updated 2010-09-15 16:20:02 CEST
 </div>
 </div>
 </body>

data/doc/Users guide Nginx.txt

@@ -1218,7 +1218,8 @@ Yes. And it does not perform any certificate validation.
 
 
 === Logging and debugging options ===
-=== passenger_log_level <integer> ===
+
+==== passenger_log_level <integer> ====
 This option allows one to specify how much information Phusion Passenger should
 write to the Nginx error log file. A higher log level value means that more
 information will be logged.
@@ -1235,7 +1236,7 @@ Possible values are:
 This option may only occur once, in the 'http' configuration block.
 The default is '0'.
 
-=== passenger_debug_log_file <filename> ===
+==== passenger_debug_log_file <filename> ====
 By default Phusion Passenger debugging and error messages are written to the global
 web server error log. This option allows one to specify the file that debugging and
 error messages should be written to instead.

data/doc/Users guide Standalone.html

@@ -596,7 +596,7 @@ use the <tt>-p</tt> option, e.g.:</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-08-27 18:56:16 CEST
+Last updated 2010-09-15 07:58:46 CEST
 </div>
 </div>
 </body>

data/doc/cxxapi/Constants_8h_source.html

@@ -51,7 +51,7 @@
 <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_CONSTANTS_H_</span>
 <a name="l00027"></a>00027 <span class="preprocessor"></span>
 <a name="l00028"></a>00028 <span class="comment">/* Don&#39;t forget to update lib/phusion_passenger.rb too. */</span>
-<a name="l00029"></a>00029 <span class="preprocessor">#define PASSENGER_VERSION &quot;3.0.0.pre1&quot;</span>
+<a name="l00029"></a>00029 <span class="preprocessor">#define PASSENGER_VERSION &quot;3.0.0.pre2&quot;</span>
 <a name="l00030"></a>00030 <span class="preprocessor"></span>
 <a name="l00031"></a>00031 <span class="preprocessor">#define FEEDBACK_FD 3</span>
 <a name="l00032"></a>00032 <span class="preprocessor"></span>

data/doc/cxxapi/ResourceLocator_8h_source.html

@@ -99,7 +99,7 @@
 <a name="l00074"></a>00074                 <span class="keywordflow">if</span> (nativelyPackaged) {
 <a name="l00075"></a>00075                         <span class="keywordflow">return</span> <span class="stringliteral">&quot;/usr/share/phusion-passenger/certificates&quot;</span>;
 <a name="l00076"></a>00076                 } <span class="keywordflow">else</span> {
-<a name="l00077"></a>00077                         <span class="keywordflow">return</span> root + <span class="stringliteral">&quot;/misc/certificates&quot;</span>;
+<a name="l00077"></a>00077                         <span class="keywordflow">return</span> root + <span class="stringliteral">&quot;/misc&quot;</span>;
 <a name="l00078"></a>00078                 }
 <a name="l00079"></a>00079         }
 <a name="l00080"></a>00080 };

data/doc/rdoc/classes/ConditionVariable.html

@@ -0,0 +1,215 @@
+<?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: ConditionVariable</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 />ConditionVariable</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/phusion_passenger/utils_rb.html">lib/phusion_passenger/utils.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="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000003">timed_wait</a></li>
+  <li><a href="#M000004">timed_wait!</a></li>
+  </ul>
+
+
+
+
+
+
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000003"></a><b>timed_wait</b>(mutex, secs)
+  </div>
+  <div class="description">
+  <p>
+This is like ConditionVariable.wait(), but allows one to wait a maximum
+amount of time. Returns true if this condition was signaled, false if a
+timeout occurred.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show source</a> ]</p>
+  <div id="M000003_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 816</span>
+816:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">timed_wait</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+817:                 <span class="ruby-identifier">ruby_engine</span> = <span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">RUBY_ENGINE</span>) <span class="ruby-operator">?</span> <span class="ruby-constant">RUBY_ENGINE</span> <span class="ruby-operator">:</span> <span class="ruby-value str">&quot;ruby&quot;</span>
+818:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">100000000</span>
+819:                         <span class="ruby-comment cmt"># NOTE: If one calls timeout() on FreeBSD 5 with an</span>
+820:                         <span class="ruby-comment cmt"># argument of more than 100000000, then MRI will become</span>
+821:                         <span class="ruby-comment cmt"># stuck in an infite loop, blocking all threads. It seems</span>
+822:                         <span class="ruby-comment cmt"># that MRI uses select() to implement sleeping.</span>
+823:                         <span class="ruby-comment cmt"># I think that a value of more than 100000000 overflows</span>
+824:                         <span class="ruby-comment cmt"># select()'s data structures, causing it to behave incorrectly.</span>
+825:                         <span class="ruby-comment cmt"># So we just make sure we can't sleep more than 100000000</span>
+826:                         <span class="ruby-comment cmt"># seconds.</span>
+827:                         <span class="ruby-identifier">secs</span> = <span class="ruby-value">100000000</span>
+828:                 <span class="ruby-keyword kw">end</span>
+829:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ruby_engine</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;jruby&quot;</span>
+830:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+831:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+832:                         <span class="ruby-keyword kw">else</span>
+833:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+834:                         <span class="ruby-keyword kw">end</span>
+835:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-constant">RUBY_VERSION</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value str">'1.9.2'</span>
+836:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+837:                                 <span class="ruby-identifier">t1</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>
+838:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+839:                                 <span class="ruby-identifier">t2</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>
+840:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">t2</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">t1</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">secs</span>
+841:                         <span class="ruby-keyword kw">else</span>
+842:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+843:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+844:                         <span class="ruby-keyword kw">end</span>
+845:                 <span class="ruby-keyword kw">else</span>
+846:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+847:                                 <span class="ruby-constant">Timeout</span>.<span class="ruby-identifier">timeout</span>(<span class="ruby-identifier">secs</span>) <span class="ruby-keyword kw">do</span>
+848:                                         <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+849:                                 <span class="ruby-keyword kw">end</span>
+850:                         <span class="ruby-keyword kw">else</span>
+851:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+852:                         <span class="ruby-keyword kw">end</span>
+853:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+854:                 <span class="ruby-keyword kw">end</span>
+855:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-constant">Error</span>
+856:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+857:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000004"></a><b>timed_wait!</b>(mutex, secs)
+  </div>
+  <div class="description">
+  <p>
+This is like ConditionVariable.wait(), but allows one to wait a maximum
+amount of time. Raises Timeout::Error if the timeout has elapsed.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000004_source')" id="l_M000004_source">show source</a> ]</p>
+  <div id="M000004_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 861</span>
+861:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">timed_wait!</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+862:                 <span class="ruby-identifier">ruby_engine</span> = <span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">RUBY_ENGINE</span>) <span class="ruby-operator">?</span> <span class="ruby-constant">RUBY_ENGINE</span> <span class="ruby-operator">:</span> <span class="ruby-value str">&quot;ruby&quot;</span>
+863:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">100000000</span>
+864:                         <span class="ruby-comment cmt"># See the corresponding note for timed_wait().</span>
+865:                         <span class="ruby-identifier">secs</span> = <span class="ruby-value">100000000</span>
+866:                 <span class="ruby-keyword kw">end</span>
+867:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ruby_engine</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;jruby&quot;</span>
+868:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+869:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+870:                                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-constant">Error</span>, <span class="ruby-value str">&quot;Timeout&quot;</span>
+871:                                 <span class="ruby-keyword kw">end</span>
+872:                         <span class="ruby-keyword kw">else</span>
+873:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+874:                         <span class="ruby-keyword kw">end</span>
+875:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-constant">RUBY_VERSION</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value str">'1.9.2'</span>
+876:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+877:                                 <span class="ruby-identifier">t1</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>
+878:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>, <span class="ruby-identifier">secs</span>)
+879:                                 <span class="ruby-identifier">t2</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>
+880:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">t2</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">t1</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">secs</span>
+881:                                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">Timeout</span><span class="ruby-operator">::</span><span class="ruby-constant">Error</span>, <span class="ruby-value str">&quot;Timeout&quot;</span>
+882:                                 <span class="ruby-keyword kw">end</span>
+883:                         <span class="ruby-keyword kw">else</span>
+884:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+885:                         <span class="ruby-keyword kw">end</span>
+886:                 <span class="ruby-keyword kw">else</span>
+887:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">secs</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+888:                                 <span class="ruby-constant">Timeout</span>.<span class="ruby-identifier">timeout</span>(<span class="ruby-identifier">secs</span>) <span class="ruby-keyword kw">do</span>
+889:                                         <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+890:                                 <span class="ruby-keyword kw">end</span>
+891:                         <span class="ruby-keyword kw">else</span>
+892:                                 <span class="ruby-identifier">wait</span>(<span class="ruby-identifier">mutex</span>)
+893:                         <span class="ruby-keyword kw">end</span>
+894:                 <span class="ruby-keyword kw">end</span>
+895:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
+896:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>