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/Rack/RequestHandler.html DELETED Viewed

@@ -1,184 +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="#M000056">new</a></li>
-  <li><a href="#M000057">process_request</a></li>
-  </ul>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000056"></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('M000056_source')" id="l_M000056_source">show source</a> ]</p>
-  <div id="M000056_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/rack/request_handler.rb, line 50</span>
-50:         <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> = {})
-51:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span>)
-52:                 <span class="ruby-ivar">@app</span> = <span class="ruby-identifier">app</span>
-53:         <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="M000057"></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('M000057_source')" id="l_M000057_source">show source</a> ]</p>
-  <div id="M000057_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/rack/request_handler.rb, line 57</span>
-57:         <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>)
-58:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_VERSION</span>]      = <span class="ruby-constant">RACK_VERSION_VALUE</span>
-59:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_INPUT</span>]        = <span class="ruby-identifier">input</span>
-60:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_ERRORS</span>]       = <span class="ruby-constant">STDERR</span>
-61:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_MULTITHREAD</span>]  = <span class="ruby-keyword kw">false</span>
-62:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_MULTIPROCESS</span>] = <span class="ruby-keyword kw">true</span>
-63:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_RUN_ONCE</span>]     = <span class="ruby-keyword kw">false</span>
-64:                 <span class="ruby-identifier">env</span>[<span class="ruby-constant">SCRIPT_NAME</span>]     <span class="ruby-operator">||=</span> <span class="ruby-value str">''</span>
-65:                 <span class="ruby-keyword kw">if</span> <span class="ruby-constant">ENV</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-constant">PATH_INFO</span>)
-66:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">PATH_INFO</span>].<span class="ruby-identifier">sub!</span>(<span class="ruby-node">/^#{Regexp.escape(env[SCRIPT_NAME])}/</span>, <span class="ruby-value str">&quot;&quot;</span>)
-67:                 <span class="ruby-keyword kw">end</span>
-68:                 <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>
-69:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_URL_SCHEME</span>] = <span class="ruby-constant">HTTPS_DOWNCASE</span>
-70:                 <span class="ruby-keyword kw">else</span>
-71:                         <span class="ruby-identifier">env</span>[<span class="ruby-constant">RACK_URL_SCHEME</span>] = <span class="ruby-constant">HTTP</span>
-72:                 <span class="ruby-keyword kw">end</span>
-73:
-74:                 <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>)
-75:                 <span class="ruby-keyword kw">begin</span>
-76:                         <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;Status: #{status}#{CRLF}&quot;</span>)
-77:                         <span class="ruby-identifier">headers</span>[<span class="ruby-constant">X_POWERED_BY</span>] = <span class="ruby-constant">PASSENGER_HEADER</span>
-78:                         <span class="ruby-identifier">headers</span>.<span class="ruby-identifier">each_pair</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>
-79:                                 <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>)
-80:                                         <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>)
-81:                                 <span class="ruby-keyword kw">end</span>
-82:                                 <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>
-83:                                         <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">&quot;#{key}: #{value}#{CRLF}&quot;</span>)
-84:                                 <span class="ruby-keyword kw">end</span>
-85:                         <span class="ruby-keyword kw">end</span>
-86:                         <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-constant">CRLF</span>)
-87:                         <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>)
-88:                                 <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">body</span>)
-89:                         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">body</span>
-90:                                 <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>
-91:                                         <span class="ruby-identifier">output</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">s</span>)
-92:                                 <span class="ruby-keyword kw">end</span>
-93:                         <span class="ruby-keyword kw">end</span>
-94:                 <span class="ruby-keyword kw">ensure</span>
-95:                         <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>)
-96:                 <span class="ruby-keyword kw">end</span>
-97:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

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

@@ -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 Viewed

@@ -1,419 +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#M000126">AbstractServer#start</a>. Starting it
-synchronously with <a
-href="../AbstractServer.html#M000127">AbstractServer#start_synchronously</a>
-has not been tested.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000048">new</a></li>
-  <li><a href="#M000049">spawn_application</a></li>
-  <li><a href="#M000050">spawn_application!</a></li>
-  <li><a href="#M000051">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="M000048"></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>
-</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('M000048_source')" id="l_M000048_source">show source</a> ]</p>
-  <div id="M000048_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 88</span>
-88:         <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> = {})
-89:                 <span class="ruby-keyword kw">super</span>()
-90:                 <span class="ruby-ivar">@app_root</span> = <span class="ruby-identifier">app_root</span>
-91:                 <span class="ruby-ivar">@canonicalized_app_root</span> = <span class="ruby-identifier">canonicalize_path</span>(<span class="ruby-identifier">app_root</span>)
-92:                 <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
-93:                 <span class="ruby-ivar">@lower_privilege</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;lower_privilege&quot;</span>]
-94:                 <span class="ruby-ivar">@lowest_user</span>     = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;lowest_user&quot;</span>]
-95:                 <span class="ruby-ivar">@environment</span>     = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;environment&quot;</span>]
-96:                 <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>
-97:                 <span class="ruby-identifier">assert_valid_app_root</span>(<span class="ruby-ivar">@app_root</span>)
-98:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
-99:         <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="M000049"></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('M000049_source')" id="l_M000049_source">show source</a> ]</p>
-  <div id="M000049_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 107</span>
-107:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>
-108:                 <span class="ruby-identifier">server</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;spawn_application&quot;</span>)
-109:                 <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>
-110:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid</span>.<span class="ruby-identifier">nil?</span>
-111:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;Connection closed&quot;</span>
-112:                 <span class="ruby-keyword kw">end</span>
-113:                 <span class="ruby-identifier">owner_pipe</span> = <span class="ruby-identifier">server</span>.<span class="ruby-identifier">recv_io</span>
-114:                 <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>,
-115:                         <span class="ruby-identifier">socket_type</span>, <span class="ruby-identifier">owner_pipe</span>)
-116:         <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>
-117:                 <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>
-118:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000050"></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#M000049">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('M000050_source')" id="l_M000050_source">show source</a> ]</p>
-  <div id="M000050_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 134</span>
-134:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application!</span>
-135:                 <span class="ruby-identifier">a</span>, <span class="ruby-identifier">b</span> = <span class="ruby-constant">UNIXSocket</span>.<span class="ruby-identifier">pair</span>
-136:                 <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>
-137:                         <span class="ruby-keyword kw">begin</span>
-138:                                 <span class="ruby-identifier">a</span>.<span class="ruby-identifier">close</span>
-139:
-140:                                 <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>]
-141:                                 <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>)
-142:                                 <span class="ruby-identifier">close_all_io_objects_for_fds</span>(<span class="ruby-identifier">file_descriptors_to_leave_open</span>)
-143:
-144:                                 <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">b</span>)
-145:                                 <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>
-146:                                         <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'RAILS_ENV'</span>] = <span class="ruby-ivar">@environment</span>
-147:                                         <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-ivar">@app_root</span>)
-148:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@lower_privilege</span>
-149:                                                 <span class="ruby-identifier">lower_privilege</span>(<span class="ruby-value str">'config/environment.rb'</span>, <span class="ruby-ivar">@lowest_user</span>)
-150:                                         <span class="ruby-keyword kw">end</span>
-151:
-152:                                         <span class="ruby-comment cmt"># require Rails' environment, using the same path as the original rails dispatcher,</span>
-153:                                         <span class="ruby-comment cmt"># which normally does: require File.dirname(__FILE__) + &quot;/../config/environment&quot;</span>
-154:                                         <span class="ruby-comment cmt"># thus avoiding the possibility of including the same file twice.</span>
-155:                                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'public/../config/environment'</span>
-156:
-157:                                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'dispatcher'</span>
-158:                                 <span class="ruby-keyword kw">end</span>
-159:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">success</span>
-160:                                         <span class="ruby-identifier">start_request_handler</span>(<span class="ruby-identifier">channel</span>, <span class="ruby-keyword kw">false</span>)
-161:                                 <span class="ruby-keyword kw">end</span>
-162:                         <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>
-163:                                 <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>
-164:                                    <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>
-165:                                         <span class="ruby-identifier">raise</span>
-166:                                 <span class="ruby-keyword kw">end</span>
-167:                         <span class="ruby-keyword kw">end</span>
-168:                 <span class="ruby-keyword kw">end</span>
-169:                 <span class="ruby-identifier">b</span>.<span class="ruby-identifier">close</span>
-170:                 <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>
-171:
-172:                 <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">a</span>)
-173:                 <span class="ruby-identifier">unmarshal_and_raise_errors</span>(<span class="ruby-identifier">channel</span>)
-174:
-175:                 <span class="ruby-comment cmt"># No exception was raised, so spawning succeeded.</span>
-176:                 <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>
-177:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pid</span>.<span class="ruby-identifier">nil?</span>
-178:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;Connection closed&quot;</span>
-179:                 <span class="ruby-keyword kw">end</span>
-180:                 <span class="ruby-identifier">owner_pipe</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">recv_io</span>
-181:                 <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>,
-182:                         <span class="ruby-identifier">socket_type</span>, <span class="ruby-identifier">owner_pipe</span>)
-183:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000051"></a><b>start</b>()
-  </div>
-  <div class="description">
-  <p>
-Overrided from <a
-href="../AbstractServer.html#M000126">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('M000051_source')" id="l_M000051_source">show source</a> ]</p>
-  <div id="M000051_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/application_spawner.rb, line 191</span>
-191:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start</span>
-192:                 <span class="ruby-keyword kw">super</span>
-193:                 <span class="ruby-keyword kw">begin</span>
-194:                         <span class="ruby-identifier">unmarshal_and_raise_errors</span>(<span class="ruby-identifier">server</span>)
-195:                 <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>
-196:                         <span class="ruby-identifier">stop</span>
-197:                         <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>
-198:                 <span class="ruby-keyword kw">rescue</span>
-199:                         <span class="ruby-identifier">stop</span>
-200:                         <span class="ruby-identifier">raise</span>
-201:                 <span class="ruby-keyword kw">end</span>
-202:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>