RubyGems - passenger - Versions diffs - 3.0.0.pre4 → 3.0.0 - Mend

passenger 3.0.0.pre4 → 3.0.0

Potentially problematic release.

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

Files changed (175) 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 1008</span>
+1008:         <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">list_trappable</span>
+1009:                 <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>
+1010:                 <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">ruby_engine</span>
+1011:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;ruby&quot;</span>
+1012:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1013:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;ALRM&quot;</span>)
+1014:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;VTALRM&quot;</span>)
+1015:                 <span class="ruby-keyword kw">when</span> <span class="ruby-value str">&quot;jruby&quot;</span>
+1016:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1017:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;QUIT&quot;</span>)
+1018:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;ILL&quot;</span>)
+1019:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;FPE&quot;</span>)
+1020:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;KILL&quot;</span>)
+1021:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;SEGV&quot;</span>)
+1022:                         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;USR1&quot;</span>)
+1023:                 <span class="ruby-keyword kw">else</span>
+1024:                         <span class="ruby-identifier">result</span> = <span class="ruby-constant">Signal</span>.<span class="ruby-identifier">list</span>
+1025:                 <span class="ruby-keyword kw">end</span>
+1026:
+1027:                 <span class="ruby-comment cmt"># Don't touch SIGCHLD no matter what! On OS X waitpid() will</span>
+1028:                 <span class="ruby-comment cmt"># malfunction if SIGCHLD doesn't have a correct handler.</span>
+1029:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;CLD&quot;</span>)
+1030:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;CHLD&quot;</span>)
+1031:
+1032:                 <span class="ruby-comment cmt"># Other stuff that we don't want to trap no matter which</span>
+1033:                 <span class="ruby-comment cmt"># Ruby engine.</span>
+1034:                 <span class="ruby-identifier">result</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value str">&quot;STOP&quot;</span>)
+1035:
+1036:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">result</span>
+1037:         <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	+ Mon, 18 Oct 2010 13:49:23 +0200

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

@@ -0,0 +1,276 @@
+<?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 Oct 10 20:52:03 +0200 2010</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
+</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>Executables.
+</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> benchmark </dt><dd>Benchmark tools.
+</dd>
+<dt> debian </dt><dd>Debian packaging files.
+</dd>
+<dt> man </dt><dd>Man pages.
+</dd>
+<dt> misc </dt><dd>Miscellaneous tools.
+</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>