RubyGems - passenger - Versions diffs - 2.2.9 → 2.2.10 - Mend

passenger 2.2.9 → 2.2.10

Potentially problematic release.

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

Files changed (435) hide show

data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html DELETED

@@ -1,199 +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::Rack::RequestHandler</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::Rack::RequestHandler</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../files/lib/phusion_passenger/rack/request_handler_rb.html">lib/phusion_passenger/rack/request_handler.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-AbstractRequestHandler
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-A request handler for <a href="../Rack.html">Rack</a> applications.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000042">new</a></li>
-  <li><a href="#M000043">process_request</a></li>
-  </ul>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000042"></a><b>new</b>(owner_pipe, app, options = {})
-  </div>
-  <div class="description">
-  <p>
-<tt>app</tt> is the <a href="../Rack.html">Rack</a> application object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000042_source')" id="l_M000042_source">show source</a> ]</p>
-  <div id="M000042_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/rack/request_handler.rb, line 56</span>
-56:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">app</span>, <span class="ruby-identifier">options</span> = {})
-57:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span>)
-58:                 <span class="ruby-ivar">@app</span> = <span class="ruby-identifier">app</span>
-59:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Protected Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000043"></a><b>process_request</b>(env, input, output)
-  </div>
-  <div class="description">
-  <p>
-Overrided method.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">show source</a> ]</p>
-  <div id="M000043_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/rack/request_handler.rb, line 63</span>
- 63:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_request</span>(<span class="ruby-identifier">env</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>)
- 64:                 <span class="ruby-identifier">rewindable_input</span> = <span class="ruby-constant">Utils</span><span class="ruby-operator">::</span><span class="ruby-constant">RewindableInput</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">input</span>)
- 65:                 <span class="ruby-keyword kw">begin</span>
- 66:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_VERSION</span>]      = <span class="ruby-constant">RACK_VERSION_VALUE</span>
- 67:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_INPUT</span>]        = <span class="ruby-identifier">rewindable_input</span>
- 68:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_ERRORS</span>]       = <span class="ruby-constant">STDERR</span>
- 69:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_MULTITHREAD</span>]  = <span class="ruby-keyword kw">false</span>
- 70:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_MULTIPROCESS</span>] = <span class="ruby-keyword kw">true</span>
- 71:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_RUN_ONCE</span>]     = <span class="ruby-keyword kw">false</span>
- 72:
- 73:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_LENGTH</span>]
- 74:                                 <span class="ruby-identifier">env</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>)
- 75:                         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_LENGTH</span>]
- 76:                                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_LENGTH</span>] = <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>]
- 77:                                 <span class="ruby-identifier">env</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>)
- 78:                         <span class="ruby-keyword kw">end</span>
- 79:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_TYPE</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_TYPE</span>]
- 80:                                 <span class="ruby-identifier">env</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">HTTP_CONTENT_TYPE</span>)
- 81:                         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_TYPE</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_TYPE</span>]
- 82:                                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">CONTENT_TYPE</span>] = <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTP_CONTENT_TYPE</span>]
- 83:                                 <span class="ruby-identifier">env</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">HTTP_CONTENT_TYPE</span>)
- 84:                         <span class="ruby-keyword kw">end</span>
- 85:
- 86:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTPS</span>] <span class="ruby-operator">==</span> <span class="ruby-constant">YES</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTPS</span>] <span class="ruby-operator">==</span> <span class="ruby-constant">ON</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">HTTPS</span>] <span class="ruby-operator">==</span> <span class="ruby-constant">ONE</span>
- 87:                                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_URL_SCHEME</span>] = <span class="ruby-constant">HTTPS_DOWNCASE</span>
- 88:                         <span class="ruby-keyword kw">else</span>
- 89:                                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_URL_SCHEME</span>] = <span class="ruby-constant">HTTP</span>
- 90:                         <span class="ruby-keyword kw">end</span>
- 91:
- 92:                         <span class="ruby-identifier">status</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">body</span> = <span class="ruby-ivar">@app</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">env</span>)
- 93:                         <span class="ruby-keyword kw">begin</span>
- 94:                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;Status: #{status.to_i}#{CRLF}&quot;</span>)
- 95:                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;X-Powered-By: #{PASSENGER_HEADER}#{CRLF}&quot;</span>)
- 96:                                 <span class="ruby-identifier">headers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">values</span><span class="ruby-operator">|</span>
- 97:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">values</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
- 98:                                                 <span class="ruby-identifier">values</span> = <span class="ruby-identifier">values</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;\n&quot;</span>)
- 99:                                         <span class="ruby-keyword kw">end</span>
-100:                                         <span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-101:                                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;#{key}: #{value}#{CRLF}&quot;</span>)
-102:                                         <span class="ruby-keyword kw">end</span>
-103:                                 <span class="ruby-keyword kw">end</span>
-104:                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-constant">CRLF</span>)
-105:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">body</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
-106:                                         <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">body</span>)
-107:                                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">body</span>
-108:                                         <span class="ruby-identifier">body</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span>
-109:                                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">s</span>)
-110:                                         <span class="ruby-keyword kw">end</span>
-111:                                 <span class="ruby-keyword kw">end</span>
-112:                         <span class="ruby-keyword kw">ensure</span>
-113:                                 <span class="ruby-identifier">body</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">body</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:close</span>)
-114:                         <span class="ruby-keyword kw">end</span>
-115:                 <span class="ruby-keyword kw">ensure</span>
-116:                         <span class="ruby-identifier">rewindable_input</span>.<span class="ruby-identifier">close</span>
-117:                 <span class="ruby-keyword kw">end</span>
-118:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/classes/PhusionPassenger/Railz.html DELETED

@@ -1,95 +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::Railz</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::Railz</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/railz/application_spawner_rb.html">lib/phusion_passenger/railz/application_spawner.rb</a>
-<a href="../../files/lib/phusion_passenger/railz/cgi_fixed_rb.html">lib/phusion_passenger/railz/cgi_fixed.rb</a>
-<a href="../../files/lib/phusion_passenger/railz/framework_spawner_rb.html">lib/phusion_passenger/railz/framework_spawner.rb</a>
-<a href="../../files/lib/phusion_passenger/railz/request_handler_rb.html">lib/phusion_passenger/railz/request_handler.rb</a>
-        </td>
-      </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Classes and Modules</div>
-  Class <a href="Railz/ApplicationSpawner.html" class="link">PhusionPassenger::Railz::ApplicationSpawner</a><br />
-Class <a href="Railz/CGIFixed.html" class="link">PhusionPassenger::Railz::CGIFixed</a><br />
-Class <a href="Railz/FrameworkSpawner.html" class="link">PhusionPassenger::Railz::FrameworkSpawner</a><br />
-Class <a href="Railz/RequestHandler.html" class="link">PhusionPassenger::Railz::RequestHandler</a><br />
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner.html DELETED

@@ -1,438 +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::Railz::ApplicationSpawner</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::Railz::ApplicationSpawner</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../files/lib/phusion_passenger/railz/application_spawner_rb.html">lib/phusion_passenger/railz/application_spawner.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-AbstractServer
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-This class is capable of spawning instances of a single Ruby on Rails
-application. It does so by preloading as much of the application&#8216;s
-code as possible, then creating instances of the application using what is
-already preloaded. This makes it spawning application instances very fast,
-except for the first spawn.
-</p>
-<p>
-Use multiple instances of <a
-href="ApplicationSpawner.html">ApplicationSpawner</a> if you need to spawn
-multiple different Ruby on Rails applications.
-</p>
-<p>
-<b>Note</b>: <a href="ApplicationSpawner.html">ApplicationSpawner</a> may
-only be started asynchronously with <a
-href="../AbstractServer.html#M000127">AbstractServer#start</a>. Starting it
-synchronously with <a
-href="../AbstractServer.html#M000128">AbstractServer#start_synchronously</a>
-has not been tested.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000069">new</a></li>
-  <li><a href="#M000070">spawn_application</a></li>
-  <li><a href="#M000071">spawn_application!</a></li>
-  <li><a href="#M000072">start</a></li>
-  </ul>
-<div class="sectiontitle">Included Modules</div>
-<ul>
-  <li><a href="../Utils.html">Utils</a></li>
-</ul>
-  <div class="sectiontitle">Classes and Modules</div>
-  Class <a href="ApplicationSpawner/Error.html" class="link">PhusionPassenger::Railz::ApplicationSpawner::Error</a><br />
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">ROOT_UID</td>
-    <td>=</td>
-    <td class="attr-value">0</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-The user ID of the root user.
-</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">ROOT_GID</td>
-    <td>=</td>
-    <td class="attr-value">0</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-The group ID of the root user.
-</td>
-  </tr>
-  </table>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[R]
-    </td>
-    <td class='attr-name'>app_root</td>
-    <td class='attr-desc'>
-The application root of this spawner.
-</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000069"></a><b>new</b>(app_root, options = {})
-  </div>
-  <div class="description">
-  <p>
-<tt>app_root</tt> is the root directory of this application, i.e. the
-directory that contains &#8216;app/&#8217;, &#8216;public/&#8217;, etc. If
-given an invalid directory, or a directory that doesn&#8216;t appear to be
-a Rails application root directory, then an <a
-href="../InvalidPath.html">InvalidPath</a> will be raised.
-</p>
-<p>
-Additional options are:
-</p>
-<ul>
-<li><tt>lower_privilege</tt> and <tt>lowest_user</tt>: If
-<tt>lower_privilege</tt> is true, then <a
-href="ApplicationSpawner.html">ApplicationSpawner</a> will attempt to
-switch to the user who owns the application&#8216;s
-<tt>config/environment.rb</tt>, and to the default group of that user.
-<p>
-If that user doesn&#8216;t exist on the system, or if that user is root,
-then <a href="ApplicationSpawner.html">ApplicationSpawner</a> will attempt
-to switch to the username given by <tt>lowest_user</tt> (and to the default
-group of that user). If <tt>lowest_user</tt> doesn&#8216;t exist either, or
-if switching user failed (because the current process does not have the
-privilege to do so), then <a
-href="ApplicationSpawner.html">ApplicationSpawner</a> will continue without
-reporting an error.
-</p>
-</li>
-<li><tt>environment</tt>: Allows one to specify the RAILS_ENV environment to
-use.
-</li>
-<li><tt>environment_variables</tt>: Environment variables which should be
-passed to the spawned application. This is NULL-seperated string of
-key-value pairs, encoded in base64. The last byte in the unencoded data
-must be a NULL.
-</li>
-<li><tt>base_uri</tt>: The base URI on which this application is deployed. It
-equals &quot;/&quot; string if the application is deployed on the root URI.
-It must not equal the empty string.
-</li>
-<li><tt>print_exceptions</tt>: Whether exceptions that have occurred during
-application initialization should be printed to STDERR. The default is
-true.
-</li>
-</ul>
-<p>
-All other options will be passed on to <a
-href="RequestHandler.html">RequestHandler</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000069_source')" id="l_M000069_source">show source</a> ]</p>
-  <div id="M000069_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 102</span>
-102:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">options</span> = {})
-103:                 <span class="ruby-keyword kw">super</span>()
-104:                 <span class="ruby-ivar">@app_root</span> = <span class="ruby-identifier">app_root</span>
-105:                 <span class="ruby-ivar">@canonicalized_app_root</span> = <span class="ruby-identifier">canonicalize_path</span>(<span class="ruby-identifier">app_root</span>)
-106:                 <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
-107:                 <span class="ruby-ivar">@lower_privilege</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;lower_privilege&quot;</span>]
-108:                 <span class="ruby-ivar">@lowest_user</span>     = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;lowest_user&quot;</span>]
-109:                 <span class="ruby-ivar">@environment</span>     = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;environment&quot;</span>]
-110:                 <span class="ruby-ivar">@encoded_environment_variables</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;environment_variables&quot;</span>]
-111:                 <span class="ruby-ivar">@base_uri</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;base_uri&quot;</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;base_uri&quot;</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;base_uri&quot;</span>] <span class="ruby-operator">!=</span> <span class="ruby-value str">&quot;/&quot;</span>
-112:                 <span class="ruby-ivar">@print_exceptions</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;print_exceptions&quot;</span>]
-113:                 <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">max_idle_time</span> = <span class="ruby-constant">DEFAULT_APP_SPAWNER_MAX_IDLE_TIME</span>
-114:                 <span class="ruby-identifier">assert_valid_app_root</span>(<span class="ruby-ivar">@app_root</span>)
-115:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
-116:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000070"></a><b>spawn_application</b>()
-  </div>
-  <div class="description">
-  <p>
-Spawn an instance of the RoR application. When successful, an <a
-href="../Application.html">Application</a> object will be returned, which
-represents the spawned RoR application.
-</p>
-<p>
-Raises:
-</p>
-<ul>
-<li><a
-href="../AbstractServer/ServerNotStarted.html">AbstractServer::ServerNotStarted</a>:
-The <a href="ApplicationSpawner.html">ApplicationSpawner</a> server
-hasn&#8216;t already been started.
-</li>
-<li><a href="ApplicationSpawner/Error.html">ApplicationSpawner::Error</a>: The
-<a href="ApplicationSpawner.html">ApplicationSpawner</a> server exited
-unexpectedly.
-</li>
-</ul>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000070_source')" id="l_M000070_source">show source</a> ]</p>
-  <div id="M000070_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 124</span>
-124:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>
-125:                 <span class="ruby-identifier">server</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;spawn_application&quot;</span>)
-126:                 <span class="ruby-identifier">pid</span>, <span class="ruby-identifier">socket_name</span>, <span class="ruby-identifier">socket_type</span> = <span class="ruby-identifier">server</span>.<span class="ruby-identifier">read</span>
-127:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid</span>.<span class="ruby-identifier">nil?</span>
-128:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;Connection closed&quot;</span>
-129:                 <span class="ruby-keyword kw">end</span>
-130:                 <span class="ruby-identifier">owner_pipe</span> = <span class="ruby-identifier">server</span>.<span class="ruby-identifier">recv_io</span>
-131:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Application</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@app_root</span>, <span class="ruby-identifier">pid</span>, <span class="ruby-identifier">socket_name</span>,
-132:                         <span class="ruby-identifier">socket_type</span>, <span class="ruby-identifier">owner_pipe</span>)
-133:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SystemCallError</span>, <span class="ruby-constant">IOError</span>, <span class="ruby-constant">SocketError</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-134:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-node">&quot;The application spawner server exited unexpectedly: #{e}&quot;</span>
-135:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000071"></a><b>spawn_application!</b>()
-  </div>
-  <div class="description">
-  <p>
-Spawn an instance of the RoR application. When successful, an <a
-href="../Application.html">Application</a> object will be returned, which
-represents the spawned RoR application.
-</p>
-<p>
-Unlike <a href="ApplicationSpawner.html#M000070">spawn_application</a>,
-this method may be called even when the <a
-href="ApplicationSpawner.html">ApplicationSpawner</a> server isn&#8216;t
-started. This allows one to spawn a RoR application without preloading any
-source files.
-</p>
-<p>
-This method may only be called if no Rails framework has been loaded in the
-current Ruby VM.
-</p>
-<p>
-Raises:
-</p>
-<ul>
-<li><a href="../AppInitError.html">AppInitError</a>: The Ruby on Rails
-application raised an exception or called exit() during startup.
-</li>
-<li>SystemCallError, IOError, SocketError: Something went wrong.
-</li>
-</ul>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000071_source')" id="l_M000071_source">show source</a> ]</p>
-  <div id="M000071_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 151</span>
-151:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application!</span>
-152:                 <span class="ruby-identifier">a</span>, <span class="ruby-identifier">b</span> = <span class="ruby-constant">UNIXSocket</span>.<span class="ruby-identifier">pair</span>
-153:                 <span class="ruby-identifier">pid</span> = <span class="ruby-identifier">safe_fork</span>(<span class="ruby-value str">'application'</span>, <span class="ruby-keyword kw">true</span>) <span class="ruby-keyword kw">do</span>
-154:                         <span class="ruby-keyword kw">begin</span>
-155:                                 <span class="ruby-identifier">a</span>.<span class="ruby-identifier">close</span>
-156:
-157:                                 <span class="ruby-identifier">file_descriptors_to_leave_open</span> = [<span class="ruby-value">0</span>, <span class="ruby-value">1</span>, <span class="ruby-value">2</span>, <span class="ruby-identifier">b</span>.<span class="ruby-identifier">fileno</span>]
-158:                                 <span class="ruby-constant">NativeSupport</span>.<span class="ruby-identifier">close_all_file_descriptors</span>(<span class="ruby-identifier">file_descriptors_to_leave_open</span>)
-159:                                 <span class="ruby-identifier">close_all_io_objects_for_fds</span>(<span class="ruby-identifier">file_descriptors_to_leave_open</span>)
-160:
-161:                                 <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">b</span>)
-162:                                 <span class="ruby-identifier">success</span> = <span class="ruby-identifier">report_app_init_status</span>(<span class="ruby-identifier">channel</span>) <span class="ruby-keyword kw">do</span>
-163:                                         <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'RAILS_ENV'</span>] = <span class="ruby-ivar">@environment</span>
-164:                                         <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'RAILS_RELATIVE_URL_ROOT'</span>] = <span class="ruby-ivar">@base_uri</span>
-165:                                         <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-ivar">@app_root</span>)
-166:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@encoded_environment_variables</span>
-167:                                                 <span class="ruby-identifier">set_passed_environment_variables</span>
-168:                                         <span class="ruby-keyword kw">end</span>
-169:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@lower_privilege</span>
-170:                                                 <span class="ruby-identifier">lower_privilege</span>(<span class="ruby-value str">'config/environment.rb'</span>, <span class="ruby-ivar">@lowest_user</span>)
-171:                                         <span class="ruby-keyword kw">end</span>
-172:
-173:                                         <span class="ruby-identifier">require</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-value str">'config/environment'</span>)
-174:                                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'dispatcher'</span>
-175:                                 <span class="ruby-keyword kw">end</span>
-176:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">success</span>
-177:                                         <span class="ruby-identifier">start_request_handler</span>(<span class="ruby-identifier">channel</span>, <span class="ruby-keyword kw">false</span>)
-178:                                 <span class="ruby-keyword kw">end</span>
-179:                         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SignalException</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-180:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">AbstractRequestHandler</span><span class="ruby-operator">::</span><span class="ruby-constant">HARD_TERMINATION_SIGNAL</span> <span class="ruby-operator">&amp;&amp;</span>
-181:                                    <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">AbstractRequestHandler</span><span class="ruby-operator">::</span><span class="ruby-constant">SOFT_TERMINATION_SIGNAL</span>
-182:                                         <span class="ruby-identifier">raise</span>
-183:                                 <span class="ruby-keyword kw">end</span>
-184:                         <span class="ruby-keyword kw">end</span>
-185:                 <span class="ruby-keyword kw">end</span>
-186:                 <span class="ruby-identifier">b</span>.<span class="ruby-identifier">close</span>
-187:                 <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>
-188:
-189:                 <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">a</span>)
-190:                 <span class="ruby-identifier">unmarshal_and_raise_errors</span>(<span class="ruby-identifier">channel</span>, <span class="ruby-ivar">@print_exceptions</span>)
-191:
-192:                 <span class="ruby-comment cmt"># No exception was raised, so spawning succeeded.</span>
-193:                 <span class="ruby-identifier">pid</span>, <span class="ruby-identifier">socket_name</span>, <span class="ruby-identifier">socket_type</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read</span>
-194:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid</span>.<span class="ruby-identifier">nil?</span>
-195:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;Connection closed&quot;</span>
-196:                 <span class="ruby-keyword kw">end</span>
-197:                 <span class="ruby-identifier">owner_pipe</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">recv_io</span>
-198:                 <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Application</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@app_root</span>, <span class="ruby-identifier">pid</span>, <span class="ruby-identifier">socket_name</span>,
-199:                         <span class="ruby-identifier">socket_type</span>, <span class="ruby-identifier">owner_pipe</span>)
-200:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000072"></a><b>start</b>()
-  </div>
-  <div class="description">
-  <p>
-Overrided from <a
-href="../AbstractServer.html#M000127">AbstractServer#start</a>.
-</p>
-<p>
-May raise these additional exceptions:
-</p>
-<ul>
-<li><a href="../AppInitError.html">AppInitError</a>: The Ruby on Rails
-application raised an exception or called exit() during startup.
-</li>
-<li><a href="ApplicationSpawner/Error.html">ApplicationSpawner::Error</a>: The
-<a href="ApplicationSpawner.html">ApplicationSpawner</a> server exited
-unexpectedly.
-</li>
-</ul>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show source</a> ]</p>
-  <div id="M000072_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 208</span>
-208:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start</span>
-209:                 <span class="ruby-keyword kw">super</span>
-210:                 <span class="ruby-keyword kw">begin</span>
-211:                         <span class="ruby-identifier">unmarshal_and_raise_errors</span>(<span class="ruby-identifier">server</span>, <span class="ruby-ivar">@print_exceptions</span>)
-212:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">IOError</span>, <span class="ruby-constant">SystemCallError</span>, <span class="ruby-constant">SocketError</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-213:                         <span class="ruby-identifier">stop</span>
-214:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-node">&quot;The application spawner server exited unexpectedly: #{e}&quot;</span>
-215:                 <span class="ruby-keyword kw">rescue</span>
-216:                         <span class="ruby-identifier">stop</span>
-217:                         <span class="ruby-identifier">raise</span>
-218:                 <span class="ruby-keyword kw">end</span>
-219:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>