passenger 1.0.5 → 2.0.1

data/doc/rdoc/classes/Passenger/SpawnManager.html

@@ -78,26 +78,35 @@ AbstractServer
       <div id="content">
 
   <div class="description"><p>
-This class is capable of spawning Ruby on Rails application instances.
+The spawn manager is capable of spawning Ruby on Rails or Rack application
+instances. It acts like a simple fascade for the rest of the spawn manager
+system.
+</p>
+<p>
+<b>Note</b>: <a href="SpawnManager.html">SpawnManager</a> may only be
+started synchronously with <a
+href="AbstractServer.html#M000054">AbstractServer#start_synchronously</a>.
+Starting asynchronously has not been tested. Don&#8216;t forget to call <a
+href="SpawnManager.html#M000047">cleanup</a> after the server&#8216;s main
+loop has finished.
+</p>
+<h2>Ruby on Rails optimizations ===</h2>
+<p>
 Spawning a Ruby on Rails application is usually slow. But <a
 href="SpawnManager.html">SpawnManager</a> will preload and cache Ruby on
 Rails frameworks, as well as application code, so subsequent spawns will be
 very fast.
 </p>
 <p>
-Internally, <a href="SpawnManager.html">SpawnManager</a> uses <a
-href="FrameworkSpawner.html">FrameworkSpawner</a> to preload and cache Ruby
-on Rails frameworks. <a href="FrameworkSpawner.html">FrameworkSpawner</a>,
-in turn, uses <a href="ApplicationSpawner.html">ApplicationSpawner</a> to
-preload and cache application code.
+Internally, <a href="SpawnManager.html">SpawnManager</a> uses
+Railz::FrameworkSpawner to preload and cache Ruby on Rails frameworks.
+Railz::FrameworkSpawner, in turn, uses Railz::ApplicationSpawner to preload
+and cache application code.
 </p>
 <p>
-<b>Note</b>: <a href="SpawnManager.html">SpawnManager</a> may only be
-started synchronously with <a
-href="AbstractServer.html#M000060">AbstractServer#start_synchronously</a>.
-Starting asynchronously has not been tested. Don&#8216;t forget to call <a
-href="SpawnManager.html#M000048">cleanup</a> after the server&#8216;s main
-loop has finished.
+In case you&#8216;re wondering why the namespace is &quot;Railz&quot; and
+not &quot;Rails&quot;: it&#8216;s to work around an obscure bug in
+ActiveSupport&#8216;s Dispatcher.
 </p>
 </div>
 
@@ -105,10 +114,10 @@ loop has finished.
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000048">cleanup</a></li>
-  <li><a href="#M000045">new</a></li>
-  <li><a href="#M000047">reload</a></li>
-  <li><a href="#M000046">spawn_application</a></li>
+  <li><a href="#M000047">cleanup</a></li>
+  <li><a href="#M000044">new</a></li>
+  <li><a href="#M000046">reload</a></li>
+  <li><a href="#M000045">spawn_application</a></li>
   </ul>
 
 <div class="sectiontitle">Included Modules</div>
@@ -118,39 +127,16 @@ loop has finished.
 
 
 
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">DEFAULT_INPUT_FD</td>
-    <td>=</td>
-    <td class="attr-value">3</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">FRAMEWORK_SPAWNER_MAX_IDLE_TIME</td>
-    <td>=</td>
-    <td class="attr-value">30 * 60</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">APP_SPAWNER_MAX_IDLE_TIME</td>
-    <td>=</td>
-    <td class="attr-value">FrameworkSpawner::APP_SPAWNER_MAX_IDLE_TIME</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">SPAWNER_CLEAN_INTERVAL</td>
-    <td>=</td>
-    <td class="attr-value">[FRAMEWORK_SPAWNER_MAX_IDLE_TIME,                 APP_SPAWNER_MAX_IDLE_TIME].min + 5</td>
-  </tr>
-  </table>
 
 
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000045"></a><b>new</b>()
+    <a name="M000044"></a><b>new</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show source</a> ]</p>
-  <div id="M000045_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000044_source')" id="l_M000044_source">show source</a> ]</p>
+  <div id="M000044_source" class="dyn-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 48</span>
 48:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
@@ -164,7 +150,25 @@ loop has finished.
 56:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
 57:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
 58:                 <span class="ruby-identifier">define_signal_handler</span>(<span class="ruby-value str">'SIGHUP'</span>, <span class="ruby-identifier">:reload</span>)
-59:         <span class="ruby-keyword kw">end</span>
+59:                 
+60:                 <span class="ruby-constant">GC</span>.<span class="ruby-identifier">start</span>
+61:                 <span class="ruby-keyword kw">if</span> <span class="ruby-constant">GC</span>.<span class="ruby-identifier">copy_on_write_friendly?</span>
+62:                         <span class="ruby-comment cmt"># Preload libraries for copy-on-write semantics.</span>
+63:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'base64'</span>
+64:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/application'</span>
+65:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/framework_spawner'</span>
+66:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/application_spawner'</span>
+67:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/rack/application_spawner'</span>
+68:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/html_template'</span>
+69:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/platform_info'</span>
+70:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/exceptions'</span>
+71:                         
+72:                         <span class="ruby-comment cmt"># Commonly used libraries.</span>
+73:                         [<span class="ruby-value str">'mysql'</span>, <span class="ruby-value str">'sqlite3'</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">lib</span><span class="ruby-operator">|</span>
+74:                                 <span class="ruby-identifier">require</span> <span class="ruby-identifier">lib</span>
+75:                         <span class="ruby-keyword kw">end</span>
+76:                 <span class="ruby-keyword kw">end</span>
+77:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -172,7 +176,7 @@ loop has finished.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000048"></a><b>cleanup</b>()
+    <a name="M000047"></a><b>cleanup</b>()
   </div>
   <div class="description">
   <p>
@@ -181,29 +185,31 @@ href="SpawnManager.html">SpawnManager</a> is no longer needed.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">show source</a> ]</p>
-  <div id="M000048_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">show source</a> ]</p>
+  <div id="M000047_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 165</span>
-165:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
-166:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-167:                         <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
-168:                 <span class="ruby-keyword kw">end</span>
-169:                 <span class="ruby-ivar">@cleaner_thread</span>.<span class="ruby-identifier">join</span>
+     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 169</span>
+169:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
 170:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-171:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
-172:                                 <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
-173:                         <span class="ruby-keyword kw">end</span>
-174:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">clear</span>
-175:                 <span class="ruby-keyword kw">end</span>
-176:         <span class="ruby-keyword kw">end</span>
+171:                         <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
+172:                 <span class="ruby-keyword kw">end</span>
+173:                 <span class="ruby-ivar">@cleaner_thread</span>.<span class="ruby-identifier">join</span>
+174:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
+175:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
+176:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">started?</span>
+177:                                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
+178:                                 <span class="ruby-keyword kw">end</span>
+179:                         <span class="ruby-keyword kw">end</span>
+180:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">clear</span>
+181:                 <span class="ruby-keyword kw">end</span>
+182:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000047"></a><b>reload</b>(app_root = nil)
+    <a name="M000046"></a><b>reload</b>(app_root = nil)
   </div>
   <div class="description">
   <p>
@@ -214,8 +220,8 @@ will be removed, no matter the application root.
 <p>
 <b>Long description:</b> <a href="Application.html">Application</a> code
 might be cached in memory. But once it a while, it will be necessary to <a
-href="SpawnManager.html#M000047">reload</a> the code for an application,
-such as after deploying a <a href="SpawnManager.html#M000045">new</a>
+href="SpawnManager.html#M000046">reload</a> the code for an application,
+such as after deploying a <a href="SpawnManager.html#M000044">new</a>
 version of the application. This method makes sure that any cached
 application code is removed, so that the next time an application instance
 is spawned, the application code will be freshly loaded into memory.
@@ -225,42 +231,44 @@ Raises AbstractServer::SpawnError if something went wrong.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">show source</a> ]</p>
-  <div id="M000047_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show source</a> ]</p>
+  <div id="M000046_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 138</span>
-138:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span> = <span class="ruby-keyword kw">nil</span>)
-139:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
-140:                         <span class="ruby-keyword kw">begin</span>
-141:                                 <span class="ruby-identifier">app_root</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">app_root</span>)
-142:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>
-143:                         <span class="ruby-keyword kw">end</span>
-144:                 <span class="ruby-keyword kw">end</span>
-145:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-146:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
-147:                                 <span class="ruby-comment cmt"># Delete associated ApplicationSpawner.</span>
-148:                                 <span class="ruby-identifier">key</span> = <span class="ruby-node">&quot;app:#{app_root}&quot;</span>
-149:                                 <span class="ruby-identifier">spawner</span> = <span class="ruby-ivar">@spawners</span>[<span class="ruby-identifier">key</span>]
-150:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>
-151:                                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
-152:                                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
-153:                                 <span class="ruby-keyword kw">end</span>
-154:                         <span class="ruby-keyword kw">end</span>
-155:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
-156:                                 <span class="ruby-comment cmt"># Reload FrameworkSpawners.</span>
-157:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:reload</span>)
-158:                                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span>)
-159:                                 <span class="ruby-keyword kw">end</span>
-160:                         <span class="ruby-keyword kw">end</span>
-161:                 <span class="ruby-keyword kw">end</span>
-162:         <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 140</span>
+140:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span> = <span class="ruby-keyword kw">nil</span>)
+141:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
+142:                         <span class="ruby-keyword kw">begin</span>
+143:                                 <span class="ruby-identifier">app_root</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">app_root</span>)
+144:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>
+145:                         <span class="ruby-keyword kw">end</span>
+146:                 <span class="ruby-keyword kw">end</span>
+147:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
+148:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
+149:                                 <span class="ruby-comment cmt"># Delete associated ApplicationSpawner.</span>
+150:                                 <span class="ruby-identifier">key</span> = <span class="ruby-node">&quot;app:#{app_root}&quot;</span>
+151:                                 <span class="ruby-identifier">spawner</span> = <span class="ruby-ivar">@spawners</span>[<span class="ruby-identifier">key</span>]
+152:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>
+153:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">started?</span>
+154:                                                 <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
+155:                                         <span class="ruby-keyword kw">end</span>
+156:                                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
+157:                                 <span class="ruby-keyword kw">end</span>
+158:                         <span class="ruby-keyword kw">end</span>
+159:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
+160:                                 <span class="ruby-comment cmt"># Reload FrameworkSpawners.</span>
+161:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:reload</span>)
+162:                                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span>)
+163:                                 <span class="ruby-keyword kw">end</span>
+164:                         <span class="ruby-keyword kw">end</span>
+165:                 <span class="ruby-keyword kw">end</span>
+166:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000046"></a><b>spawn_application</b>(app_root, lower_privilege = true, lowest_user = &quot;nobody&quot;)
+    <a name="M000045"></a><b>spawn_application</b>(app_root, lower_privilege = true, lowest_user = &quot;nobody&quot;, environment = &quot;production&quot;, spawn_method = &quot;smart&quot;, app_type = &quot;rails&quot;)
   </div>
   <div class="description">
   <p>
@@ -269,29 +277,39 @@ href="Application.html">Application</a> object will be returned, which
 represents the spawned RoR application.
 </p>
 <p>
-See <a href="ApplicationSpawner.html#M000042">ApplicationSpawner.new</a>
-for an explanation of the <tt>lower_privilege</tt> and <tt>lowest_user</tt>
+See Railz::ApplicationSpawner.new for an explanation of the
+<tt>lower_privilege</tt>, <tt>lowest_user</tt> and <tt>environment</tt>
 parameters.
 </p>
 <p>
-<a href="SpawnManager.html">SpawnManager</a> will internally cache the code
-of applications, in order to speed up future spawning attempts. This
-implies that, if you&#8216;ve changed the application&#8216;s code, you
-must do one of these things:
+The <tt>spawn_method</tt> argument may be one of &quot;smart&quot; or
+&quot;conservative&quot;. When &quot;smart&quot; is specified (the
+default), <a href="SpawnManager.html">SpawnManager</a> will internally
+cache the code of applications, in order to speed up future spawning
+attempts. This implies that, if you&#8216;ve changed the
+application&#8216;s code, you must do one of these things:
 </p>
 <ul>
 <li>Restart this <a href="SpawnManager.html">SpawnManager</a> by calling <a
-href="AbstractServer.html#M000061">AbstractServer#stop</a>, then <a
-href="AbstractServer.html#M000059">AbstractServer#start</a>.
+href="AbstractServer.html#M000055">AbstractServer#stop</a>, then <a
+href="AbstractServer.html#M000053">AbstractServer#start</a>.
 
 </li>
 <li>Reload the application by calling <a
-href="SpawnManager.html#M000047">reload</a> with the correct app_root
+href="SpawnManager.html#M000046">reload</a> with the correct app_root
 argument.
 
 </li>
 </ul>
 <p>
+Caching however can be incompatible with some applications.
+</p>
+<p>
+The &quot;conservative&quot; spawning method does not involve any caching
+at all. Spawning will be slower, but is guaranteed to be compatible with
+all applications.
+</p>
+<p>
 Raises:
 </p>
 <ul>
@@ -318,54 +336,33 @@ exception or called exit() during startup.
 </ul>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show source</a> ]</p>
-  <div id="M000046_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show source</a> ]</p>
+  <div id="M000045_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 80</span>
- 80:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span> = <span class="ruby-keyword kw">true</span>, <span class="ruby-identifier">lowest_user</span> = <span class="ruby-value str">&quot;nobody&quot;</span>)
- 81:                 <span class="ruby-identifier">framework_version</span> = <span class="ruby-constant">Application</span>.<span class="ruby-identifier">detect_framework_version</span>(<span class="ruby-identifier">app_root</span>)
- 82:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">framework_version</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">:vendor</span>
- 83:                         <span class="ruby-identifier">vendor_path</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-node">&quot;#{app_root}/vendor/rails&quot;</span>)
- 84:                         <span class="ruby-identifier">key</span> = <span class="ruby-node">&quot;vendor:#{vendor_path}&quot;</span>
- 85:                         <span class="ruby-identifier">create_spawner</span> = <span class="ruby-identifier">proc</span> <span class="ruby-keyword kw">do</span>
- 86:                                 <span class="ruby-constant">FrameworkSpawner</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">:vendor</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">vendor_path</span>)
- 87:                         <span class="ruby-keyword kw">end</span>
- 88:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">framework_version</span>.<span class="ruby-identifier">nil?</span>
- 89:                         <span class="ruby-identifier">app_root</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">app_root</span>)
- 90:                         <span class="ruby-identifier">key</span> = <span class="ruby-node">&quot;app:#{app_root}&quot;</span>
- 91:                         <span class="ruby-identifier">create_spawner</span> = <span class="ruby-identifier">proc</span> <span class="ruby-keyword kw">do</span>
- 92:                                 <span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>)
- 93:                         <span class="ruby-keyword kw">end</span>
- 94:                 <span class="ruby-keyword kw">else</span>
- 95:                         <span class="ruby-identifier">key</span> = <span class="ruby-node">&quot;version:#{framework_version}&quot;</span>
- 96:                         <span class="ruby-identifier">create_spawner</span> = <span class="ruby-identifier">proc</span> <span class="ruby-keyword kw">do</span>
- 97:                                 <span class="ruby-constant">FrameworkSpawner</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">:version</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">framework_version</span>)
- 98:                         <span class="ruby-keyword kw">end</span>
- 99:                 <span class="ruby-keyword kw">end</span>
-100:                 
-101:                 <span class="ruby-identifier">spawner</span> = <span class="ruby-keyword kw">nil</span>
-102:                 <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-103:                         <span class="ruby-identifier">spawner</span> = <span class="ruby-ivar">@spawners</span>[<span class="ruby-identifier">key</span>]
-104:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">spawner</span>
-105:                                 <span class="ruby-identifier">spawner</span> = <span class="ruby-identifier">create_spawner</span>.<span class="ruby-identifier">call</span>
-106:                                 <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">start</span>
-107:                                 <span class="ruby-ivar">@spawners</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">spawner</span>
-108:                         <span class="ruby-keyword kw">end</span>
-109:                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>
-110:                         <span class="ruby-keyword kw">begin</span>
-111:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">FrameworkSpawner</span>)
-112:                                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span>,
-113:                                                 <span class="ruby-identifier">lowest_user</span>)
-114:                                 <span class="ruby-keyword kw">else</span>
-115:                                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">spawn_application</span>
-116:                                 <span class="ruby-keyword kw">end</span>
-117:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">AbstractServer</span><span class="ruby-operator">::</span><span class="ruby-constant">ServerError</span>
-118:                                 <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
-119:                                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
-120:                                 <span class="ruby-identifier">raise</span>
+     <span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 103</span>
+103:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span> = <span class="ruby-keyword kw">true</span>, <span class="ruby-identifier">lowest_user</span> = <span class="ruby-value str">&quot;nobody&quot;</span>,
+104:                               <span class="ruby-identifier">environment</span> = <span class="ruby-value str">&quot;production&quot;</span>, <span class="ruby-identifier">spawn_method</span> = <span class="ruby-value str">&quot;smart&quot;</span>,
+105:                               <span class="ruby-identifier">app_type</span> = <span class="ruby-value str">&quot;rails&quot;</span>)
+106:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;rack&quot;</span>
+107:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
+108:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/rack/application_spawner'</span>
+109:                         <span class="ruby-keyword kw">end</span>
+110:                         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>,
+111:                                 <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>, <span class="ruby-identifier">environment</span>)
+112:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">app_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;wsgi&quot;</span>
+113:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/wsgi/application_spawner'</span>
+114:                         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">WSGI</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>,
+115:                                 <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>, <span class="ruby-identifier">environment</span>)
+116:                 <span class="ruby-keyword kw">else</span>
+117:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">FrameworkSpawner</span>)
+118:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/application'</span>
+119:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/framework_spawner'</span>
+120:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/application_spawner'</span>
 121:                         <span class="ruby-keyword kw">end</span>
-122:                 <span class="ruby-keyword kw">end</span>
-123:         <span class="ruby-keyword kw">end</span>
+122:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rails_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>,
+123:                                 <span class="ruby-identifier">environment</span>, <span class="ruby-identifier">spawn_method</span>)
+124:                 <span class="ruby-keyword kw">end</span>
+125:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>

data/doc/rdoc/classes/Passenger/UnknownError.html

@@ -57,7 +57,7 @@
       <tr valign="top">
         <td>In:</td>
         <td>
-<a href="../../files/lib/passenger/utils_rb.html">lib/passenger/utils.rb</a>
+<a href="../../files/lib/passenger/exceptions_rb.html">lib/passenger/exceptions.rb</a>
         </td>
       </tr>
     <tr>
@@ -80,7 +80,7 @@ StandardError
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000049">new</a></li>
+  <li><a href="#M000048">new</a></li>
   </ul>
 
 
@@ -101,18 +101,18 @@ StandardError
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000049"></a><b>new</b>(message, class_name, backtrace)
+    <a name="M000048"></a><b>new</b>(message, class_name, backtrace)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000049_source')" id="l_M000049_source">show source</a> ]</p>
-  <div id="M000049_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">show source</a> ]</p>
+  <div id="M000048_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 30</span>
-30:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">class_name</span>, <span class="ruby-identifier">backtrace</span>)
-31:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-node">&quot;#{message} (#{class_name})&quot;</span>)
-32:                 <span class="ruby-identifier">set_backtrace</span>(<span class="ruby-identifier">backtrace</span>)
-33:                 <span class="ruby-ivar">@real_class_name</span> = <span class="ruby-identifier">class_name</span>
-34:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/exceptions.rb, line 84</span>
+84:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">class_name</span>, <span class="ruby-identifier">backtrace</span>)
+85:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-node">&quot;#{message} (#{class_name})&quot;</span>)
+86:                 <span class="ruby-identifier">set_backtrace</span>(<span class="ruby-identifier">backtrace</span>)
+87:                 <span class="ruby-ivar">@real_class_name</span> = <span class="ruby-identifier">class_name</span>
+88:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>

data/doc/rdoc/classes/Passenger/Utils.html

@@ -83,10 +83,16 @@ Utility functions.
   <li><a href="#M000017">assert_valid_file</a></li>
   <li><a href="#M000019">assert_valid_groupname</a></li>
   <li><a href="#M000018">assert_valid_username</a></li>
-  <li><a href="#M000020">marshal_exception</a></li>
+  <li><a href="#M000020">close_all_io_objects_for_fds</a></li>
+  <li><a href="#M000027">lower_privilege</a></li>
+  <li><a href="#M000021">marshal_exception</a></li>
   <li><a href="#M000014">normalize_path</a></li>
-  <li><a href="#M000022">print_exception</a></li>
-  <li><a href="#M000021">unmarshal_exception</a></li>
+  <li><a href="#M000023">print_exception</a></li>
+  <li><a href="#M000025">report_app_init_status</a></li>
+  <li><a href="#M000024">safe_fork</a></li>
+  <li><a href="#M000028">switch_to_user</a></li>
+  <li><a href="#M000026">unmarshal_and_raise_errors</a></li>
+  <li><a href="#M000022">unmarshal_exception</a></li>
   </ul>
 
 
@@ -109,11 +115,11 @@ Raises ArgumentError if that is not the case.
   <p class="source-link">[ <a href="javascript:toggleSource('M000015_source')" id="l_M000015_source">show source</a> ]</p>
   <div id="M000015_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 55</span>
-55:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_app_root</span>(<span class="ruby-identifier">app_root</span>)
-56:                 <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">app_root</span>)
-57:                 <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-node">&quot;#{app_root}/config/environment.rb&quot;</span>)
-58:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 51</span>
+51:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_app_root</span>(<span class="ruby-identifier">app_root</span>)
+52:                 <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">app_root</span>)
+53:                 <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-node">&quot;#{app_root}/config/environment.rb&quot;</span>)
+54:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -132,12 +138,12 @@ it isn&#8216;t.
   <p class="source-link">[ <a href="javascript:toggleSource('M000016_source')" id="l_M000016_source">show source</a> ]</p>
   <div id="M000016_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 61</span>
-61:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">path</span>)
-62:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">path</span>)
-63:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;'#{path}' is not a valid directory.&quot;</span>
-64:                 <span class="ruby-keyword kw">end</span>
-65:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 57</span>
+57:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">path</span>)
+58:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">path</span>)
+59:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;'#{path}' is not a valid directory.&quot;</span>
+60:                 <span class="ruby-keyword kw">end</span>
+61:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -156,12 +162,12 @@ isn&#8216;t.
   <p class="source-link">[ <a href="javascript:toggleSource('M000017_source')" id="l_M000017_source">show source</a> ]</p>
   <div id="M000017_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 68</span>
-68:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-identifier">path</span>)
-69:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">file?</span>(<span class="ruby-identifier">path</span>)
-70:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;'#{path}' is not a valid file.&quot;</span>
-71:                 <span class="ruby-keyword kw">end</span>
-72:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 64</span>
+64:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-identifier">path</span>)
+65:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">file?</span>(<span class="ruby-identifier">path</span>)
+66:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;'#{path}' is not a valid file.&quot;</span>
+67:                 <span class="ruby-keyword kw">end</span>
+68:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -180,11 +186,11 @@ if that is not the case.
   <p class="source-link">[ <a href="javascript:toggleSource('M000019_source')" id="l_M000019_source">show source</a> ]</p>
   <div id="M000019_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 83</span>
-83:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_groupname</span>(<span class="ruby-identifier">groupname</span>)
-84:                 <span class="ruby-comment cmt"># If groupname does not exist then getgrnam() will raise an ArgumentError.</span>
-85:                 <span class="ruby-identifier">groupname</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getgrnam</span>(<span class="ruby-identifier">groupname</span>)
-86:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 79</span>
+79:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_groupname</span>(<span class="ruby-identifier">groupname</span>)
+80:                 <span class="ruby-comment cmt"># If groupname does not exist then getgrnam() will raise an ArgumentError.</span>
+81:                 <span class="ruby-identifier">groupname</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getgrnam</span>(<span class="ruby-identifier">groupname</span>)
+82:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -203,46 +209,100 @@ that is not the case.
   <p class="source-link">[ <a href="javascript:toggleSource('M000018_source')" id="l_M000018_source">show source</a> ]</p>
   <div id="M000018_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 76</span>
-76:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_username</span>(<span class="ruby-identifier">username</span>)
-77:                 <span class="ruby-comment cmt"># If username does not exist then getpwnam() will raise an ArgumentError.</span>
-78:                 <span class="ruby-identifier">username</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwnam</span>(<span class="ruby-identifier">username</span>)
-79:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 72</span>
+72:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_username</span>(<span class="ruby-identifier">username</span>)
+73:                 <span class="ruby-comment cmt"># If username does not exist then getpwnam() will raise an ArgumentError.</span>
+74:                 <span class="ruby-identifier">username</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwnam</span>(<span class="ruby-identifier">username</span>)
+75:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000020"></a><b>marshal_exception</b>(exception)
+    <a name="M000020"></a><b>close_all_io_objects_for_fds</b>(file_descriptors_to_close)
   </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000020_source')" id="l_M000020_source">show source</a> ]</p>
   <div id="M000020_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 88</span>
- 88:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">exception</span>)
- 89:                 <span class="ruby-identifier">data</span> = {
- 90:                         <span class="ruby-identifier">:message</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">message</span>,
- 91:                         <span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>,
- 92:                         <span class="ruby-identifier">:backtrace</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>
- 93:                 }
- 94:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">InitializationError</span>)
- 95:                         <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:is_initialization_error</span>] = <span class="ruby-keyword kw">true</span>
- 96:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">child_exception</span>
- 97:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:child_exception</span>] = <span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">child_exception</span>)
- 98:                         <span class="ruby-keyword kw">end</span>
- 99:                 <span class="ruby-keyword kw">else</span>
-100:                         <span class="ruby-keyword kw">begin</span>
-101:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:exception</span>] = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">exception</span>)
-102:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
-103:                                 <span class="ruby-identifier">e</span> = <span class="ruby-constant">UnknownError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">message</span>, <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>,
-104:                                                         <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>)
-105:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:exception</span>] = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">e</span>)
-106:                         <span class="ruby-keyword kw">end</span>
-107:                 <span class="ruby-keyword kw">end</span>
-108:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">data</span>)
-109:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 84</span>
+84:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close_all_io_objects_for_fds</span>(<span class="ruby-identifier">file_descriptors_to_close</span>)
+85:                 <span class="ruby-constant">ObjectSpace</span>.<span class="ruby-identifier">each_object</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">o</span><span class="ruby-operator">|</span>
+86:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">IO</span>)
+87:                                 <span class="ruby-keyword kw">begin</span>
+88:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">closed?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">file_descriptors_to_close</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">o</span>.<span class="ruby-identifier">fileno</span>)
+89:                                                 <span class="ruby-identifier">o</span>.<span class="ruby-identifier">close</span>
+90:                                         <span class="ruby-keyword kw">end</span>
+91:                                 <span class="ruby-keyword kw">rescue</span>
+92:                                 <span class="ruby-keyword kw">end</span>
+93:                         <span class="ruby-keyword kw">end</span>
+94:                 <span class="ruby-keyword kw">end</span>
+95:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000027"></a><b>lower_privilege</b>(filename, lowest_user = &quot;nobody&quot;)
+  </div>
+  <div class="description">
+  <p>
+Lower the current process&#8216;s privilege to the owner of the given file.
+No exceptions will be raised in the event that privilege lowering fails.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000027_source')" id="l_M000027_source">show source</a> ]</p>
+  <div id="M000027_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 227</span>
+227:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lower_privilege</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">lowest_user</span> = <span class="ruby-value str">&quot;nobody&quot;</span>)
+228:                 <span class="ruby-identifier">stat</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">lstat</span>(<span class="ruby-identifier">filename</span>)
+229:                 <span class="ruby-keyword kw">begin</span>
+230:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">switch_to_user</span>(<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">uid</span>)
+231:                                 <span class="ruby-identifier">switch_to_user</span>(<span class="ruby-identifier">lowest_user</span>)
+232:                         <span class="ruby-keyword kw">end</span>
+233:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EPERM</span>
+234:                         <span class="ruby-comment cmt"># No problem if we were unable to switch user.</span>
+235:                 <span class="ruby-keyword kw">end</span>
+236:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000021"></a><b>marshal_exception</b>(exception)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">show source</a> ]</p>
+  <div id="M000021_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 97</span>
+ 97:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">exception</span>)
+ 98:                 <span class="ruby-identifier">data</span> = {
+ 99:                         <span class="ruby-identifier">:message</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">message</span>,
+100:                         <span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>,
+101:                         <span class="ruby-identifier">:backtrace</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>
+102:                 }
+103:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">InitializationError</span>)
+104:                         <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:is_initialization_error</span>] = <span class="ruby-keyword kw">true</span>
+105:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">child_exception</span>
+106:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:child_exception</span>] = <span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">child_exception</span>)
+107:                         <span class="ruby-keyword kw">end</span>
+108:                 <span class="ruby-keyword kw">else</span>
+109:                         <span class="ruby-keyword kw">begin</span>
+110:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:exception</span>] = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">exception</span>)
+111:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
+112:                                 <span class="ruby-identifier">e</span> = <span class="ruby-constant">UnknownError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">message</span>, <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>,
+113:                                                         <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>)
+114:                                 <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:exception</span>] = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">e</span>)
+115:                         <span class="ruby-keyword kw">end</span>
+116:                 <span class="ruby-keyword kw">end</span>
+117:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">data</span>)
+118:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
@@ -266,20 +326,20 @@ Raises SystemCallError if something went wrong. Raises ArgumentError if
   <p class="source-link">[ <a href="javascript:toggleSource('M000014_source')" id="l_M000014_source">show source</a> ]</p>
   <div id="M000014_source" class="dyn-source">
 <pre>
-    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 46</span>
-46:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">path</span>)
-47:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;The 'path' argument may not be nil&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">path</span>.<span class="ruby-identifier">nil?</span>
-48:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">path</span>).<span class="ruby-identifier">realpath</span>.<span class="ruby-identifier">to_s</span>
-49:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ENOENT</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-50:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span>
-51:         <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 42</span>
+42:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">path</span>)
+43:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;The 'path' argument may not be nil&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">path</span>.<span class="ruby-identifier">nil?</span>
+44:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">path</span>).<span class="ruby-identifier">realpath</span>.<span class="ruby-identifier">to_s</span>
+45:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ENOENT</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+46:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span>
+47:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000022"></a><b>print_exception</b>(current_location, exception)
+    <a name="M000023"></a><b>print_exception</b>(current_location, exception)
   </div>
   <div class="description">
   <p>
@@ -291,55 +351,223 @@ currently at. Usually the current class name will be enough.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000022_source')" id="l_M000022_source">show source</a> ]</p>
-  <div id="M000022_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000023_source')" id="l_M000023_source">show source</a> ]</p>
+  <div id="M000023_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 142</span>
-142:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">print_exception</span>(<span class="ruby-identifier">current_location</span>, <span class="ruby-identifier">exception</span>)
-143:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">exception</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">SystemExit</span>)
-144:                         <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace_string</span>(<span class="ruby-identifier">current_location</span>))
-145:                         <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">flush</span>
-146:                 <span class="ruby-keyword kw">end</span>
-147:         <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 151</span>
+151:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">print_exception</span>(<span class="ruby-identifier">current_location</span>, <span class="ruby-identifier">exception</span>)
+152:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">exception</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">SystemExit</span>)
+153:                         <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span>(<span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace_string</span>(<span class="ruby-identifier">current_location</span>))
+154:                         <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">flush</span>
+155:                 <span class="ruby-keyword kw">end</span>
+156:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000021"></a><b>unmarshal_exception</b>(data)
+    <a name="M000025"></a><b>report_app_init_status</b>(channel) {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Run the given block. A message will be sent through <tt>channel</tt> (a <a
+href="MessageChannel.html">MessageChannel</a> object), telling the remote
+side whether the block raised an exception, called exit(), or succeeded.
+Returns whether the block succeeded. Exceptions are not propagated, except
+for SystemExit.
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">show source</a> ]</p>
-  <div id="M000021_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000025_source')" id="l_M000025_source">show source</a> ]</p>
+  <div id="M000025_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 179</span>
+179:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">report_app_init_status</span>(<span class="ruby-identifier">channel</span>)
+180:                 <span class="ruby-keyword kw">begin</span>
+181:                         <span class="ruby-keyword kw">yield</span>
+182:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'success'</span>)
+183:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+184:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">StandardError</span>, <span class="ruby-constant">ScriptError</span>, <span class="ruby-constant">NoMemoryError</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+185:                         <span class="ruby-keyword kw">if</span> <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'TESTING_PASSENGER'</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">'1'</span>
+186:                                 <span class="ruby-identifier">print_exception</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-identifier">e</span>)
+187:                         <span class="ruby-keyword kw">end</span>
+188:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'exception'</span>)
+189:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">e</span>))
+190:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+191:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SystemExit</span>
+192:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'exit'</span>)
+193:                         <span class="ruby-identifier">raise</span>
+194:                 <span class="ruby-keyword kw">end</span>
+195:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000024"></a><b>safe_fork</b>(current_location) {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Fork a new process and run the given block inside the child process, just
+like fork(). Unlike fork(), this method is safe, i.e. there&#8216;s no way
+for the child process to escape the block. Any uncaught exceptions in the
+child process will be printed to standard output, citing
+<em>current_location</em> as the source.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000024_source')" id="l_M000024_source">show source</a> ]</p>
+  <div id="M000024_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 162</span>
+162:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">safe_fork</span>(<span class="ruby-identifier">current_location</span>)
+163:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">fork</span> <span class="ruby-keyword kw">do</span>
+164:                         <span class="ruby-keyword kw">begin</span>
+165:                                 <span class="ruby-keyword kw">yield</span>
+166:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+167:                                 <span class="ruby-identifier">print_exception</span>(<span class="ruby-identifier">current_location</span>, <span class="ruby-identifier">e</span>)
+168:                         <span class="ruby-keyword kw">ensure</span>
+169:                                 <span class="ruby-identifier">exit!</span>
+170:                         <span class="ruby-keyword kw">end</span>
+171:                 <span class="ruby-keyword kw">end</span>
+172:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000028"></a><b>switch_to_user</b>(user)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000028_source')" id="l_M000028_source">show source</a> ]</p>
+  <div id="M000028_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 238</span>
+238:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">switch_to_user</span>(<span class="ruby-identifier">user</span>)
+239:                 <span class="ruby-keyword kw">begin</span>
+240:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">user</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
+241:                                 <span class="ruby-identifier">pw</span> = <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwnam</span>(<span class="ruby-identifier">user</span>)
+242:                                 <span class="ruby-identifier">username</span> = <span class="ruby-identifier">user</span>
+243:                                 <span class="ruby-identifier">uid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">uid</span>
+244:                                 <span class="ruby-identifier">gid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">gid</span>
+245:                         <span class="ruby-keyword kw">else</span>
+246:                                 <span class="ruby-identifier">pw</span> = <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwuid</span>(<span class="ruby-identifier">user</span>)
+247:                                 <span class="ruby-identifier">username</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">name</span>
+248:                                 <span class="ruby-identifier">uid</span> = <span class="ruby-identifier">user</span>
+249:                                 <span class="ruby-identifier">gid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">gid</span>
+250:                         <span class="ruby-keyword kw">end</span>
+251:                 <span class="ruby-keyword kw">rescue</span>
+252:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+253:                 <span class="ruby-keyword kw">end</span>
+254:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uid</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
+255:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+256:                 <span class="ruby-keyword kw">else</span>
+257:                         <span class="ruby-comment cmt"># Some systems are broken. initgroups can fail because of</span>
+258:                         <span class="ruby-comment cmt"># all kinds of stupid reasons. So we ignore any errors</span>
+259:                         <span class="ruby-comment cmt"># raised by initgroups.</span>
+260:                         <span class="ruby-keyword kw">begin</span>
+261:                                 <span class="ruby-constant">Process</span>.<span class="ruby-identifier">groups</span> = <span class="ruby-constant">Process</span>.<span class="ruby-identifier">initgroups</span>(<span class="ruby-identifier">username</span>, <span class="ruby-identifier">gid</span>)
+262:                         <span class="ruby-keyword kw">rescue</span>
+263:                         <span class="ruby-keyword kw">end</span>
+264:                         <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-constant">Sys</span>.<span class="ruby-identifier">setgid</span>(<span class="ruby-identifier">gid</span>)
+265:                         <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-constant">Sys</span>.<span class="ruby-identifier">setuid</span>(<span class="ruby-identifier">uid</span>)
+266:                         <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'HOME'</span>] = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">dir</span>
+267:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+268:                 <span class="ruby-keyword kw">end</span>
+269:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000026"></a><b>unmarshal_and_raise_errors</b>(channel, app_type = &quot;rails&quot;)
+  </div>
+  <div class="description">
+  <p>
+Receive status information that was sent to <tt>channel</tt> by <a
+href="Utils.html#M000025">report_app_init_status</a>. If an error occured
+according to the received information, then an appropriate exception will
+be raised.
+</p>
+<p>
+Raises:
+</p>
+<ul>
+<li><a href="AppInitError.html">AppInitError</a>
+
+</li>
+<li>IOError, SystemCallError, SocketError
+
+</li>
+</ul>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000026_source')" id="l_M000026_source">show source</a> ]</p>
+  <div id="M000026_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 205</span>
+205:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unmarshal_and_raise_errors</span>(<span class="ruby-identifier">channel</span>, <span class="ruby-identifier">app_type</span> = <span class="ruby-value str">&quot;rails&quot;</span>)
+206:                 <span class="ruby-identifier">args</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read</span>
+207:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">nil?</span>
+208:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-value str">&quot;Unexpected end-of-file detected.&quot;</span>
+209:                 <span class="ruby-keyword kw">end</span>
+210:                 <span class="ruby-identifier">status</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
+211:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'exception'</span>
+212:                         <span class="ruby-identifier">child_exception</span> = <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read_scalar</span>)
+213:                         <span class="ruby-comment cmt">#print_exception(self.class.to_s, child_exception)</span>
+214:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">new</span>(
+215:                                 <span class="ruby-node">&quot;Application '#{@app_root}' raised an exception: &quot;</span> <span class="ruby-operator">&lt;&lt;</span>
+216:                                 <span class="ruby-node">&quot;#{child_exception.class} (#{child_exception.message})&quot;</span>,
+217:                                 <span class="ruby-identifier">child_exception</span>,
+218:                                 <span class="ruby-identifier">app_type</span>)
+219:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'exit'</span>
+220:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-node">&quot;Application '#{@app_root}' exited during startup&quot;</span>,
+221:                                 <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">app_type</span>)
+222:                 <span class="ruby-keyword kw">end</span>
+223:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000022"></a><b>unmarshal_exception</b>(data)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000022_source')" id="l_M000022_source">show source</a> ]</p>
+  <div id="M000022_source" class="dyn-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 111</span>
-111:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">data</span>)
-112:                 <span class="ruby-identifier">hash</span> = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">data</span>)
-113:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:is_initialization_error</span>]
-114:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:child_exception</span>]
-115:                                 <span class="ruby-identifier">child_exception</span> = <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:child_exception</span>])
-116:                         <span class="ruby-keyword kw">else</span>
-117:                                 <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>
-118:                         <span class="ruby-keyword kw">end</span>
-119:                         
-120:                         <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:class</span>]
-121:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">to_s</span>
-122:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">AppInitError</span>
-123:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">FrameworkInitError</span>.<span class="ruby-identifier">to_s</span>
-124:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">FrameworkInitError</span>
+     <span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 120</span>
+120:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">data</span>)
+121:                 <span class="ruby-identifier">hash</span> = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">data</span>)
+122:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:is_initialization_error</span>]
+123:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:child_exception</span>]
+124:                                 <span class="ruby-identifier">child_exception</span> = <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:child_exception</span>])
 125:                         <span class="ruby-keyword kw">else</span>
-126:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">InitializationError</span>
+126:                                 <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>
 127:                         <span class="ruby-keyword kw">end</span>
-128:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">exception_class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:message</span>], <span class="ruby-identifier">child_exception</span>)
-129:                 <span class="ruby-keyword kw">else</span>
-130:                         <span class="ruby-keyword kw">begin</span>
-131:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:exception</span>])
-132:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
-133:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">UnknownError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:message</span>], <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:class</span>], <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:backtrace</span>])
-134:                         <span class="ruby-keyword kw">end</span>
-135:                 <span class="ruby-keyword kw">end</span>
-136:         <span class="ruby-keyword kw">end</span>
+128:                         
+129:                         <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:class</span>]
+130:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">to_s</span>
+131:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">AppInitError</span>
+132:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">FrameworkInitError</span>.<span class="ruby-identifier">to_s</span>
+133:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">FrameworkInitError</span>
+134:                         <span class="ruby-keyword kw">else</span>
+135:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">InitializationError</span>
+136:                         <span class="ruby-keyword kw">end</span>
+137:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">exception_class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:message</span>], <span class="ruby-identifier">child_exception</span>)
+138:                 <span class="ruby-keyword kw">else</span>
+139:                         <span class="ruby-keyword kw">begin</span>
+140:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:exception</span>])
+141:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
+142:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">UnknownError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:message</span>], <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:class</span>], <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:backtrace</span>])
+143:                         <span class="ruby-keyword kw">end</span>
+144:                 <span class="ruby-keyword kw">end</span>
+145:         <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>