RubyGems - passenger - Versions diffs - 3.0.4 → 3.0.5 - Mend

passenger 3.0.4 → 3.0.5

Potentially problematic release.

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

Files changed (571) hide show

data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html ADDED

@@ -0,0 +1,139 @@
+<?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::Rails3Extensions::AnalyticsLogging::ACExtension</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::Rails3Extensions::AnalyticsLogging::ACExtension</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../../files/lib/phusion_passenger/rails3_extensions/init_rb.html">lib/phusion_passenger/rails3_extensions/init.rb</a>
+        </td>
+      </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000178">process_action</a></li>
+  <li><a href="#M000179">render</a></li>
+  </ul>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000178"></a><b>process_action</b>(action, *args)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000178_source')" id="l_M000178_source">show source</a> ]</p>
+  <div id="M000178_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/rails3_extensions/init.rb, line 164</span>
+164:                 <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_action</span>(<span class="ruby-identifier">action</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+165:                         <span class="ruby-identifier">log</span> = <span class="ruby-identifier">request</span>.<span class="ruby-identifier">env</span>[<span class="ruby-constant">PASSENGER_ANALYTICS_WEB_LOG</span>]
+166:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">log</span>
+167:                                 <span class="ruby-identifier">log</span>.<span class="ruby-identifier">message</span>(<span class="ruby-node">&quot;Controller action: #{self.class.name}##{action_name}&quot;</span>)
+168:                                 <span class="ruby-identifier">log</span>.<span class="ruby-identifier">measure</span>(<span class="ruby-value str">&quot;framework request processing&quot;</span>) <span class="ruby-keyword kw">do</span>
+169:                                         <span class="ruby-keyword kw">super</span>
+170:                                 <span class="ruby-keyword kw">end</span>
+171:                         <span class="ruby-keyword kw">else</span>
+172:                                 <span class="ruby-keyword kw">super</span>
+173:                         <span class="ruby-keyword kw">end</span>
+174:                 <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000179"></a><b>render</b>(*args)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000179_source')" id="l_M000179_source">show source</a> ]</p>
+  <div id="M000179_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/rails3_extensions/init.rb, line 176</span>
+176:                 <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+177:                         <span class="ruby-identifier">log</span> = <span class="ruby-identifier">request</span>.<span class="ruby-identifier">env</span>[<span class="ruby-constant">PASSENGER_ANALYTICS_WEB_LOG</span>]
+178:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">log</span>
+179:                                 <span class="ruby-identifier">log</span>.<span class="ruby-identifier">measure</span>(<span class="ruby-value str">&quot;view rendering&quot;</span>) <span class="ruby-keyword kw">do</span>
+180:                                         <span class="ruby-keyword kw">super</span>
+181:                                 <span class="ruby-keyword kw">end</span>
+182:                         <span class="ruby-keyword kw">else</span>
+183:                                 <span class="ruby-keyword kw">super</span>
+184:                         <span class="ruby-keyword kw">end</span>
+185:                 <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html ADDED

@@ -0,0 +1,118 @@
+<?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::Rails3Extensions::AnalyticsLogging::ASBenchmarkableExtension</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::Rails3Extensions::AnalyticsLogging::ASBenchmarkableExtension</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../../files/lib/phusion_passenger/rails3_extensions/init_rb.html">lib/phusion_passenger/rails3_extensions/init.rb</a>
+        </td>
+      </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000180">benchmark_with_passenger</a></li>
+  </ul>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000180"></a><b>benchmark_with_passenger</b>(message = &quot;Benchmarking&quot;, *args) {|| ...}
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000180_source')" id="l_M000180_source">show source</a> ]</p>
+  <div id="M000180_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/rails3_extensions/init.rb, line 189</span>
+189:                 <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">benchmark_with_passenger</span>(<span class="ruby-identifier">message</span> = <span class="ruby-value str">&quot;Benchmarking&quot;</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+190:                         <span class="ruby-identifier">log</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">current</span>[<span class="ruby-constant">PASSENGER_ANALYTICS_WEB_LOG</span>]
+191:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">log</span>
+192:                                 <span class="ruby-identifier">log</span>.<span class="ruby-identifier">measure</span>(<span class="ruby-node">&quot;BENCHMARK: #{message}&quot;</span>) <span class="ruby-keyword kw">do</span>
+193:                                         <span class="ruby-identifier">benchmark_without_passenger</span>(<span class="ruby-identifier">message</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-keyword kw">do</span>
+194:                                                 <span class="ruby-keyword kw">yield</span>
+195:                                         <span class="ruby-keyword kw">end</span>
+196:                                 <span class="ruby-keyword kw">end</span>
+197:                         <span class="ruby-keyword kw">else</span>
+198:                                 <span class="ruby-identifier">benchmark_without_passenger</span>(<span class="ruby-identifier">message</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-keyword kw">do</span>
+199:                                         <span class="ruby-keyword kw">yield</span>
+200:                                 <span class="ruby-keyword kw">end</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>

data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html ADDED

@@ -0,0 +1,135 @@
+<?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::Rails3Extensions::AnalyticsLogging::ExceptionLogger</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::Rails3Extensions::AnalyticsLogging::ExceptionLogger</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../../../files/lib/phusion_passenger/rails3_extensions/init_rb.html">lib/phusion_passenger/rails3_extensions/init.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+Object
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000182">call</a></li>
+  <li><a href="#M000181">new</a></li>
+  </ul>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000181"></a><b>new</b>(app, analytics_logger)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000181_source')" id="l_M000181_source">show source</a> ]</p>
+  <div id="M000181_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/rails3_extensions/init.rb, line 116</span>
+116:                 <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">app</span>, <span class="ruby-identifier">analytics_logger</span>)
+117:                         <span class="ruby-ivar">@app</span> = <span class="ruby-identifier">app</span>
+118:                         <span class="ruby-ivar">@analytics_logger</span> = <span class="ruby-identifier">analytics_logger</span>
+119:                 <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="M000182"></a><b>call</b>(env)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000182_source')" id="l_M000182_source">show source</a> ]</p>
+  <div id="M000182_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/rails3_extensions/init.rb, line 121</span>
+121:                 <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">call</span>(<span class="ruby-identifier">env</span>)
+122:                         <span class="ruby-ivar">@app</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">env</span>)
+123:                 <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+124:                         <span class="ruby-identifier">log_analytics_exception</span>(<span class="ruby-identifier">env</span>, <span class="ruby-identifier">e</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">PASSENGER_TXN_ID</span>]
+125:                         <span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>
+126:                 <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html ADDED

@@ -0,0 +1,378 @@
+<?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#M000335">AbstractServer#start_synchronously</a>.
+Starting asynchronously has not been tested. Don&#8216;t forget to call <a
+href="SpawnManager.html#M000374">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="ClassicRails/FrameworkSpawner.html">ClassicRails::FrameworkSpawner</a>
+to preload and cache Ruby on Rails frameworks. <a
+href="ClassicRails/FrameworkSpawner.html">ClassicRails::FrameworkSpawner</a>,
+in turn, uses <a
+href="ClassicRails/ApplicationSpawner.html">ClassicRails::ApplicationSpawner</a>
+to preload and cache application code.
+</p>
+<p>
+In case you&#8216;re wondering why the namespace is &quot;<a
+href="ClassicRails.html">ClassicRails</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="#M000374">cleanup</a></li>
+  <li><a href="#M000371">new</a></li>
+  <li><a href="#M000373">reload</a></li>
+  <li><a href="#M000372">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="M000371"></a><b>new</b>(options = {})
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000371_source')" id="l_M000371_source">show source</a> ]</p>
+  <div id="M000371_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 62</span>
+62:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">options</span> = {})
+63:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-value str">&quot;&quot;</span>, <span class="ruby-value str">&quot;&quot;</span>)
+64:                 <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
+65:                 <span class="ruby-ivar">@spawners</span> = <span class="ruby-constant">AbstractServerCollection</span>.<span class="ruby-identifier">new</span>
+66:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
+67:                 <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
+68:                 <span class="ruby-identifier">define_signal_handler</span>(<span class="ruby-value str">'SIGHUP'</span>, <span class="ruby-identifier">:reload</span>)
+69:
+70:                 <span class="ruby-comment cmt"># Start garbage collector in order to free up some existing</span>
+71:                 <span class="ruby-comment cmt"># heap slots. This prevents the heap from growing unnecessarily</span>
+72:                 <span class="ruby-comment cmt"># during the startup phase.</span>
+73:                 <span class="ruby-constant">GC</span>.<span class="ruby-identifier">start</span>
+74:                 <span class="ruby-keyword kw">if</span> <span class="ruby-constant">GC</span>.<span class="ruby-identifier">copy_on_write_friendly?</span>
+75:                         <span class="ruby-comment cmt"># Preload libraries for copy-on-write semantics.</span>
+76:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'base64'</span>
+77:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/app_process'</span>
+78:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/classic_rails/framework_spawner'</span>
+79:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/classic_rails/application_spawner'</span>
+80:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
+81:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/html_template'</span>
+82:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/platform_info'</span>
+83:                         <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/exceptions'</span>
+84:                 <span class="ruby-keyword kw">end</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="M000374"></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('M000374_source')" id="l_M000374_source">show source</a> ]</p>
+  <div id="M000374_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 180</span>
+180:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
+181:                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">cleanup</span>
+182:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000373"></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. But
+once it a while, it will be necessary to <a
+href="SpawnManager.html#M000373">reload</a> the code for an application,
+such as after deploying a <a href="SpawnManager.html#M000371">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('M000373_source')" id="l_M000373_source">show source</a> ]</p>
+  <div id="M000373_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 161</span>
+161:         <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>)
+162:                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
+163:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_group_name</span>
+164:                                 <span class="ruby-comment cmt"># Stop and delete associated ApplicationSpawner.</span>
+165:                                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-node">&quot;app:#{app_group_name}&quot;</span>)
+166:                                 <span class="ruby-comment cmt"># Propagate reload command to associated FrameworkSpawner.</span>
+167:                                 <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>
+168:                                         <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>)
+169:                                                 <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_group_name</span>)
+170:                                         <span class="ruby-keyword kw">end</span>
+171:                                 <span class="ruby-keyword kw">end</span>
+172:                         <span class="ruby-keyword kw">else</span>
+173:                                 <span class="ruby-comment cmt"># Stop and delete all spawners.</span>
+174:                                 <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">clear</span>
+175:                         <span class="ruby-keyword kw">end</span>
+176:                 <span class="ruby-keyword kw">end</span>
+177:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000372"></a><b>spawn_application</b>(options)
+  </div>
+  <div class="description">
+  <p>
+Spawns an application with the given spawn options. When successful, an <a
+href="AppProcess.html">AppProcess</a> object will be returned, which
+represents the spawned application process.
+</p>
+<p>
+Most options are explained in PoolOptions.h.
+</p>
+<p>
+Mandatory options:
+</p>
+<ul>
+<li>&#8216;app_root&#8216;
+</li>
+</ul>
+<p>
+Optional options:
+</p>
+<ul>
+<li>&#8216;app_type&#8216;
+</li>
+<li>&#8216;environment&#8216;
+</li>
+<li>&#8216;spawn_method&#8216;
+</li>
+<li>&#8216;user&#8217;,
+</li>
+<li>&#8216;group&#8216;
+</li>
+<li>&#8216;default_user&#8216;
+</li>
+<li>&#8216;default_group&#8216;
+</li>
+<li>&#8216;framework_spawner_timeout&#8216;
+</li>
+<li>&#8216;app_spawner_timeout&#8216;
+</li>
+<li>&#8216;environment_variables&#8217;: Environment variables which should be
+passed to the spawned application process. This is NULL-seperated string of
+key-value pairs, encoded in base64. The last byte in the unencoded data
+must be a NULL.
+</li>
+<li>&#8216;base_uri&#8216;
+</li>
+<li>&#8216;print_exceptions&#8216;
+</li>
+</ul>
+<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('M000372_source')" id="l_M000372_source">show source</a> ]</p>
+  <div id="M000372_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 120</span>
+120:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">options</span>)
+121:                 <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>]
+122:                         <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>
+123:                 <span class="ruby-keyword kw">end</span>
+124:                 <span class="ruby-identifier">options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
+125:
+126:                 <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;app_type&quot;</span>]
+127:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;rails&quot;</span>
+128:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">ClassicRails</span><span class="ruby-operator">::</span><span class="ruby-constant">FrameworkSpawner</span>)
+129:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/classic_rails/framework_spawner'</span>
+130:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/classic_rails/application_spawner'</span>
+131:                         <span class="ruby-keyword kw">end</span>
+132:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rails_application</span>(<span class="ruby-identifier">options</span>)
+133:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;rack&quot;</span>
+134:                         <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>)
+135:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
+136:                         <span class="ruby-keyword kw">end</span>
+137:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rack_application</span>(<span class="ruby-identifier">options</span>)
+138:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;wsgi&quot;</span>
+139:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">WSGI</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
+140:                                 <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/wsgi/application_spawner'</span>
+141:                         <span class="ruby-keyword kw">end</span>
+142:                         <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>(<span class="ruby-identifier">options</span>)
+143:                 <span class="ruby-keyword kw">else</span>
+144:                         <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>
+145:                 <span class="ruby-keyword kw">end</span>
+146:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>