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/Railz/FrameworkSpawner/Error.html DELETED Viewed

@@ -1,98 +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::FrameworkSpawner::Error</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::FrameworkSpawner::Error</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../../files/lib/phusion_passenger/railz/framework_spawner_rb.html">lib/phusion_passenger/railz/framework_spawner.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-AbstractServer::ServerError
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-This exception means that the <a
-href="../FrameworkSpawner.html">FrameworkSpawner</a> server process exited
-unexpectedly.
-</p>
-</div>
-</div>
-  </div>
-    </body>
-</html>

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

@@ -1,154 +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::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::Railz::RequestHandler</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../files/lib/phusion_passenger/railz/request_handler_rb.html">lib/phusion_passenger/railz/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 Ruby on Rails applications.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000052">new</a></li>
-  <li><a href="#M000053">process_request</a></li>
-  </ul>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">NINJA_PATCHING_LOCK</td>
-    <td>=</td>
-    <td class="attr-value">Mutex.new</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000052"></a><b>new</b>(owner_pipe, options = {})
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000052_source')" id="l_M000052_source">show source</a> ]</p>
-  <div id="M000052_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/request_handler.rb, line 34</span>
-34:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span> = {})
-35:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span>)
-36:                 <span class="ruby-constant">NINJA_PATCHING_LOCK</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-37:                         <span class="ruby-identifier">ninja_patch_action_controller</span>
-38:                 <span class="ruby-keyword kw">end</span>
-39:         <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="M000053"></a><b>process_request</b>(headers, input, output)
-  </div>
-  <div class="description">
-  <p>
-Overrided method.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000053_source')" id="l_M000053_source">show source</a> ]</p>
-  <div id="M000053_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/railz/request_handler.rb, line 43</span>
-43:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_request</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>)
-44:                 <span class="ruby-identifier">cgi</span> = <span class="ruby-constant">CGIFixed</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>)
-45:                 <span class="ruby-operator">::</span><span class="ruby-constant">Dispatcher</span>.<span class="ruby-identifier">dispatch</span>(<span class="ruby-identifier">cgi</span>,
-46:                         <span class="ruby-operator">::</span><span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">CgiRequest</span><span class="ruby-operator">::</span><span class="ruby-constant">DEFAULT_SESSION_OPTIONS</span>,
-47:                         <span class="ruby-identifier">cgi</span>.<span class="ruby-identifier">stdoutput</span>)
-48:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

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

@@ -1,402 +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::SpawnManager</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::SpawnManager</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/spawn_manager_rb.html">lib/phusion_passenger/spawn_manager.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="AbstractServer.html">
-AbstractServer
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-The spawn manager is capable of spawning Ruby on Rails or <a
-href="Rack.html">Rack</a> application instances. It acts like a simple
-fascade for the rest of the spawn manager system.
-</p>
-<p>
-<b>Note</b>: <a href="SpawnManager.html">SpawnManager</a> may only be
-started synchronously with <a
-href="AbstractServer.html#M000127">AbstractServer#start_synchronously</a>.
-Starting asynchronously has not been tested. Don&#8216;t forget to call <a
-href="SpawnManager.html#M000115">cleanup</a> after the server&#8216;s main
-loop has finished.
-</p>
-<h2>Ruby on Rails optimizations</h2>
-<p>
-Spawning a Ruby on Rails application is usually slow. But <a
-href="SpawnManager.html">SpawnManager</a> will preload and cache Ruby on
-Rails frameworks, as well as application code, so subsequent spawns will be
-very fast.
-</p>
-<p>
-Internally, <a href="SpawnManager.html">SpawnManager</a> uses <a
-href="Railz/FrameworkSpawner.html">Railz::FrameworkSpawner</a> to preload
-and cache Ruby on Rails frameworks. <a
-href="Railz/FrameworkSpawner.html">Railz::FrameworkSpawner</a>, in turn,
-uses <a href="Railz/ApplicationSpawner.html">Railz::ApplicationSpawner</a>
-to preload and cache application code.
-</p>
-<p>
-In case you&#8216;re wondering why the namespace is &quot;<a
-href="Railz.html">Railz</a>&quot; and not &quot;Rails&quot;: it&#8216;s to
-work around an obscure bug in ActiveSupport&#8216;s Dispatcher.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000115">cleanup</a></li>
-  <li><a href="#M000112">new</a></li>
-  <li><a href="#M000114">reload</a></li>
-  <li><a href="#M000113">spawn_application</a></li>
-  </ul>
-<div class="sectiontitle">Included Modules</div>
-<ul>
-  <li><a href="Utils.html">Utils</a></li>
-</ul>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000112"></a><b>new</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000112_source')" id="l_M000112_source">show source</a> ]</p>
-  <div id="M000112_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 60</span>
-60:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
-61:                 <span class="ruby-keyword kw">super</span>()
-62:                 <span class="ruby-ivar">@spawners</span> = <span class="ruby-constant">AbstractServerCollection</span>.<span class="ruby-identifier">new</span>
-63:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
-64:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
-65:                 <span class="ruby-identifier">define_signal_handler</span>(<span class="ruby-value str">'SIGHUP'</span>, <span class="ruby-identifier">:reload</span>)
-66:
-67:                 <span class="ruby-comment cmt"># Start garbage collector in order to free up some existing</span>
-68:                 <span class="ruby-comment cmt"># heap slots. This prevents the heap from growing unnecessarily</span>
-69:                 <span class="ruby-comment cmt"># during the startup phase.</span>
-70:                 <span class="ruby-constant">GC</span>.<span class="ruby-identifier">start</span>
-71:                 <span class="ruby-keyword kw">if</span> <span class="ruby-constant">GC</span>.<span class="ruby-identifier">copy_on_write_friendly?</span>
-72:                         <span class="ruby-comment cmt"># Preload libraries for copy-on-write semantics.</span>
-73:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'base64'</span>
-74:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/application'</span>
-75:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/framework_spawner'</span>
-76:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/application_spawner'</span>
-77:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
-78:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/html_template'</span>
-79:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/platform_info'</span>
-80:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/exceptions'</span>
-81:
-82:                         <span class="ruby-comment cmt"># Commonly used libraries.</span>
-83:                         [<span class="ruby-value str">'mysql'</span>, <span class="ruby-value str">'sqlite3'</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">lib</span><span class="ruby-operator">|</span>
-84:                                 <span class="ruby-keyword kw">begin</span>
-85:                                         <span class="ruby-identifier">require</span> <span class="ruby-identifier">lib</span>
-86:                                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">LoadError</span>
-87:                                         <span class="ruby-comment cmt"># Do nothing; ignore if not present.</span>
-88:                                 <span class="ruby-keyword kw">end</span>
-89:                         <span class="ruby-keyword kw">end</span>
-90:                 <span class="ruby-keyword kw">end</span>
-91:         <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="M000115"></a><b>cleanup</b>()
-  </div>
-  <div class="description">
-  <p>
-Cleanup resources. Should be called when this <a
-href="SpawnManager.html">SpawnManager</a> is no longer needed.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000115_source')" id="l_M000115_source">show source</a> ]</p>
-  <div id="M000115_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 214</span>
-214:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
-215:                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">cleanup</span>
-216:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000114"></a><b>reload</b>(app_root = nil)
-  </div>
-  <div class="description">
-  <p>
-Remove the cached application instances at the given application root. If
-nil is specified as application root, then all cached application instances
-will be removed, no matter the application root.
-</p>
-<p>
-<b>Long description:</b> <a href="Application.html">Application</a> code
-might be cached in memory. But once it a while, it will be necessary to <a
-href="SpawnManager.html#M000114">reload</a> the code for an application,
-such as after deploying a <a href="SpawnManager.html#M000112">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 AbstractServer::SpawnError if something went wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000114_source')" id="l_M000114_source">show source</a> ]</p>
-  <div id="M000114_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 187</span>
-187:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span> = <span class="ruby-keyword kw">nil</span>)
-188:                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
-189:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
-190:                                 <span class="ruby-comment cmt"># Delete associated ApplicationSpawner.</span>
-191:                                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-node">&quot;app:#{app_root}&quot;</span>)
-192:                         <span class="ruby-keyword kw">else</span>
-193:                                 <span class="ruby-comment cmt"># Delete all ApplicationSpawners.</span>
-194:                                 <span class="ruby-identifier">keys_to_delete</span> = []
-195:                                 <span class="ruby-ivar">@spawners</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">spawner</span><span class="ruby-operator">|</span>
-196:                                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
-197:                                                 <span class="ruby-identifier">keys_to_delete</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">key</span>
-198:                                         <span class="ruby-keyword kw">end</span>
-199:                                 <span class="ruby-keyword kw">end</span>
-200:                                 <span class="ruby-identifier">keys_to_delete</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-operator">|</span>
-201:                                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
-202:                                 <span class="ruby-keyword kw">end</span>
-203:                         <span class="ruby-keyword kw">end</span>
-204:                         <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
-205:                                 <span class="ruby-comment cmt"># Reload all FrameworkSpawners.</span>
-206:                                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:reload</span>)
-207:                                         <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span>)
-208:                                 <span class="ruby-keyword kw">end</span>
-209:                         <span class="ruby-keyword kw">end</span>
-210:                 <span class="ruby-keyword kw">end</span>
-211:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000113"></a><b>spawn_application</b>(options)
-  </div>
-  <div class="description">
-  <p>
-Spawn an application with the given spawn options. When successful, an <a
-href="Application.html">Application</a> object will be returned, which
-represents the spawned application. At least one option must be given:
-<tt>app_root</tt>. This is the application&#8216;s root folder.
-</p>
-<p>
-Other options are:
-</p>
-<dl>
-<dt>&#8216;lower_privilege&#8217;, &#8216;lowest_user&#8217; and &#8216;environment&#8216;</dt><dd>See Railz::ApplicationSpawner.new for an explanation of these options.
-</dd>
-<dt>&#8216;app_type&#8216;</dt><dd>What kind of application is being spawned. Either &quot;rails&quot;
-(default), &quot;rack&quot; or &quot;wsgi&quot;.
-</dd>
-<dt>&#8216;spawn_method&#8216;</dt><dd>May be one of &quot;smart&quot;, &quot;smart-lv2&quot; or
-&quot;conservative&quot;. When &quot;smart&quot; is specified, <a
-href="SpawnManager.html">SpawnManager</a> will internally cache the code of
-Rails 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:
-<ul>
-<li>Restart this <a href="SpawnManager.html">SpawnManager</a> by calling <a
-href="AbstractServer.html#M000128">AbstractServer#stop</a>, then <a
-href="AbstractServer.html#M000126">AbstractServer#start</a>.
-</li>
-<li>Reload the application by calling <a
-href="SpawnManager.html#M000114">reload</a> with the correct app_root
-argument.
-</li>
-</ul>
-<p>
-&quot;smart&quot; caches the Rails framework code in a framework spawner
-server, and application code in an application spawner server. Sometimes it
-is desirable to skip the framework spawning and going directly for the
-application spawner instead. The &quot;smart-lv2&quot; method allows you to
-do that.
-</p>
-<p>
-Caching however can be incompatible with some applications. The
-&quot;conservative&quot; spawning method does not involve any caching at
-all. Spawning will be slower, but is guaranteed to be compatible with all
-applications.
-</p>
-<p>
-The default spawn method is &quot;smart-lv2&quot;.
-</p>
-</dd>
-<dt>&#8216;framework_spawner_timeout&#8217; and &#8216;app_spawner_timeout&#8216;</dt><dd>These options allow you to specify the maximum idle timeout, in seconds, of
-the framework spawner servers and application spawner servers that will be
-started under the hood. These options are only used if <tt>app_type</tt>
-equals &quot;rails&quot;.
-<p>
-A timeout of 0 means that the spawner server should never idle timeout. A
-timeout of -1 means that the default timeout value should be used. The
-default value is -1.
-</p>
-</dd>
-</dl>
-<p>
-<b>Exceptions:</b>
-</p>
-<ul>
-<li><a href="InvalidPath.html">InvalidPath</a>: <tt>app_root</tt> doesn&#8216;t
-appear to be a valid Ruby on Rails application root.
-</li>
-<li><a href="VersionNotFound.html">VersionNotFound</a>: The Ruby on Rails
-framework version that the given application requires is not installed.
-</li>
-<li><a href="AbstractServer/ServerError.html">AbstractServer::ServerError</a>:
-One of the server processes exited unexpectedly.
-</li>
-<li><a href="FrameworkInitError.html">FrameworkInitError</a>: The Ruby on Rails
-framework that the application requires could not be loaded.
-</li>
-<li><a href="AppInitError.html">AppInitError</a>: The application raised an
-exception or called exit() during startup.
-</li>
-</ul>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000113_source')" id="l_M000113_source">show source</a> ]</p>
-  <div id="M000113_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 141</span>
-141:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">options</span>)
-142:                 <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_root&quot;</span>]
-143:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;The 'app_root' option must be given.&quot;</span>
-144:                 <span class="ruby-keyword kw">end</span>
-145:                 <span class="ruby-identifier">options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
-146:
-147:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_type&quot;</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;rails&quot;</span>
-148:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">FrameworkSpawner</span>)
-149:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/application'</span>
-150:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/framework_spawner'</span>
-151:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/application_spawner'</span>
-152:                         <span class="ruby-keyword kw">end</span>
-153:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rails_application</span>(<span class="ruby-identifier">options</span>)
-154:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_type&quot;</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;rack&quot;</span>
-155:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
-156:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
-157:                         <span class="ruby-keyword kw">end</span>
-158:                         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(
-159:                                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_root&quot;</span>], <span class="ruby-identifier">options</span>
-160:                         )
-161:                 <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_type&quot;</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;wsgi&quot;</span>
-162:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/wsgi/application_spawner'</span>
-163:                         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">WSGI</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(
-164:                                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_root&quot;</span>],
-165:                                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;lower_privilege&quot;</span>],
-166:                                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;lowest_user&quot;</span>],
-167:                                 <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;environment&quot;</span>]
-168:                         )
-169:                 <span class="ruby-keyword kw">else</span>
-170:                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;Unknown 'app_type' value '#{options[&quot;app_type&quot;]}'.&quot;</span>
-171:                 <span class="ruby-keyword kw">end</span>
-172:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>