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

colouringcode-passenger 0.1 → 0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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>