RubyGems - passenger - Versions diffs - 2.2.1 → 2.2.2 - Mend

passenger 2.2.1 → 2.2.2

Potentially problematic release.

This version of passenger might be problematic. Click here for more details.

Files changed (216) hide show

data/doc/rdoc/classes/PhusionPassenger/UnknownError.html DELETED Viewed

@@ -1,125 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: PhusionPassenger::UnknownError</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "show source"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "hide source"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::UnknownError</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-StandardError
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000121">new</a></li>
-  </ul>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>real_class_name</td>
-    <td class='attr-desc'></td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000121"></a><b>new</b>(message, class_name, backtrace)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000121_source')" id="l_M000121_source">show source</a> ]</p>
-  <div id="M000121_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/exceptions.rb, line 93</span>
-93:         <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>)
-94:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-node">&quot;#{message} (#{class_name})&quot;</span>)
-95:                 <span class="ruby-identifier">set_backtrace</span>(<span class="ruby-identifier">backtrace</span>)
-96:                 <span class="ruby-ivar">@real_class_name</span> = <span class="ruby-identifier">class_name</span>
-97:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/classes/PhusionPassenger/Utils.html DELETED Viewed

@@ -1,694 +0,0 @@
-<?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>Module: PhusionPassenger::Utils</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">Module</span><br />PhusionPassenger::Utils</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>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-Utility functions.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000074">assert_valid_app_root</a></li>
-  <li><a href="#M000075">assert_valid_directory</a></li>
-  <li><a href="#M000076">assert_valid_file</a></li>
-  <li><a href="#M000078">assert_valid_groupname</a></li>
-  <li><a href="#M000077">assert_valid_username</a></li>
-  <li><a href="#M000073">canonicalize_path</a></li>
-  <li><a href="#M000079">close_all_io_objects_for_fds</a></li>
-  <li><a href="#M000086">lower_privilege</a></li>
-  <li><a href="#M000080">marshal_exception</a></li>
-  <li><a href="#M000089">passenger_tmpdir</a></li>
-  <li><a href="#M000082">print_exception</a></li>
-  <li><a href="#M000084">report_app_init_status</a></li>
-  <li><a href="#M000083">safe_fork</a></li>
-  <li><a href="#M000088">sanitize_spawn_options</a></li>
-  <li><a href="#M000087">switch_to_user</a></li>
-  <li><a href="#M000085">unmarshal_and_raise_errors</a></li>
-  <li><a href="#M000081">unmarshal_exception</a></li>
-  </ul>
-<div class="sectiontitle">Protected Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000074"></a><b>assert_valid_app_root</b>(app_root)
-  </div>
-  <div class="description">
-  <p>
-Assert that <tt>app_root</tt> is a valid Ruby on Rails application root.
-Raises <a href="InvalidPath.html">InvalidPath</a> if that is not the case.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000074_source')" id="l_M000074_source">show source</a> ]</p>
-  <div id="M000074_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 59</span>
-59:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_app_root</span>(<span class="ruby-identifier">app_root</span>)
-60:                 <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">app_root</span>)
-61:                 <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-node">&quot;#{app_root}/config/environment.rb&quot;</span>)
-62:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000075"></a><b>assert_valid_directory</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Assert that <tt>path</tt> is a directory. Raises <tt><a
-href="InvalidPath.html">InvalidPath</a></tt> if it isn&#8216;t.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000075_source')" id="l_M000075_source">show source</a> ]</p>
-  <div id="M000075_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 65</span>
-65:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_directory</span>(<span class="ruby-identifier">path</span>)
-66:                 <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>)
-67:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidPath</span>, <span class="ruby-node">&quot;'#{path}' is not a valid directory.&quot;</span>
-68:                 <span class="ruby-keyword kw">end</span>
-69:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000076"></a><b>assert_valid_file</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Assert that <tt>path</tt> is a file. Raises <tt><a
-href="InvalidPath.html">InvalidPath</a></tt> if it isn&#8216;t.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000076_source')" id="l_M000076_source">show source</a> ]</p>
-  <div id="M000076_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 72</span>
-72:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_file</span>(<span class="ruby-identifier">path</span>)
-73:                 <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>)
-74:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidPath</span>, <span class="ruby-node">&quot;'#{path}' is not a valid file.&quot;</span>
-75:                 <span class="ruby-keyword kw">end</span>
-76:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000078"></a><b>assert_valid_groupname</b>(groupname)
-  </div>
-  <div class="description">
-  <p>
-Assert that <tt>groupname</tt> is a valid group name. Raises ArgumentError
-if that is not the case.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">show source</a> ]</p>
-  <div id="M000078_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 87</span>
-87:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_groupname</span>(<span class="ruby-identifier">groupname</span>)
-88:                 <span class="ruby-comment cmt"># If groupname does not exist then getgrnam() will raise an ArgumentError.</span>
-89:                 <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>)
-90:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000077"></a><b>assert_valid_username</b>(username)
-  </div>
-  <div class="description">
-  <p>
-Assert that <tt>username</tt> is a valid username. Raises ArgumentError if
-that is not the case.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">show source</a> ]</p>
-  <div id="M000077_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 80</span>
-80:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_valid_username</span>(<span class="ruby-identifier">username</span>)
-81:                 <span class="ruby-comment cmt"># If username does not exist then getpwnam() will raise an ArgumentError.</span>
-82:                 <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>)
-83:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000073"></a><b>canonicalize_path</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Return the canonicalized version of <tt>path</tt>. This path is guaranteed
-to to be &quot;normal&quot;, i.e. it doesn&#8216;t contain stuff like
-&quot;..&quot; or &quot;/&quot;, and it fully resolves symbolic links.
-</p>
-<p>
-Raises SystemCallError if something went wrong. Raises ArgumentError if
-<tt>path</tt> is nil. Raises <a href="InvalidPath.html">InvalidPath</a> if
-<tt>path</tt> does not appear to be a valid path.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">show source</a> ]</p>
-  <div id="M000073_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 50</span>
-50:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">canonicalize_path</span>(<span class="ruby-identifier">path</span>)
-51:                 <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>
-52:                 <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>
-53:         <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>
-54:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidAPath</span>, <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span>
-55:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000079"></a><b>close_all_io_objects_for_fds</b>(file_descriptors_to_leave_open)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">show source</a> ]</p>
-  <div id="M000079_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 92</span>
- 92:         <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_leave_open</span>)
- 93:                 <span class="ruby-constant">ObjectSpace</span>.<span class="ruby-identifier">each_object</span>(<span class="ruby-constant">IO</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">io</span><span class="ruby-operator">|</span>
- 94:                         <span class="ruby-keyword kw">begin</span>
- 95:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">file_descriptors_to_leave_open</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">io</span>.<span class="ruby-identifier">fileno</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">io</span>.<span class="ruby-identifier">closed?</span>
- 96:                                         <span class="ruby-identifier">io</span>.<span class="ruby-identifier">close</span>
- 97:                                 <span class="ruby-keyword kw">end</span>
- 98:                         <span class="ruby-keyword kw">rescue</span>
- 99:                         <span class="ruby-keyword kw">end</span>
-100:                 <span class="ruby-keyword kw">end</span>
-101:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000086"></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('M000086_source')" id="l_M000086_source">show source</a> ]</p>
-  <div id="M000086_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 279</span>
-279:         <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>)
-280:                 <span class="ruby-identifier">stat</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">lstat</span>(<span class="ruby-identifier">filename</span>)
-281:                 <span class="ruby-keyword kw">begin</span>
-282:                         <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>)
-283:                                 <span class="ruby-identifier">switch_to_user</span>(<span class="ruby-identifier">lowest_user</span>)
-284:                         <span class="ruby-keyword kw">end</span>
-285:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EPERM</span>
-286:                         <span class="ruby-comment cmt"># No problem if we were unable to switch user.</span>
-287:                 <span class="ruby-keyword kw">end</span>
-288:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000080"></a><b>marshal_exception</b>(exception)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000080_source')" id="l_M000080_source">show source</a> ]</p>
-  <div id="M000080_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 103</span>
-103:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">marshal_exception</span>(<span class="ruby-identifier">exception</span>)
-104:                 <span class="ruby-identifier">data</span> = {
-105:                         <span class="ruby-identifier">:message</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">message</span>,
-106:                         <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>,
-107:                         <span class="ruby-identifier">:backtrace</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>
-108:                 }
-109:                 <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>)
-110:                         <span class="ruby-identifier">data</span>[<span class="ruby-identifier">:is_initialization_error</span>] = <span class="ruby-keyword kw">true</span>
-111:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">child_exception</span>
-112:                                 <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>)
-113:                         <span class="ruby-keyword kw">end</span>
-114:                 <span class="ruby-keyword kw">else</span>
-115:                         <span class="ruby-keyword kw">begin</span>
-116:                                 <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>)
-117:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
-118:                                 <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>,
-119:                                                         <span class="ruby-identifier">exception</span>.<span class="ruby-identifier">backtrace</span>)
-120:                                 <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>)
-121:                         <span class="ruby-keyword kw">end</span>
-122:                 <span class="ruby-keyword kw">end</span>
-123:                 <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>)
-124:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000089"></a><b>passenger_tmpdir</b>(create = true)
-  </div>
-  <div class="description">
-  <p>
-Returns the directory in which to store Phusion Passenger-specific
-temporary files. If <tt>create</tt> is true, then this method creates the
-directory if it doesn&#8216;t exist.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000089_source')" id="l_M000089_source">show source</a> ]</p>
-  <div id="M000089_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 343</span>
-343:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">passenger_tmpdir</span>(<span class="ruby-identifier">create</span> = <span class="ruby-keyword kw">true</span>)
-344:                 <span class="ruby-identifier">dir</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PASSENGER_INSTANCE_TEMP_DIR'</span>]
-345:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">dir</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">dir</span>.<span class="ruby-identifier">empty?</span>
-346:                         <span class="ruby-identifier">dir</span> = <span class="ruby-node">&quot;#{Dir.tmpdir}/passenger.#{Process.pid}&quot;</span>
-347:                         <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PASSENGER_INSTANCE_TEMP_DIR'</span>] = <span class="ruby-identifier">dir</span>
-348:                 <span class="ruby-keyword kw">end</span>
-349:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">create</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">dir</span>)
-350:                         <span class="ruby-comment cmt"># This is a very minimal implementation of the function</span>
-351:                         <span class="ruby-comment cmt"># passengerCreateTempDir() in Utils.cpp. This implementation</span>
-352:                         <span class="ruby-comment cmt"># is only meant to make the unit tests pass. For production</span>
-353:                         <span class="ruby-comment cmt"># systems one should pre-create the temp directory with</span>
-354:                         <span class="ruby-comment cmt"># passengerCreateTempDir().</span>
-355:                         <span class="ruby-identifier">system</span>(<span class="ruby-value str">&quot;mkdir&quot;</span>, <span class="ruby-value str">&quot;-p&quot;</span>, <span class="ruby-value str">&quot;-m&quot;</span>, <span class="ruby-value str">&quot;u=wxs,g=wx,o=wx&quot;</span>, <span class="ruby-identifier">dir</span>)
-356:                         <span class="ruby-identifier">system</span>(<span class="ruby-value str">&quot;mkdir&quot;</span>, <span class="ruby-value str">&quot;-p&quot;</span>, <span class="ruby-value str">&quot;-m&quot;</span>, <span class="ruby-value str">&quot;u=wxs,g=wx,o=wx&quot;</span>, <span class="ruby-node">&quot;#{dir}/backends&quot;</span>)
-357:                 <span class="ruby-keyword kw">end</span>
-358:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dir</span>
-359:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000082"></a><b>print_exception</b>(current_location, exception)
-  </div>
-  <div class="description">
-  <p>
-Print the given exception, including the stack trace, to STDERR.
-</p>
-<p>
-<tt>current_location</tt> is a string which describes where the code is
-currently at. Usually the current class name will be enough.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">show source</a> ]</p>
-  <div id="M000082_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 157</span>
-157:         <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>)
-158:                 <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>)
-159:                         <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>))
-160:                         <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">flush</span>
-161:                 <span class="ruby-keyword kw">end</span>
-162:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000084"></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('M000084_source')" id="l_M000084_source">show source</a> ]</p>
-  <div id="M000084_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 206</span>
-206:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">report_app_init_status</span>(<span class="ruby-identifier">channel</span>)
-207:                 <span class="ruby-keyword kw">begin</span>
-208:                         <span class="ruby-identifier">old_global_stderr</span> = <span class="ruby-identifier">$stderr</span>
-209:                         <span class="ruby-identifier">old_stderr</span> = <span class="ruby-constant">STDERR</span>
-210:                         <span class="ruby-identifier">stderr_output</span> = <span class="ruby-value str">&quot;&quot;</span>
-211:                         <span class="ruby-identifier">tempfile</span> = <span class="ruby-constant">Tempfile</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'passenger-stderr'</span>)
-212:                         <span class="ruby-identifier">tempfile</span>.<span class="ruby-identifier">unlink</span>
-213:                         <span class="ruby-constant">Object</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">:remove_const</span>, <span class="ruby-value str">'STDERR'</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
-214:                         <span class="ruby-constant">Object</span>.<span class="ruby-identifier">const_set</span>(<span class="ruby-value str">'STDERR'</span>, <span class="ruby-identifier">tempfile</span>)
-215:                         <span class="ruby-keyword kw">begin</span>
-216:                                 <span class="ruby-keyword kw">yield</span>
-217:                         <span class="ruby-keyword kw">ensure</span>
-218:                                 <span class="ruby-constant">Object</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">:remove_const</span>, <span class="ruby-value str">'STDERR'</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
-219:                                 <span class="ruby-constant">Object</span>.<span class="ruby-identifier">const_set</span>(<span class="ruby-value str">'STDERR'</span>, <span class="ruby-identifier">old_stderr</span>)
-220:                                 <span class="ruby-identifier">$stderr</span> = <span class="ruby-identifier">old_global_stderr</span>
-221:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tempfile</span>
-222:                                         <span class="ruby-identifier">tempfile</span>.<span class="ruby-identifier">rewind</span>
-223:                                         <span class="ruby-identifier">stderr_output</span> = <span class="ruby-identifier">tempfile</span>.<span class="ruby-identifier">read</span>
-224:                                         <span class="ruby-identifier">tempfile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
-225:                                 <span class="ruby-keyword kw">end</span>
-226:                         <span class="ruby-keyword kw">end</span>
-227:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'success'</span>)
-228:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
-229:                 <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>
-230:                         <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>
-231:                                 <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>)
-232:                         <span class="ruby-keyword kw">end</span>
-233:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'exception'</span>)
-234:                         <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>))
-235:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">stderr_output</span>)
-236:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-237:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SystemExit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-238:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">'exit'</span>)
-239:                         <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>))
-240:                         <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">stderr_output</span>)
-241:                         <span class="ruby-identifier">raise</span>
-242:                 <span class="ruby-keyword kw">end</span>
-243:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000083"></a><b>safe_fork</b>(current_location = self.class, double_fork = false) {|| ...}
-  </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
-<tt>current_location</tt> as the source. Futhermore, the child process will
-exit by calling Kernel#exit!, thereby bypassing any at_exit or ensure
-blocks.
-</p>
-<p>
-If <tt>double_fork</tt> is true, then the child process will fork and
-immediately exit. This technique can be used to avoid zombie processes, at
-the expense of not being able to waitpid() the second child.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">show source</a> ]</p>
-  <div id="M000083_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 174</span>
-174:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">safe_fork</span>(<span class="ruby-identifier">current_location</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>, <span class="ruby-identifier">double_fork</span> = <span class="ruby-keyword kw">false</span>)
-175:                 <span class="ruby-identifier">pid</span> = <span class="ruby-identifier">fork</span>
-176:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid</span>.<span class="ruby-identifier">nil?</span>
-177:                         <span class="ruby-keyword kw">begin</span>
-178:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">double_fork</span>
-179:                                         <span class="ruby-identifier">pid2</span> = <span class="ruby-identifier">fork</span>
-180:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid2</span>.<span class="ruby-identifier">nil?</span>
-181:                                                 <span class="ruby-keyword kw">yield</span>
-182:                                         <span class="ruby-keyword kw">end</span>
-183:                                 <span class="ruby-keyword kw">else</span>
-184:                                         <span class="ruby-keyword kw">yield</span>
-185:                                 <span class="ruby-keyword kw">end</span>
-186:                         <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>
-187:                                 <span class="ruby-identifier">print_exception</span>(<span class="ruby-identifier">current_location</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-identifier">e</span>)
-188:                         <span class="ruby-keyword kw">ensure</span>
-189:                                 <span class="ruby-identifier">exit!</span>
-190:                         <span class="ruby-keyword kw">end</span>
-191:                 <span class="ruby-keyword kw">else</span>
-192:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">double_fork</span>
-193:                                 <span class="ruby-constant">Process</span>.<span class="ruby-identifier">waitpid</span>(<span class="ruby-identifier">pid</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
-194:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">pid</span>
-195:                         <span class="ruby-keyword kw">else</span>
-196:                                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">pid</span>
-197:                         <span class="ruby-keyword kw">end</span>
-198:                 <span class="ruby-keyword kw">end</span>
-199:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000088"></a><b>sanitize_spawn_options</b>(options)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">show source</a> ]</p>
-  <div id="M000088_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 323</span>
-323:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
-324:                 <span class="ruby-identifier">defaults</span> = {
-325:                         <span class="ruby-value str">&quot;lower_privilege&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">true</span>,
-326:                         <span class="ruby-value str">&quot;lowest_user&quot;</span>     =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;nobody&quot;</span>,
-327:                         <span class="ruby-value str">&quot;environment&quot;</span>     =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;production&quot;</span>,
-328:                         <span class="ruby-value str">&quot;app_type&quot;</span>        =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;rails&quot;</span>,
-329:                         <span class="ruby-value str">&quot;spawn_method&quot;</span>    =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;smart-lv2&quot;</span>,
-330:                         <span class="ruby-value str">&quot;framework_spawner_timeout&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">-1</span>,
-331:                         <span class="ruby-value str">&quot;app_spawner_timeout&quot;</span>       =<span class="ruby-operator">&gt;</span> <span class="ruby-value">-1</span>
-332:                 }
-333:                 <span class="ruby-identifier">options</span> = <span class="ruby-identifier">defaults</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">options</span>)
-334:                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;lower_privilege&quot;</span>]           = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;lower_privilege&quot;</span>].<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;true&quot;</span>
-335:                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;framework_spawner_timeout&quot;</span>] = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;framework_spawner_timeout&quot;</span>].<span class="ruby-identifier">to_i</span>
-336:                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_spawner_timeout&quot;</span>]       = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_spawner_timeout&quot;</span>].<span class="ruby-identifier">to_i</span>
-337:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">options</span>
-338:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000087"></a><b>switch_to_user</b>(user)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000087_source')" id="l_M000087_source">show source</a> ]</p>
-  <div id="M000087_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 290</span>
-290:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">switch_to_user</span>(<span class="ruby-identifier">user</span>)
-291:                 <span class="ruby-keyword kw">begin</span>
-292:                         <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>)
-293:                                 <span class="ruby-identifier">pw</span> = <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwnam</span>(<span class="ruby-identifier">user</span>)
-294:                                 <span class="ruby-identifier">username</span> = <span class="ruby-identifier">user</span>
-295:                                 <span class="ruby-identifier">uid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">uid</span>
-296:                                 <span class="ruby-identifier">gid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">gid</span>
-297:                         <span class="ruby-keyword kw">else</span>
-298:                                 <span class="ruby-identifier">pw</span> = <span class="ruby-constant">Etc</span>.<span class="ruby-identifier">getpwuid</span>(<span class="ruby-identifier">user</span>)
-299:                                 <span class="ruby-identifier">username</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">name</span>
-300:                                 <span class="ruby-identifier">uid</span> = <span class="ruby-identifier">user</span>
-301:                                 <span class="ruby-identifier">gid</span> = <span class="ruby-identifier">pw</span>.<span class="ruby-identifier">gid</span>
-302:                         <span class="ruby-keyword kw">end</span>
-303:                 <span class="ruby-keyword kw">rescue</span>
-304:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-305:                 <span class="ruby-keyword kw">end</span>
-306:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uid</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-307:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-308:                 <span class="ruby-keyword kw">else</span>
-309:                         <span class="ruby-comment cmt"># Some systems are broken. initgroups can fail because of</span>
-310:                         <span class="ruby-comment cmt"># all kinds of stupid reasons. So we ignore any errors</span>
-311:                         <span class="ruby-comment cmt"># raised by initgroups.</span>
-312:                         <span class="ruby-keyword kw">begin</span>
-313:                                 <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>)
-314:                         <span class="ruby-keyword kw">rescue</span>
-315:                         <span class="ruby-keyword kw">end</span>
-316:                         <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>)
-317:                         <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>)
-318:                         <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>
-319:                         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
-320:                 <span class="ruby-keyword kw">end</span>
-321:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000085"></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#M000084">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('M000085_source')" id="l_M000085_source">show source</a> ]</p>
-  <div id="M000085_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 253</span>
-253:         <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>)
-254:                 <span class="ruby-identifier">args</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read</span>
-255:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">nil?</span>
-256:                         <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>
-257:                 <span class="ruby-keyword kw">end</span>
-258:                 <span class="ruby-identifier">status</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
-259:                 <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>
-260:                         <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>)
-261:                         <span class="ruby-identifier">stderr</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read_scalar</span>
-262:                         <span class="ruby-comment cmt">#print_exception(self.class.to_s, child_exception)</span>
-263:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">new</span>(
-264:                                 <span class="ruby-node">&quot;Application '#{@app_root}' raised an exception: &quot;</span> <span class="ruby-operator">&lt;&lt;</span>
-265:                                 <span class="ruby-node">&quot;#{child_exception.class} (#{child_exception.message})&quot;</span>,
-266:                                 <span class="ruby-identifier">child_exception</span>,
-267:                                 <span class="ruby-identifier">app_type</span>,
-268:                                 <span class="ruby-identifier">stderr</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">stderr</span>)
-269:                 <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>
-270:                         <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>)
-271:                         <span class="ruby-identifier">stderr</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read_scalar</span>
-272:                         <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>,
-273:                                 <span class="ruby-identifier">child_exception</span>, <span class="ruby-identifier">app_type</span>, <span class="ruby-identifier">stderr</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">stderr</span>)
-274:                 <span class="ruby-keyword kw">end</span>
-275:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000081"></a><b>unmarshal_exception</b>(data)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">show source</a> ]</p>
-  <div id="M000081_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 126</span>
-126:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">data</span>)
-127:                 <span class="ruby-identifier">hash</span> = <span class="ruby-constant">Marshal</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">data</span>)
-128:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:is_initialization_error</span>]
-129:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:child_exception</span>]
-130:                                 <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>])
-131:                         <span class="ruby-keyword kw">else</span>
-132:                                 <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>
-133:                         <span class="ruby-keyword kw">end</span>
-134:
-135:                         <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">:class</span>]
-136:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">AppInitError</span>.<span class="ruby-identifier">to_s</span>
-137:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">AppInitError</span>
-138:                         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">FrameworkInitError</span>.<span class="ruby-identifier">to_s</span>
-139:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">FrameworkInitError</span>
-140:                         <span class="ruby-keyword kw">else</span>
-141:                                 <span class="ruby-identifier">exception_class</span> = <span class="ruby-constant">InitializationError</span>
-142:                         <span class="ruby-keyword kw">end</span>
-143:                         <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>)
-144:                 <span class="ruby-keyword kw">else</span>
-145:                         <span class="ruby-keyword kw">begin</span>
-146:                                 <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>])
-147:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-constant">TypeError</span>
-148:                                 <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>])
-149:                         <span class="ruby-keyword kw">end</span>
-150:                 <span class="ruby-keyword kw">end</span>
-151:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>