RubyGems - passenger - Versions diffs - 3.0.2 → 3.0.3 - Mend

passenger 3.0.2 → 3.0.3

Potentially problematic release.

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

Files changed (220) hide show

@@ -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: Signal</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 />Signal</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/phusion_passenger/utils_rb.html">lib/phusion_passenger/utils.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="#M000011">list_trappable</a></li>
+  </ul>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000011"></a><b>list_trappable</b>()
+  </div>
+  <div class="description">
+  <p>
+Like Signal.list, but only returns signals that we can actually trap.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000011_source')" id="l_M000011_source">show source</a> ]</p>
+  <div id="M000011_source" class="dyn-source">
+<pre>
+      <span class="ruby-comment cmt"># File lib/phusion_passenger/utils.rb, line 1013</span>
+1013:         <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">list_trappable</span>
+1014:                 <span class="ruby-identifier">ruby_engine</span> = <span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">RUBY_ENGINE</span>) <span class="ruby-operator">?</span> <span class="ruby-constant">RUBY_ENGINE</span> <span class="ruby-operator">:</span> <span class="ruby-value str">&quot;ruby&quot;</span>
+1015:                 <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">ruby_engine</span>
+1016:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;ruby&quot;</span>
+1017:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1018:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;ALRM&quot;</span>)
+1019:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;VTALRM&quot;</span>)
+1020:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;jruby&quot;</span>
+1021:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1022:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;QUIT&quot;</span>)
+1023:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;ILL&quot;</span>)
+1024:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;FPE&quot;</span>)
+1025:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;KILL&quot;</span>)
+1026:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;SEGV&quot;</span>)
+1027:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;USR1&quot;</span>)
+1028:                 <span class="ruby-keyword kw">else</span>
+1029:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1030:                 <span class="ruby-keyword kw">end</span>
+1031:
+1032:                 <span class="ruby-comment cmt"># Don't touch SIGCHLD no matter what! On OS X waitpid() will</span>
+1033:                 <span class="ruby-comment cmt"># malfunction if SIGCHLD doesn't have a correct handler.</span>
+1034:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;CLD&quot;</span>)
+1035:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;CHLD&quot;</span>)
+1036:
+1037:                 <span class="ruby-comment cmt"># Other stuff that we don't want to trap no matter which</span>
+1038:                 <span class="ruby-comment cmt"># Ruby engine.</span>
+1039:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;STOP&quot;</span>)
+1040:
+1041:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">result</span>
+1042:         <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/rdoc/created.rid ADDED

	@@ -0,0 +1 @@
1	+ Thu, 24 Feb 2011 15:26:35 +0100

data/doc/rdoc/files/DEVELOPERS_TXT.html ADDED

@@ -0,0 +1,280 @@
+<?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>File: DEVELOPERS.TXT</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 border='0' cellpadding='0' cellspacing='0' width="100%" class='banner'>
+  <tr><td>
+    <table width="100%" border='0' cellpadding='0' cellspacing='0'><tr>
+      <td class="file-title" colspan="2"><span class="file-title-prefix">File</span><br />DEVELOPERS.TXT</td>
+      <td align="right">
+        <table border='0' cellspacing="0" cellpadding="2">
+          <tr>
+            <td>Path:</td>
+            <td>DEVELOPERS.TXT
+            </td>
+          </tr>
+          <tr>
+            <td>Modified:</td>
+            <td>Sun Feb 13 17:01:14 +0100 2011</td>
+          </tr>
+        </table>
+      </td></tr>
+    </table>
+  </td></tr>
+</table><br />
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="description"><h1>Developers information</h1>
+<h2>Required software</h2>
+<p>
+The tests need the following software installed:
+</p>
+<ul>
+<li>All the usual Phusion Passenger dependencies.
+</li>
+<li>Ruby on Rails 1.2.x
+</li>
+<li>Ruby on Rails 2.0.x
+</li>
+<li>Ruby on Rails 2.2.x
+</li>
+<li>Ruby on Rails 2.3.x
+</li>
+<li>Ruby on Rails 3.0.x
+</li>
+<li>rspec &gt;= 1.1.2
+</li>
+<li>mime-types &gt;= 1.15
+</li>
+<li>sqlite3-ruby
+</li>
+</ul>
+<p>
+The following software is optional:
+</p>
+<ul>
+<li>RCov, for code coverage
+</li>
+<li>RDoc, for generating HTML Ruby API documentation
+</li>
+<li>Doxygen, for generating HTML C++ API documentation
+</li>
+<li>dot (part of Graphviz), for generating diagrams in HTML API documentation
+</li>
+<li>The font &quot;Bitstream Vera Sans&quot;, used in the class diagrams. See
+<a href="http://www.gnome.org/fonts">www.gnome.org/fonts</a>
+</li>
+<li>AsciiDoc &gt;= 8.2.5, for converting various doc/*.txt documents to HTML
+</li>
+</ul>
+<h2>Compiling Phusion Passenger</h2>
+<p>
+Run the following command to compile everything:
+</p>
+<pre>
+ rake apache
+ rake nginx
+</pre>
+<h2>Directory structure</h2>
+<p>
+The most important directories are:
+</p>
+<dl>
+<dt> lib/phusion_passenger </dt><dd>The source code for the spawn server, which is written in Ruby.
+</dd>
+<dt> ext/phusion_passenger </dt><dd>Native extensions for Ruby, used by the spawn server.
+</dd>
+<dt> ext/apache2 </dt><dd>Apache 2-specific source code.
+</dd>
+<dt> ext/nginx </dt><dd>Nginx-specific source code.
+</dd>
+<dt> ext/common </dt><dd>Source code shared by the Apache and Nginx modules.
+</dd>
+<dt> bin </dt><dd>User executables.
+</dd>
+<dt> helper-scripts </dt><dd>Scripts used during runtime, but not directly executed by the user.
+</dd>
+<dt> doc </dt><dd>Various documentation.
+</dd>
+<dt> test </dt><dd>Unit tests and integration tests.
+</dd>
+<dt> test/support </dt><dd>Support/utility code, used in the tests.
+</dd>
+<dt> test/stub </dt><dd>Stub code, used in the tests.
+</dd>
+</dl>
+<p>
+Less important directories:
+</p>
+<dl>
+<dt> ext/boost </dt><dd>A stripped-down and customized version of the Boost C++ library (<a
+href="http://www.boost.org">www.boost.org</a>).
+</dd>
+<dt> ext/oxt </dt><dd>The &quot;OS eXtensions for boosT&quot; library, which provides various
+important functionality necessary for writing robust server software. It
+provides things like support for interruptable system calls and portable
+backtraces for C++. Boost was modified to make use of the functionality
+provided by OXT.
+</dd>
+<dt> dev </dt><dd>Tools for Phusion Passenger developers. Not used during production.
+</dd>
+<dt> resources </dt><dd>Various resource files, used during production.
+</dd>
+<dt> debian </dt><dd>Debian packaging files.
+</dd>
+<dt> man </dt><dd>Man pages.
+</dd>
+<dt> build </dt><dd>Rake tasks used by the build system.
+</dd>
+</dl>
+<h2>Tests</h2>
+<p>
+Run all tests:
+</p>
+<pre>
+ rake test
+</pre>
+<p>
+Run only the unit tests for the C++ components:
+</p>
+<pre>
+ rake test:cxx
+</pre>
+<p>
+Run just the unit tests for the Ruby spawn server:
+</p>
+<pre>
+ rake test:ruby
+</pre>
+<p>
+Run just the integration tests:
+</p>
+<pre>
+ rake test:integration            # All integration tests.
+ rake test:integration:apache2    # Just integration tests for Apache 2.
+ rake test:integration:nginx      # Just integration tests for Nginx.
+</pre>
+<p>
+Notes:
+</p>
+<ul>
+<li>Some tests, such as the ones that test privilege lowering, require root
+privileges. Those will only be run if Rake is run as root.
+</li>
+<li>Some tests will be run against multiple Rails versions in order to test
+compatibility. This can take a long time. If you want to test against only
+a single Rails version, then set the environment variable
+ONLY_RAILS_VERSION to one of the subdirectory names in
+test/stub/rails_apps, e.g. &#8216;export ONLY_RAILS_VERSION=2.3&#8216;
+</li>
+</ul>
+<h2>Documentation</h2>
+<p>
+Various developer documents can be found in &#8216;doc/*.html&#8217;.
+</p>
+<p>
+The Ruby part&#8216;s API reference is located in &#8216;doc/rdoc/&#8217;.
+The C++ part&#8216;s API reference is located in &#8216;doc/cxxapi/&#8217;.
+</p>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/rdoc/files/README.html ADDED

@@ -0,0 +1,157 @@
+<?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>File: README</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 border='0' cellpadding='0' cellspacing='0' width="100%" class='banner'>
+  <tr><td>
+    <table width="100%" border='0' cellpadding='0' cellspacing='0'><tr>
+      <td class="file-title" colspan="2"><span class="file-title-prefix">File</span><br />README</td>
+      <td align="right">
+        <table border='0' cellspacing="0" cellpadding="2">
+          <tr>
+            <td>Path:</td>
+            <td>README
+            </td>
+          </tr>
+          <tr>
+            <td>Modified:</td>
+            <td>Sat Sep 25 20:09:08 +0200 2010</td>
+          </tr>
+        </table>
+      </td></tr>
+    </table>
+  </td></tr>
+</table><br />
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="description"><h2>Introduction</h2>
+<p>
+Phusion Passenger probably requires no introduction. We kindly refer the
+reader to <a href="http://www.modrails.com">www.modrails.com</a>/ for
+general information.
+</p>
+<h2>Installation</h2>
+<h3>Regular installation</h3>
+<p>
+You can install either Phusion Passenger for Apache or for Nginx. Run
+either of the following programs as root:
+</p>
+<pre>
+ ./bin/passenger-install-apache2-module
+</pre>
+<p>
+-OR-
+</p>
+<pre>
+ ./bin/passenger-install-nginx-module
+</pre>
+<p>
+That&#8216;s it. :)
+</p>
+<p>
+For troubleshooting, configuration and tips, please read the corresponding
+Users Guide:
+</p>
+<pre>
+ doc/Users guide Apache.html
+ doc/Users guide Nginx.html
+</pre>
+<p>
+These files are included in the source tarball, and may also be viewed
+online on our website.
+</p>
+<h3>Installing via a gem</h3>
+<p>
+You may also first generate a .gem file, and then install that. First, make
+sure that you have the following software installed:
+</p>
+<ul>
+<li>Doxygen: <a
+href="http://www.stack.nl/~dimitri/doxygen">www.stack.nl/~dimitri/doxygen</a>/
+</li>
+<li>Asciidoc: <a
+href="http://www.methods.co.nz/asciidoc">www.methods.co.nz/asciidoc</a>/
+</li>
+</ul>
+<p>
+Next, run:
+</p>
+<pre>
+ rake package
+</pre>
+<p>
+The gem will be available under the &#8216;pkg&#8217; folder.
+</p>
+<h2>Legal</h2>
+<p>
+Phusion Passenger is a trademark of Hongli Lai &amp; Ninh Bui.
+</p>
+</div>
+</div>
+  </div>
+    </body>
+</html>