RubyGems - colouringcode-passenger - Versions diffs - 0.1 → 0.2 - Mend

colouringcode-passenger 0.1 → 0.2

Files changed (170) hide show

data/NEWS +129 -0
data/Rakefile +2 -2
data/bin/passenger-install-apache2-module +1 -0
data/bin/passenger-install-nginx-module +4 -2
data/ext/apache2/Hooks.cpp +4 -2
data/ext/common/ApplicationPoolServer.h +1 -1
data/ext/common/ApplicationPoolServerExecutable.cpp +1 -1
data/ext/common/MessageChannel.h +48 -4
data/ext/common/StandardApplicationPool.h +4 -2
data/ext/common/Version.h +1 -1
data/ext/nginx/Configuration.c +1 -1
data/ext/nginx/HttpStatusExtractor.h +1 -0
data/ext/nginx/ScgiRequestParser.h +1 -0
data/ext/oxt/system_calls.cpp +11 -0
data/ext/oxt/system_calls.hpp +2 -1
data/ext/oxt/thread.hpp +97 -1
data/ext/phusion_passenger/native_support.c +30 -1
data/lib/phusion_passenger/constants.rb +1 -1
data/lib/phusion_passenger/dependencies.rb +32 -0
data/lib/phusion_passenger/message_channel.rb +45 -3
data/lib/phusion_passenger/platform_info.rb +1 -1
data/lib/phusion_passenger/rack/application_spawner.rb +10 -4
data/lib/phusion_passenger/rack/request_handler.rb +2 -5
data/lib/phusion_passenger/railz/application_spawner.rb +59 -7
data/lib/phusion_passenger/utils.rb +70 -16
data/{vendor/rack-1.0.0-git/lib/rack → lib/phusion_passenger/utils}/rewindable_input.rb +34 -9
data/test/ApplicationPoolTest.cpp +1 -1
data/test/MessageChannelTest.cpp +9 -1
data/test/stub/message_channel.rb +1 -1
data/test/stub/message_channel_2.rb +1 -1
data/test/stub/message_channel_3.rb +2 -2
metadata +43 -155
data/doc/Architectural overview.html +0 -1
data/doc/rdoc/classes/ConditionVariable.html +0 -194
data/doc/rdoc/classes/Exception.html +0 -120
data/doc/rdoc/classes/GC.html +0 -113
data/doc/rdoc/classes/IO.html +0 -169
data/doc/rdoc/classes/PhusionPassenger.html +0 -238
data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +0 -153
data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +0 -517
data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +0 -719
data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +0 -97
data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +0 -96
data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +0 -97
data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +0 -96
data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +0 -598
data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +0 -140
data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess.html +0 -317
data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess/Instance.html +0 -138
data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +0 -154
data/doc/rdoc/classes/PhusionPassenger/Application.html +0 -283
data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +0 -172
data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +0 -145
data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +0 -181
data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +0 -141
data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +0 -92
data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +0 -489
data/doc/rdoc/classes/PhusionPassenger/NativeSupport.html +0 -350
data/doc/rdoc/classes/PhusionPassenger/Rack.html +0 -91
data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +0 -188
data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +0 -199
data/doc/rdoc/classes/PhusionPassenger/Railz.html +0 -95
data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner.html +0 -438
data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner/Error.html +0 -98
data/doc/rdoc/classes/PhusionPassenger/Railz/CGIFixed.html +0 -200
data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner.html +0 -436
data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner/Error.html +0 -98
data/doc/rdoc/classes/PhusionPassenger/Railz/RequestHandler.html +0 -155
data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +0 -402
data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +0 -125
data/doc/rdoc/classes/PhusionPassenger/Utils.html +0 -803
data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +0 -169
data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +0 -140
data/doc/rdoc/classes/PhusionPassenger/WSGI.html +0 -89
data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +0 -188
data/doc/rdoc/classes/PlatformInfo.html +0 -866
data/doc/rdoc/classes/RakeExtensions.html +0 -197
data/doc/rdoc/classes/Signal.html +0 -131
data/doc/rdoc/created.rid +0 -1
data/doc/rdoc/files/DEVELOPERS_TXT.html +0 -255
data/doc/rdoc/files/README.html +0 -175
data/doc/rdoc/files/ext/phusion_passenger/native_support_c.html +0 -92
data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +0 -129
data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +0 -129
data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +0 -126
data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +0 -128
data/doc/rdoc/files/lib/phusion_passenger/admin_tools/control_process_rb.html +0 -130
data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/application_rb.html +0 -127
data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +0 -126
data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +0 -134
data/doc/rdoc/files/lib/phusion_passenger/events_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +0 -126
data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +0 -120
data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +0 -127
data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +0 -133
data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +0 -125
data/doc/rdoc/files/lib/phusion_passenger/railz/application_spawner_rb.html +0 -140
data/doc/rdoc/files/lib/phusion_passenger/railz/cgi_fixed_rb.html +0 -126
data/doc/rdoc/files/lib/phusion_passenger/railz/framework_spawner_rb.html +0 -145
data/doc/rdoc/files/lib/phusion_passenger/railz/request_handler_rb.html +0 -125
data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +0 -122
data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +0 -159
data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +0 -174
data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +0 -129
data/doc/rdoc/files/misc/rake/extensions_rb.html +0 -130
data/doc/rdoc/fr_class_index.html +0 -91
data/doc/rdoc/fr_file_index.html +0 -76
data/doc/rdoc/fr_method_index.html +0 -205
data/doc/rdoc/index.html +0 -26
data/doc/rdoc/rdoc-style.css +0 -187
data/vendor/README +0 -13
data/vendor/README_FOR_PACKAGERS +0 -1
data/vendor/rack-1.0.0-git/COPYING +0 -18
data/vendor/rack-1.0.0-git/KNOWN-ISSUES +0 -18
data/vendor/rack-1.0.0-git/README +0 -353
data/vendor/rack-1.0.0-git/Rakefile +0 -164
data/vendor/rack-1.0.0-git/lib/rack.rb +0 -90
data/vendor/rack-1.0.0-git/lib/rack/adapter/camping.rb +0 -22
data/vendor/rack-1.0.0-git/lib/rack/auth/abstract/handler.rb +0 -37
data/vendor/rack-1.0.0-git/lib/rack/auth/abstract/request.rb +0 -37
data/vendor/rack-1.0.0-git/lib/rack/auth/basic.rb +0 -58
data/vendor/rack-1.0.0-git/lib/rack/auth/digest/md5.rb +0 -124
data/vendor/rack-1.0.0-git/lib/rack/auth/digest/nonce.rb +0 -51
data/vendor/rack-1.0.0-git/lib/rack/auth/digest/params.rb +0 -55
data/vendor/rack-1.0.0-git/lib/rack/auth/digest/request.rb +0 -40
data/vendor/rack-1.0.0-git/lib/rack/auth/openid.rb +0 -487
data/vendor/rack-1.0.0-git/lib/rack/builder.rb +0 -63
data/vendor/rack-1.0.0-git/lib/rack/cascade.rb +0 -41
data/vendor/rack-1.0.0-git/lib/rack/chunked.rb +0 -49
data/vendor/rack-1.0.0-git/lib/rack/commonlogger.rb +0 -52
data/vendor/rack-1.0.0-git/lib/rack/conditionalget.rb +0 -47
data/vendor/rack-1.0.0-git/lib/rack/content_length.rb +0 -29
data/vendor/rack-1.0.0-git/lib/rack/content_type.rb +0 -23
data/vendor/rack-1.0.0-git/lib/rack/deflater.rb +0 -96
data/vendor/rack-1.0.0-git/lib/rack/directory.rb +0 -153
data/vendor/rack-1.0.0-git/lib/rack/file.rb +0 -88
data/vendor/rack-1.0.0-git/lib/rack/handler.rb +0 -69
data/vendor/rack-1.0.0-git/lib/rack/handler/cgi.rb +0 -61
data/vendor/rack-1.0.0-git/lib/rack/handler/evented_mongrel.rb +0 -8
data/vendor/rack-1.0.0-git/lib/rack/handler/fastcgi.rb +0 -88
data/vendor/rack-1.0.0-git/lib/rack/handler/lsws.rb +0 -55
data/vendor/rack-1.0.0-git/lib/rack/handler/mongrel.rb +0 -84
data/vendor/rack-1.0.0-git/lib/rack/handler/scgi.rb +0 -59
data/vendor/rack-1.0.0-git/lib/rack/handler/swiftiplied_mongrel.rb +0 -8
data/vendor/rack-1.0.0-git/lib/rack/handler/thin.rb +0 -18
data/vendor/rack-1.0.0-git/lib/rack/handler/webrick.rb +0 -67
data/vendor/rack-1.0.0-git/lib/rack/head.rb +0 -19
data/vendor/rack-1.0.0-git/lib/rack/lint.rb +0 -537
data/vendor/rack-1.0.0-git/lib/rack/lobster.rb +0 -65
data/vendor/rack-1.0.0-git/lib/rack/lock.rb +0 -16
data/vendor/rack-1.0.0-git/lib/rack/methodoverride.rb +0 -27
data/vendor/rack-1.0.0-git/lib/rack/mime.rb +0 -204
data/vendor/rack-1.0.0-git/lib/rack/mock.rb +0 -184
data/vendor/rack-1.0.0-git/lib/rack/recursive.rb +0 -57
data/vendor/rack-1.0.0-git/lib/rack/reloader.rb +0 -106
data/vendor/rack-1.0.0-git/lib/rack/request.rb +0 -248
data/vendor/rack-1.0.0-git/lib/rack/response.rb +0 -183
data/vendor/rack-1.0.0-git/lib/rack/session/abstract/id.rb +0 -142
data/vendor/rack-1.0.0-git/lib/rack/session/cookie.rb +0 -91
data/vendor/rack-1.0.0-git/lib/rack/session/memcache.rb +0 -109
data/vendor/rack-1.0.0-git/lib/rack/session/pool.rb +0 -100
data/vendor/rack-1.0.0-git/lib/rack/showexceptions.rb +0 -349
data/vendor/rack-1.0.0-git/lib/rack/showstatus.rb +0 -106
data/vendor/rack-1.0.0-git/lib/rack/static.rb +0 -38
data/vendor/rack-1.0.0-git/lib/rack/urlmap.rb +0 -55
data/vendor/rack-1.0.0-git/lib/rack/utils.rb +0 -522

data/doc/rdoc/classes/PhusionPassenger/InitializationError.html DELETED

@@ -1,141 +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::InitializationError</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::InitializationError</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-StandardError
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><p>
-An abstract base class for <a href="AppInitError.html">AppInitError</a> and
-<a href="FrameworkInitError.html">FrameworkInitError</a>. This represents
-the failure when initializing something.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000156">new</a></li>
-  </ul>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>child_exception</td>
-    <td class='attr-desc'>
-The exception that caused initialization to fail. This may be nil.
-</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000156"></a><b>new</b>(message, child_exception = nil)
-  </div>
-  <div class="description">
-  <p>
-Create a <a href="InitializationError.html#M000156">new</a> <a
-href="InitializationError.html">InitializationError</a>. <tt>message</tt>
-is the error message, and <tt>child_exception</tt> is the exception that
-caused initialization to fail.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000156_source')" id="l_M000156_source">show source</a> ]</p>
-  <div id="M000156_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/exceptions.rb, line 48</span>
-48:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>)
-49:                 <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">message</span>)
-50:                 <span class="ruby-ivar">@child_exception</span> = <span class="ruby-identifier">child_exception</span>
-51:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html DELETED

@@ -1,92 +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::InvalidPath</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::InvalidPath</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-StandardError
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html DELETED

@@ -1,489 +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::MessageChannel</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::MessageChannel</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../files/lib/phusion_passenger/message_channel_rb.html">lib/phusion_passenger/message_channel.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="description"><p>
-This class provides convenience methods for:
-</p>
-<ul>
-<li>sending and receiving raw data over an <a href="../IO.html">IO</a> channel.
-</li>
-<li>sending and receiving messages over an <a href="../IO.html">IO</a> channel.
-</li>
-<li>file descriptor (<a href="../IO.html">IO</a> object) passing over a Unix
-socket.
-</li>
-</ul>
-<p>
-All of these methods use exceptions for error reporting.
-</p>
-<p>
-There are two kinds of messages:
-</p>
-<dl>
-<dt> Array messages </dt><dd>These are just a list of strings, and the message itself has a specific
-length. The contained strings may not contain NUL characters
-(<tt>&#8217;\0&#8216;</tt>). Note that an array message must have at least
-one element.
-</dd>
-<dt> Scalar messages </dt><dd>These are byte strings which may contain arbitrary binary data. Scalar
-messages also have a specific length.
-</dd>
-</dl>
-<p>
-The protocol is designed to be low overhead, easy to implement and easy to
-parse.
-</p>
-<p>
-<a href="MessageChannel.html">MessageChannel</a> is to be wrapped around an
-<a href="../IO.html">IO</a> object. For example:
-</p>
-<pre>
- a, b = IO.pipe
- channel1 = MessageChannel.new(a)
- channel2 = MessageChannel.new(b)
- # Send an array message.
- channel2.write(&quot;hello&quot;, &quot;world !!&quot;)
- channel1.read    # =&gt; [&quot;hello&quot;, &quot;world !!&quot;]
- # Send a scalar message.
- channel2.write_scalar(&quot;some long string which can contain arbitrary binary data&quot;)
- channel1.read_scalar
-</pre>
-<p>
-The life time of a <a href="MessageChannel.html">MessageChannel</a> is
-independent from that of the wrapped <a href="../IO.html">IO</a> object. If
-a <a href="MessageChannel.html">MessageChannel</a> object is destroyed, the
-underlying <a href="../IO.html">IO</a> object is not automatically closed.
-Call <a href="MessageChannel.html#M000147">close</a>() if you want to <a
-href="MessageChannel.html#M000147">close</a> the underlying <a
-href="../IO.html">IO</a> object.
-</p>
-<p>
-Note: Be careful with mixing the sending/receiving of array messages,
-scalar messages and <a href="../IO.html">IO</a> objects. If you send a
-collection of any of these in a specific order, then the receiving side
-must receive them in the exact some order. So suppose you first send a
-message, then an <a href="../IO.html">IO</a> object, then a scalar, then
-the receiving side must first receive a message, then an <a
-href="../IO.html">IO</a> object, then a scalar. If the receiving side does
-things in the wrong order then bad things will happen.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000147">close</a></li>
-  <li><a href="#M000146">fileno</a></li>
-  <li><a href="#M000139">new</a></li>
-  <li><a href="#M000140">read</a></li>
-  <li><a href="#M000141">read_scalar</a></li>
-  <li><a href="#M000144">recv_io</a></li>
-  <li><a href="#M000145">send_io</a></li>
-  <li><a href="#M000142">write</a></li>
-  <li><a href="#M000143">write_scalar</a></li>
-  </ul>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[R]
-    </td>
-    <td class='attr-name'>io</td>
-    <td class='attr-desc'>
-The wrapped <a href="../IO.html">IO</a> object.
-</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000139"></a><b>new</b>(io)
-  </div>
-  <div class="description">
-  <p>
-Create a <a href="MessageChannel.html#M000139">new</a> <a
-href="MessageChannel.html">MessageChannel</a> by wrapping the given <a
-href="../IO.html">IO</a> object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">show source</a> ]</p>
-  <div id="M000139_source" class="dyn-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 83</span>
-83:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">io</span>)
-84:                 <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</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="M000147"></a><b>close</b>()
-  </div>
-  <div class="description">
-  <p>
-Close the underlying <a href="../IO.html">IO</a> stream. Might raise
-SystemCallError or IOError when something goes wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000147_source')" id="l_M000147_source">show source</a> ]</p>
-  <div id="M000147_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 217</span>
-217:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
-218:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">close</span>
-219:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000146"></a><b>fileno</b>()
-  </div>
-  <div class="description">
-  <p>
-Return the file descriptor of the underlying <a href="../IO.html">IO</a>
-object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000146_source')" id="l_M000146_source">show source</a> ]</p>
-  <div id="M000146_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 211</span>
-211:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fileno</span>
-212:                 <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">fileno</span>
-213:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000140"></a><b>read</b>()
-  </div>
-  <div class="description">
-  <p>
-Read an array message from the underlying file descriptor. Returns the
-array message as an array, or nil when end-of-stream has been reached.
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000140_source')" id="l_M000140_source">show source</a> ]</p>
-  <div id="M000140_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 93</span>
- 93:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>
- 94:                 <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
- 95:                 <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-constant">HEADER_SIZE</span>
- 96:                         <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">readpartial</span>(<span class="ruby-constant">HEADER_SIZE</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
- 97:                 <span class="ruby-keyword kw">end</span>
- 98:
- 99:                 <span class="ruby-identifier">chunk_size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'n'</span>)[<span class="ruby-value">0</span>]
-100:                 <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
-101:                 <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">chunk_size</span>
-102:                         <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">readpartial</span>(<span class="ruby-identifier">chunk_size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
-103:                 <span class="ruby-keyword kw">end</span>
-104:
-105:                 <span class="ruby-identifier">message</span> = []
-106:                 <span class="ruby-identifier">offset</span> = <span class="ruby-value">0</span>
-107:                 <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
-108:                 <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
-109:                         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-110:                                 <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&quot;</span>
-111:                         <span class="ruby-keyword kw">else</span>
-112:                                 <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
-113:                         <span class="ruby-keyword kw">end</span>
-114:                         <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
-115:                         <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
-116:                 <span class="ruby-keyword kw">end</span>
-117:                 <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">message</span>
-118:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
-119:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-120:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>
-121:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-122:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000141"></a><b>read_scalar</b>(max_size = nil)
-  </div>
-  <div class="description">
-  <p>
-Read a scalar message from the underlying <a href="../IO.html">IO</a>
-object. Returns the <a href="MessageChannel.html#M000140">read</a> message,
-or nil on end-of-stream.
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-<p>
-The <tt>max_size</tt> argument allows one to specify the maximum allowed
-size for the scalar message. If the received scalar message&#8216;s size is
-larger than <tt>max_size</tt>, then a SecurityError will be raised.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000141_source')" id="l_M000141_source">show source</a> ]</p>
-  <div id="M000141_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 133</span>
-133:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_scalar</span>(<span class="ruby-identifier">max_size</span> = <span class="ruby-keyword kw">nil</span>)
-134:                 <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
-135:                 <span class="ruby-identifier">temp</span> = <span class="ruby-value str">''</span>
-136:                 <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">4</span>
-137:                         <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">readpartial</span>(<span class="ruby-value">4</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>, <span class="ruby-identifier">temp</span>)
-138:                 <span class="ruby-keyword kw">end</span>
-139:                 <span class="ruby-identifier">size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'N'</span>)[<span class="ruby-value">0</span>]
-140:                 <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-141:                         <span class="ruby-keyword kw">return</span> <span class="ruby-value str">''</span>
-142:                 <span class="ruby-keyword kw">else</span>
-143:                         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">max_size</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">max_size</span>
-144:                                 <span class="ruby-identifier">raise</span> <span class="ruby-constant">SecurityError</span>, <span class="ruby-node">&quot;Scalar message size (#{size}) &quot;</span> <span class="ruby-operator">&lt;&lt;</span>
-145:                                         <span class="ruby-node">&quot;exceeds maximum allowed size (#{max_size}).&quot;</span>
-146:                         <span class="ruby-keyword kw">end</span>
-147:                         <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
-148:                         <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">size</span>
-149:                                 <span class="ruby-identifier">temp</span> = <span class="ruby-value str">''</span> <span class="ruby-comment cmt"># JRuby doesn't clear the buffer. TODO: remove this when JRuby has been fixed.</span>
-150:                                 <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">readpartial</span>(<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>, <span class="ruby-identifier">temp</span>)
-151:                         <span class="ruby-keyword kw">end</span>
-152:                         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">buffer</span>
-153:                 <span class="ruby-keyword kw">end</span>
-154:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
-155:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-156:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>
-157:                 <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-158:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000144"></a><b>recv_io</b>()
-  </div>
-  <div class="description">
-  <p>
-Receive an <a href="../IO.html">IO</a> object (a file descriptor) from the
-channel. The other side must have sent an <a href="../IO.html">IO</a>
-object by calling <a href="MessageChannel.html#M000145">send_io</a>(). Note
-that this only works on Unix sockets.
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000144_source')" id="l_M000144_source">show source</a> ]</p>
-  <div id="M000144_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 196</span>
-196:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recv_io</span>
-197:                 <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">recv_io</span>
-198:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000145"></a><b>send_io</b>(io)
-  </div>
-  <div class="description">
-  <p>
-Send an <a href="../IO.html">IO</a> object (a file descriptor) over the
-channel. The other side must receive the <a href="../IO.html">IO</a> object
-by calling <a href="MessageChannel.html#M000144">recv_io</a>(). Note that
-this only works on Unix sockets.
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000145_source')" id="l_M000145_source">show source</a> ]</p>
-  <div id="M000145_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 206</span>
-206:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
-207:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
-208:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000142"></a><b>write</b>(name, *args)
-  </div>
-  <div class="description">
-  <p>
-Send an array message, which consists of the given elements, over the
-underlying file descriptor. <em>name</em> is the first element in the
-message, and <em>args</em> are the other elements. These arguments will
-internally be converted to strings by calling to_s().
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000142_source')" id="l_M000142_source">show source</a> ]</p>
-  <div id="M000142_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 167</span>
-167:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-168:                 <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">name</span>)
-169:                 <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
-170:                         <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">arg</span>)
-171:                 <span class="ruby-keyword kw">end</span>
-172:
-173:                 <span class="ruby-identifier">message</span> = <span class="ruby-node">&quot;#{name}#{DELIMITER}&quot;</span>
-174:                 <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
-175:                         <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">DELIMITER</span>
-176:                 <span class="ruby-keyword kw">end</span>
-177:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">message</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'n'</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">message</span>)
-178:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
-179:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000143"></a><b>write_scalar</b>(data)
-  </div>
-  <div class="description">
-  <p>
-Send a scalar message over the underlying <a href="../IO.html">IO</a>
-object.
-</p>
-<p>
-Might raise SystemCallError, IOError or SocketError when something goes
-wrong.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000143_source')" id="l_M000143_source">show source</a> ]</p>
-  <div id="M000143_source" class="dyn-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 185</span>
-185:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">data</span>)
-186:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">data</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'N'</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">data</span>)
-187:                 <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
-188:         <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>