RubyGems - passenger - Versions diffs - 3.0.0.pre1 → 3.0.0.pre2 - Mend

passenger 3.0.0.pre1 → 3.0.0.pre2

Potentially problematic release.

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

Files changed (189) hide show

data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html ADDED

@@ -0,0 +1,200 @@
+<?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::ClassicRails::CGIFixed</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::ClassicRails::CGIFixed</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html">lib/phusion_passenger/classic_rails/cgi_fixed.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+::CGI
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="description"><p>
+Modifies CGI so that we can use it. Main thing it does is expose the <a
+href="CGIFixed.html#M000195">stdinput</a> and <a
+href="CGIFixed.html#M000196">stdoutput</a> so <a
+href="RequestHandler.html">RequestHandler</a> can connect them to the right
+sources. It also exposes the <a href="CGIFixed.html#M000194">env_table</a>
+so that <a href="RequestHandler.html">RequestHandler</a> can hook the
+request parameters into the environment table.
+</p>
+<p>
+This is partially based on the FastCGI code, but much of the Ruby 1.6
+backwards compatibility is removed.
+</p>
+</div>
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000193">args</a></li>
+  <li><a href="#M000194">env_table</a></li>
+  <li><a href="#M000192">new</a></li>
+  <li><a href="#M000195">stdinput</a></li>
+  <li><a href="#M000196">stdoutput</a></li>
+  </ul>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000192"></a><b>new</b>(params, input, output, *args)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000192_source')" id="l_M000192_source">show source</a> ]</p>
+  <div id="M000192_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/cgi_fixed.rb, line 42</span>
+42:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">params</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+43:                 <span class="ruby-ivar">@env_table</span> = <span class="ruby-identifier">params</span>
+44:                 <span class="ruby-ivar">@args</span> = <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>
+45:                 <span class="ruby-ivar">@input</span> = <span class="ruby-identifier">input</span>
+46:                 <span class="ruby-ivar">@out</span> = <span class="ruby-identifier">output</span>
+47:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+48:         <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="M000193"></a><b>args</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000193_source')" id="l_M000193_source">show source</a> ]</p>
+  <div id="M000193_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/cgi_fixed.rb, line 50</span>
+50:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">args</span>
+51:                 <span class="ruby-ivar">@args</span>
+52:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000194"></a><b>env_table</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000194_source')" id="l_M000194_source">show source</a> ]</p>
+  <div id="M000194_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/cgi_fixed.rb, line 54</span>
+54:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">env_table</span>
+55:                 <span class="ruby-ivar">@env_table</span>
+56:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000195"></a><b>stdinput</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000195_source')" id="l_M000195_source">show source</a> ]</p>
+  <div id="M000195_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/cgi_fixed.rb, line 58</span>
+58:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stdinput</span>
+59:                 <span class="ruby-ivar">@input</span>
+60:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000196"></a><b>stdoutput</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000196_source')" id="l_M000196_source">show source</a> ]</p>
+  <div id="M000196_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/cgi_fixed.rb, line 62</span>
+62:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stdoutput</span>
+63:                 <span class="ruby-ivar">@out</span>
+64:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html ADDED

@@ -0,0 +1,410 @@
+<?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::ClassicRails::FrameworkSpawner</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::ClassicRails::FrameworkSpawner</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html">lib/phusion_passenger/classic_rails/framework_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 Ruby on Rails application instances
+quickly. This is done by preloading the Ruby on Rails framework into
+memory, before spawning the application instances.
+</p>
+<p>
+A single <a href="FrameworkSpawner.html">FrameworkSpawner</a> instance can
+only hold a single Ruby on Rails framework version. So be careful when
+using <a href="FrameworkSpawner.html">FrameworkSpawner</a>: the
+applications that you spawn through it must require the same RoR version.
+To handle multiple RoR versions, use multiple <a
+href="FrameworkSpawner.html">FrameworkSpawner</a> instances.
+</p>
+<p>
+<a href="FrameworkSpawner.html">FrameworkSpawner</a> uses <a
+href="ApplicationSpawner.html">ApplicationSpawner</a> internally.
+</p>
+<p>
+<b>Note</b>: <a href="FrameworkSpawner.html">FrameworkSpawner</a> may only
+be started asynchronously with <a
+href="../AbstractServer.html#M000330">AbstractServer#start</a>. Starting it
+synchronously with <a
+href="../AbstractServer.html#M000331">AbstractServer#start_synchronously</a>
+has not been tested.
+</p>
+</div>
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000188">new</a></li>
+  <li><a href="#M000191">reload</a></li>
+  <li><a href="#M000190">spawn_application</a></li>
+  <li><a href="#M000189">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="FrameworkSpawner/Error.html" class="link">PhusionPassenger::ClassicRails::FrameworkSpawner::Error</a><br />
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000188"></a><b>new</b>(options = {})
+  </div>
+  <div class="description">
+  <p>
+Creates a <a href="FrameworkSpawner.html#M000188">new</a> instance of <a
+href="FrameworkSpawner.html">FrameworkSpawner</a>.
+</p>
+<p>
+Extra supported options:
+</p>
+<ul>
+<li><tt>framework_version</tt>: The Ruby on Rails version to use. It is not
+checked whether this version is actually installed.
+</li>
+</ul>
+<p>
+All other options will be passed on to <a
+href="ApplicationSpawner.html">ApplicationSpawner</a> and <a
+href="RequestHandler.html">RequestHandler</a>.
+</p>
+<p>
+Note that the specified Rails framework will be loaded during the entire
+life time of the <a href="FrameworkSpawner.html">FrameworkSpawner</a>
+server. If you wish to <a href="FrameworkSpawner.html#M000191">reload</a>
+the Rails framework&#8216;s code, then restart the server by calling <a
+href="../AbstractServer.html#M000332">AbstractServer#stop</a> and <a
+href="../AbstractServer.html#M000330">AbstractServer#start</a>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000188_source')" id="l_M000188_source">show source</a> ]</p>
+  <div id="M000188_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/framework_spawner.rb, line 66</span>
+66:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">options</span> = {})
+67:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">options</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value str">'[]'</span><span class="ruby-value str">'[]'</span>)
+68:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;The 'options' argument does not seem to be an options hash&quot;</span>
+69:                 <span class="ruby-keyword kw">end</span>
+70:                 <span class="ruby-ivar">@framework_version</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;framework_version&quot;</span>]
+71:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-value str">&quot;print_framework_loading_exceptions&quot;</span>)
+72:                         <span class="ruby-ivar">@print_framework_loading_exceptions</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;print_framework_loading_exceptions&quot;</span>]
+73:                 <span class="ruby-keyword kw">else</span>
+74:                         <span class="ruby-ivar">@print_framework_loading_exceptions</span> = <span class="ruby-keyword kw">true</span>
+75:                 <span class="ruby-keyword kw">end</span>
+76:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@framework_version</span>
+77:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;The 'framework_version' option must specified&quot;</span>
+78:                 <span class="ruby-keyword kw">end</span>
+79:
+80:                 <span class="ruby-keyword kw">super</span>()
+81:                 <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
+82:                 <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">max_idle_time</span> = <span class="ruby-constant">DEFAULT_FRAMEWORK_SPAWNER_MAX_IDLE_TIME</span>
+83:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
+84:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
+85:         <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="M000191"></a><b>reload</b>(app_group_name = nil)
+  </div>
+  <div class="description">
+  <p>
+Remove the cached application instances at the given group name. If nil is
+specified as group name, then all cached application instances will be
+removed, no matter the group name.
+</p>
+<p>
+<b>Long description:</b> Application code might be cached in memory by a <a
+href="FrameworkSpawner.html">FrameworkSpawner</a>. But once it a while, it
+will be necessary to <a href="FrameworkSpawner.html#M000191">reload</a> the
+code for an application, such as after deploying a <a
+href="FrameworkSpawner.html#M000188">new</a> version of the application.
+This method makes sure that any cached application code is removed, so that
+the next time an application instance is spawned, the application code will
+be freshly loaded into memory.
+</p>
+<p>
+Raises:
+</p>
+<ul>
+<li><a href="FrameworkSpawner/Error.html">FrameworkSpawner::Error</a>: The <a
+href="FrameworkSpawner.html">FrameworkSpawner</a> server exited
+unexpectedly.
+</li>
+</ul>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000191_source')" id="l_M000191_source">show source</a> ]</p>
+  <div id="M000191_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/framework_spawner.rb, line 188</span>
+188:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_group_name</span> = <span class="ruby-keyword kw">nil</span>)
+189:                 <span class="ruby-identifier">connect</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">channel</span><span class="ruby-operator">|</span>
+190:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_group_name</span>.<span class="ruby-identifier">nil?</span>
+191:                                 <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;reload&quot;</span>)
+192:                         <span class="ruby-keyword kw">else</span>
+193:                                 <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;reload&quot;</span>, <span class="ruby-identifier">app_group_name</span>)
+194:                         <span class="ruby-keyword kw">end</span>
+195:                 <span class="ruby-keyword kw">end</span>
+196:         <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>
+197:                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-node">&quot;The framework spawner server exited unexpectedly: #{e}&quot;</span>
+198:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000190"></a><b>spawn_application</b>(options = {})
+  </div>
+  <div class="description">
+  <p>
+Spawn a RoR application using the Ruby on Rails framework version
+associated with this <a href="FrameworkSpawner.html">FrameworkSpawner</a>.
+When successful, an Application object will be returned, which represents
+the spawned RoR application.
+</p>
+<p>
+All options accepted by <a
+href="ApplicationSpawner.html#M000198">ApplicationSpawner.new</a> and <a
+href="RequestHandler.html#M000201">RequestHandler.new</a> are accepted.
+</p>
+<p>
+<a href="FrameworkSpawner.html">FrameworkSpawner</a> will internally cache
+the code of applications, in order to speed up future spawning attempts.
+This implies that, if you&#8216;ve changed the application&#8216;s code,
+you must do one of these things:
+</p>
+<ul>
+<li>Restart this <a href="FrameworkSpawner.html">FrameworkSpawner</a> by
+calling <a href="../AbstractServer.html#M000332">AbstractServer#stop</a>,
+then <a href="../AbstractServer.html#M000330">AbstractServer#start</a>.
+</li>
+<li>Reload the application by calling <a
+href="FrameworkSpawner.html#M000191">reload</a> with the correct app_root
+argument.
+</li>
+</ul>
+<p>
+Raises:
+</p>
+<ul>
+<li><a
+href="../AbstractServer/ServerNotStarted.html">AbstractServer::ServerNotStarted</a>:
+The <a href="FrameworkSpawner.html">FrameworkSpawner</a> server
+hasn&#8216;t already been started.
+</li>
+<li><a href="../AppInitError.html">AppInitError</a>: The 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>
+<li><a href="FrameworkSpawner/Error.html">FrameworkSpawner::Error</a>: The <a
+href="FrameworkSpawner.html">FrameworkSpawner</a> server exited
+unexpectedly.
+</li>
+</ul>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000190_source')" id="l_M000190_source">show source</a> ]</p>
+  <div id="M000190_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/framework_spawner.rb, line 140</span>
+140:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">options</span> = {})
+141:                 <span class="ruby-identifier">app_root</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_root&quot;</span>]
+142:                 <span class="ruby-identifier">options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
+143:                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_root&quot;</span>] = <span class="ruby-identifier">app_root</span>
+144:                 <span class="ruby-comment cmt"># No need for the ApplicationSpawner to print exceptions. All</span>
+145:                 <span class="ruby-comment cmt"># exceptions raised by the ApplicationSpawner are sent back here,</span>
+146:                 <span class="ruby-comment cmt"># so we just need to decide here whether we want to print it.</span>
+147:                 <span class="ruby-identifier">print_exceptions</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;print_exceptions&quot;</span>]
+148:                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;print_exceptions&quot;</span>] = <span class="ruby-keyword kw">false</span>
+149:
+150:                 <span class="ruby-keyword kw">begin</span>
+151:                         <span class="ruby-identifier">connect</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">channel</span><span class="ruby-operator">|</span>
+152:                                 <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;spawn_application&quot;</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">options</span>.<span class="ruby-identifier">to_a</span>.<span class="ruby-identifier">flatten</span>)
+153:                                 <span class="ruby-identifier">result</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read</span>
+154:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">nil?</span>
+155:                                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;Connection closed&quot;</span>
+156:                                 <span class="ruby-keyword kw">end</span>
+157:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">'exception'</span>
+158:                                         <span class="ruby-identifier">e</span> = <span class="ruby-identifier">unmarshal_exception</span>(<span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read_scalar</span>)
+159:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">print_exceptions</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:child_exception</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">child_exception</span>
+160:                                                 <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>.<span class="ruby-identifier">child_exception</span>)
+161:                                         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">print_exceptions</span>
+162:                                                 <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>)
+163:                                         <span class="ruby-keyword kw">end</span>
+164:                                         <span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>
+165:                                 <span class="ruby-keyword kw">else</span>
+166:                                         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">AppProcess</span>.<span class="ruby-identifier">read_from_channel</span>(<span class="ruby-identifier">channel</span>)
+167:                                 <span class="ruby-keyword kw">end</span>
+168:                         <span class="ruby-keyword kw">end</span>
+169:                 <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>
+170:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-node">&quot;The framework spawner server exited unexpectedly: #{e}&quot;</span>
+171:                 <span class="ruby-keyword kw">end</span>
+172:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000189"></a><b>start</b>()
+  </div>
+  <div class="description">
+  <p>
+Overrided from <a
+href="../AbstractServer.html#M000330">AbstractServer#start</a>.
+</p>
+<p>
+May raise these additional exceptions:
+</p>
+<ul>
+<li><a href="../FrameworkInitError.html">FrameworkInitError</a>: An error
+occurred while loading the specified Ruby on Rails framework.
+</li>
+<li><a href="FrameworkSpawner/Error.html">FrameworkSpawner::Error</a>: The <a
+href="FrameworkSpawner.html">FrameworkSpawner</a> server exited
+unexpectedly.
+</li>
+</ul>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000189_source')" id="l_M000189_source">show source</a> ]</p>
+  <div id="M000189_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/classic_rails/framework_spawner.rb, line 92</span>
+ 92:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start</span>
+ 93:                 <span class="ruby-keyword kw">super</span>
+ 94:                 <span class="ruby-keyword kw">begin</span>
+ 95:                         <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@owner_socket</span>)
+ 96:                         <span class="ruby-identifier">result</span> = <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">read</span>
+ 97:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">nil?</span>
+ 98:                                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-value str">&quot;The framework spawner server exited unexpectedly.&quot;</span>
+ 99:                         <span class="ruby-keyword kw">else</span>
+100:                                 <span class="ruby-identifier">status</span> = <span class="ruby-identifier">result</span>[<span class="ruby-value">0</span>]
+101:                         <span class="ruby-keyword kw">end</span>
+102:                         <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>
+103:                                 <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>)
+104:                                 <span class="ruby-identifier">stop</span>
+105:                                 <span class="ruby-identifier">message</span> = <span class="ruby-node">&quot;Could not load Ruby on Rails framework version #{@framework_version}: &quot;</span> <span class="ruby-operator">&lt;&lt;</span>
+106:                                         <span class="ruby-node">&quot;#{child_exception.class} (#{child_exception.message})&quot;</span>
+107:                                 <span class="ruby-identifier">options</span> = { <span class="ruby-identifier">:version</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@framework_version</span> }
+108:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@print_framework_loading_exceptions</span>
+109:                                         <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">child_exception</span>)
+110:                                 <span class="ruby-keyword kw">end</span>
+111:                                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">FrameworkInitError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">child_exception</span>, <span class="ruby-identifier">options</span>)
+112:                         <span class="ruby-keyword kw">end</span>
+113:                 <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>
+114:                         <span class="ruby-identifier">stop</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">started?</span>
+115:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">Error</span>, <span class="ruby-node">&quot;The framework spawner server exited unexpectedly: #{e}&quot;</span>
+116:                 <span class="ruby-keyword kw">rescue</span>
+117:                         <span class="ruby-identifier">stop</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">started?</span>
+118:                         <span class="ruby-identifier">raise</span>
+119:                 <span class="ruby-keyword kw">end</span>
+120:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>