RubyGems - thin - Versions diffs - 0.3.0 → 0.4.0 - Mend

thin 0.3.0 → 0.4.0

Potentially problematic release.

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

Files changed (51) hide show

data/README +47 -5
data/Rakefile +33 -2
data/doc/rdoc/classes/Kernel.html +182 -0
data/doc/rdoc/classes/Process.html +175 -0
data/doc/rdoc/classes/Thin.html +184 -0
data/doc/rdoc/classes/Thin/CGIWrapper.html +438 -0
data/doc/rdoc/classes/Thin/Cluster.html +392 -0
data/doc/rdoc/classes/Thin/Command.html +221 -0
data/doc/rdoc/classes/Thin/CommandError.html +154 -0
data/doc/rdoc/classes/Thin/Commands.html +145 -0
data/doc/rdoc/classes/Thin/Daemonizable.html +250 -0
data/doc/rdoc/classes/Thin/Daemonizable/ClassMethods.html +203 -0
data/doc/rdoc/classes/Thin/DirHandler.html +250 -0
data/doc/rdoc/classes/Thin/Handler.html +195 -0
data/doc/rdoc/classes/Thin/Headers.html +244 -0
data/doc/rdoc/classes/Thin/InvalidRequest.html +150 -0
data/doc/rdoc/classes/Thin/Logging.html +214 -0
data/doc/rdoc/classes/Thin/RailsHandler.html +234 -0
data/doc/rdoc/classes/Thin/RailsServer.html +175 -0
data/doc/rdoc/classes/Thin/Request.html +379 -0
data/doc/rdoc/classes/Thin/Response.html +311 -0
data/doc/rdoc/classes/Thin/Server.html +381 -0
data/doc/rdoc/created.rid +1 -0
data/doc/rdoc/files/README.html +260 -0
data/doc/rdoc/files/bin/thin.html +188 -0
data/doc/rdoc/files/bin/thin_cluster.html +175 -0
data/doc/rdoc/files/lib/thin/cgi_rb.html +263 -0
data/doc/rdoc/files/lib/thin/cluster_rb.html +263 -0
data/doc/rdoc/files/lib/thin/command_rb.html +263 -0
data/doc/rdoc/files/lib/thin/consts_rb.html +263 -0
data/doc/rdoc/files/lib/thin/daemonizing_rb.html +263 -0
data/doc/rdoc/files/lib/thin/handler_rb.html +263 -0
data/doc/rdoc/files/lib/thin/headers_rb.html +263 -0
data/doc/rdoc/files/lib/thin/logging_rb.html +263 -0
data/doc/rdoc/files/lib/thin/mime_types_rb.html +263 -0
data/doc/rdoc/files/lib/thin/rails_rb.html +263 -0
data/doc/rdoc/files/lib/thin/recipes_rb.html +171 -0
data/doc/rdoc/files/lib/thin/request_rb.html +171 -0
data/doc/rdoc/files/lib/thin/response_rb.html +171 -0
data/doc/rdoc/files/lib/thin/server_rb.html +171 -0
data/doc/rdoc/files/lib/thin/statuses_rb.html +171 -0
data/doc/rdoc/files/lib/thin/version_rb.html +171 -0
data/doc/rdoc/index.html +10 -0
data/doc/rdoc/logo.gif +0 -0
data/doc/rdoc/rdoc-style.css +86 -0
data/lib/thin/commands/cluster/config.rb +2 -0
data/lib/thin/consts.rb +4 -0
data/lib/thin/request.rb +30 -11
data/lib/thin/server.rb +1 -1
data/lib/thin/version.rb +1 -1
metadata +52 -1

data/doc/rdoc/classes/Thin/Server.html ADDED Viewed

@@ -0,0 +1,381 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <title>
+  thin &raquo; Class: Thin::Server
+  </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", "width=400,height=400,scrollbars=yes" )
+    }
+    // ]]>
+  </script>
+</head>
+  <body>
+    <ul id="menu">
+      <li><a href="/thin/">home</a></li>
+      <li><a href="/thin/doc/">doc</a></li>
+      <li><a href="/thin/trac.fcgi/timeline">timeline</a></li>
+      <li><a href="/thin/trac.fcgi/browser">code</a></li>
+      <li><a href="/thin/trac.fcgi/report">tickets</a></li>
+      <li><a href="/thin/trac.fcgi/newticket">new ticket</a></li>
+    </ul>
+    <div id="sidebar">
+      <h2>Files</h2>
+      <ul class="list">
+        <li><a href="../../files/README.html" value="File: README">README</a></li>
+        <li><a href="../../files/lib/thin/cgi_rb.html" value="File: cgi.rb">lib/thin/cgi.rb</a></li>
+        <li><a href="../../files/lib/thin/cluster_rb.html" value="File: cluster.rb">lib/thin/cluster.rb</a></li>
+        <li><a href="../../files/lib/thin/command_rb.html" value="File: command.rb">lib/thin/command.rb</a></li>
+        <li><a href="../../files/lib/thin/consts_rb.html" value="File: consts.rb">lib/thin/consts.rb</a></li>
+        <li><a href="../../files/lib/thin/daemonizing_rb.html" value="File: daemonizing.rb">lib/thin/daemonizing.rb</a></li>
+        <li><a href="../../files/lib/thin/handler_rb.html" value="File: handler.rb">lib/thin/handler.rb</a></li>
+        <li><a href="../../files/lib/thin/headers_rb.html" value="File: headers.rb">lib/thin/headers.rb</a></li>
+        <li><a href="../../files/lib/thin/logging_rb.html" value="File: logging.rb">lib/thin/logging.rb</a></li>
+        <li><a href="../../files/lib/thin/mime_types_rb.html" value="File: mime_types.rb">lib/thin/mime_types.rb</a></li>
+        <li><a href="../../files/lib/thin/rails_rb.html" value="File: rails.rb">lib/thin/rails.rb</a></li>
+        <li><a href="../../files/lib/thin/recipes_rb.html" value="File: recipes.rb">lib/thin/recipes.rb</a></li>
+        <li><a href="../../files/lib/thin/request_rb.html" value="File: request.rb">lib/thin/request.rb</a></li>
+        <li><a href="../../files/lib/thin/response_rb.html" value="File: response.rb">lib/thin/response.rb</a></li>
+        <li><a href="../../files/lib/thin/server_rb.html" value="File: server.rb">lib/thin/server.rb</a></li>
+        <li><a href="../../files/lib/thin/statuses_rb.html" value="File: statuses.rb">lib/thin/statuses.rb</a></li>
+        <li><a href="../../files/lib/thin/version_rb.html" value="File: version.rb">lib/thin/version.rb</a></li>
+        <li><a href="../../files/bin/thin.html" value="File: thin">bin/thin</a></li>
+        <li><a href="../../files/bin/thin_cluster.html" value="File: thin_cluster">bin/thin_cluster</a></li>
+      </ul>
+      <h2>Classes</h2>
+      <ul class="list">
+        <li><a href="../../classes/Thin.html" title="Module: Thin">Thin</a></li>
+        <li><a href="../../classes/Thin/Commands.html" title="Module: Thin::Commands">Thin::Commands</a></li>
+        <li><a href="../../classes/Thin/Daemonizable.html" title="Module: Thin::Daemonizable">Thin::Daemonizable</a></li>
+        <li><a href="../../classes/Thin/Daemonizable/ClassMethods.html" title="Module: Thin::Daemonizable::ClassMethods">Thin::Daemonizable::ClassMethods</a></li>
+        <li><a href="../../classes/Thin/VERSION.html" title="Module: Thin::VERSION">Thin::VERSION</a></li>
+        <li><a href="../../classes/Thin/Logging.html" title="Module: Thin::Logging">Thin::Logging</a></li>
+        <li><a href="../../classes/Thin/DirHandler.html" title="Class: Thin::DirHandler">Thin::DirHandler</a></li>
+        <li><a href="../../classes/Thin/InvalidRequest.html" title="Class: Thin::InvalidRequest">Thin::InvalidRequest</a></li>
+        <li><a href="../../classes/Thin/CGIWrapper.html" title="Class: Thin::CGIWrapper">Thin::CGIWrapper</a></li>
+        <li><a href="../../classes/Thin/Command.html" title="Class: Thin::Command">Thin::Command</a></li>
+        <li><a href="../../classes/Thin/Response.html" title="Class: Thin::Response">Thin::Response</a></li>
+        <li><a href="../../classes/Thin/Headers.html" title="Class: Thin::Headers">Thin::Headers</a></li>
+        <li><a href="../../classes/Thin/Server.html" title="Class: Thin::Server">Thin::Server</a></li>
+        <li><a href="../../classes/Thin/CommandError.html" title="Class: Thin::CommandError">Thin::CommandError</a></li>
+        <li><a href="../../classes/Thin/Request.html" title="Class: Thin::Request">Thin::Request</a></li>
+        <li><a href="../../classes/Thin/RailsServer.html" title="Class: Thin::RailsServer">Thin::RailsServer</a></li>
+        <li><a href="../../classes/Thin/Cluster.html" title="Class: Thin::Cluster">Thin::Cluster</a></li>
+        <li><a href="../../classes/Thin/RailsHandler.html" title="Class: Thin::RailsHandler">Thin::RailsHandler</a></li>
+        <li><a href="../../classes/Thin/Handler.html" title="Class: Thin::Handler">Thin::Handler</a></li>
+        <li><a href="../../classes/Process.html" title="Module: Process">Process</a></li>
+        <li><a href="../../classes/Kernel.html" title="Module: Kernel">Kernel</a></li>
+      </ul>
+    </div>
+    <div id="container">
+      <div id="header">
+        <a href="/thin/" title="Home">
+          <img id="logo" src="../../logo.gif" />
+        </a>
+        <h2 id="tag_line">A fast and very simple Ruby web server</h2>
+      </div>
+      <div id="content">
+        <h2>Class: Thin::Server</h2>
+<div id="Thin::Server" class="page_shade">
+<div class="page">
+<h3>Class Thin::Server &lt; <a href="Handler.html">Object</a></h3>
+<span class="path">(in files
+<a href="../../files/lib/thin/server_rb.html">lib/thin/server.rb</a>
+)</span>
+<p>
+The <a href="../Thin.html">Thin</a> HTTP server used to served request. It
+listen for incoming request on a given port and forward all request to all
+the handlers in the order they were registered. Based on HTTP 1.1 protocol
+specs <a
+href="http://www.w3.org/Protocols/rfc2616/rfc2616.html">www.w3.org/Protocols/rfc2616/rfc2616.html</a>
+</p>
+<h4>Includes</h4>
+<ul>
+<li><a href="Logging.html">Logging</a></li>
+<li><a href="Daemonizable.html">Daemonizable</a></li>
+</ul>
+<h2 class="ruled">Methods</h2>
+<h4 class="ruled">
+<span class="method-type" title="Public Class method">Public Class</span>
+<strong><a name="M000041" href="#M000041" title="Permalink to Public Class method: new">new(host, port, *handlers)</a></strong>
+</h4>
+<p>
+Creates a <a href="Server.html#M000041">new</a> server binded to
+<tt>host:port</tt> that will pass request to <tt>handlers</tt>.
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000041_source')" id="l_M000041_source">show source</a> ]</p>
+  <div id="M000041_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/thin/server.rb, line 25</span>
+25:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">host</span>, <span class="ruby-identifier">port</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">handlers</span>)
+26:       <span class="ruby-ivar">@host</span>       = <span class="ruby-identifier">host</span>
+27:       <span class="ruby-ivar">@port</span>       = <span class="ruby-identifier">port</span>
+28:       <span class="ruby-ivar">@handlers</span>   = <span class="ruby-identifier">handlers</span>
+29:       <span class="ruby-ivar">@timeout</span>    = <span class="ruby-value">60</span>     <span class="ruby-comment cmt"># sec, max time to read and parse a request</span>
+30:       <span class="ruby-ivar">@trace</span>      = <span class="ruby-keyword kw">false</span>
+31:
+32:       <span class="ruby-ivar">@stop</span>       = <span class="ruby-keyword kw">true</span>   <span class="ruby-comment cmt"># true is server is stopped</span>
+33:       <span class="ruby-ivar">@processing</span> = <span class="ruby-keyword kw">false</span>  <span class="ruby-comment cmt"># true is processing a request</span>
+34:
+35:       <span class="ruby-ivar">@socket</span>     = <span class="ruby-constant">TCPServer</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">host</span>, <span class="ruby-identifier">port</span>)
+36:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000044" href="#M000044" title="Permalink to Public Instance method: listen!">listen!()</a></strong>
+</h4>
+<p>
+Start listening for connections
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000044_source')" id="l_M000044_source">show source</a> ]</p>
+  <div id="M000044_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/thin/server.rb, line 56</span>
+56:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">listen!</span>
+57:       <span class="ruby-ivar">@stop</span> = <span class="ruby-keyword kw">false</span>
+58:       <span class="ruby-identifier">trap</span>(<span class="ruby-value str">'INT'</span>) <span class="ruby-keyword kw">do</span>
+59:         <span class="ruby-identifier">log</span> <span class="ruby-value str">'&gt;&gt; Caught INT signal, stopping ...'</span>
+60:         <span class="ruby-identifier">stop</span>
+61:       <span class="ruby-keyword kw">end</span>
+62:
+63:       <span class="ruby-identifier">log</span> <span class="ruby-node">&quot;&gt;&gt; Listening on #{host}:#{port}, CTRL+C to stop&quot;</span>
+64:       <span class="ruby-keyword kw">until</span> <span class="ruby-ivar">@stop</span>
+65:         <span class="ruby-ivar">@processing</span> = <span class="ruby-keyword kw">false</span>
+66:         <span class="ruby-identifier">client</span> = <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">accept</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+67:         <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">closed?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">client</span>.<span class="ruby-identifier">nil?</span>
+68:         <span class="ruby-ivar">@processing</span> = <span class="ruby-keyword kw">true</span>
+69:         <span class="ruby-identifier">process</span>(<span class="ruby-identifier">client</span>)
+70:       <span class="ruby-keyword kw">end</span>
+71:     <span class="ruby-keyword kw">ensure</span>
+72:       <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">closed?</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+73:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000045" href="#M000045" title="Permalink to Public Instance method: process">process(client)</a></strong>
+</h4>
+<p>
+<a href="../Process.html">Process</a> one request from a client
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show source</a> ]</p>
+  <div id="M000045_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/thin/server.rb, line 76</span>
+ 76:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">client</span>)
+ 77:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">client</span>.<span class="ruby-identifier">eof?</span>
+ 78:
+ 79:       <span class="ruby-identifier">trace</span> { <span class="ruby-value str">'Request started'</span>.<span class="ruby-identifier">center</span>(<span class="ruby-value">80</span>, <span class="ruby-value str">'='</span>) }
+ 80:
+ 81:       <span class="ruby-identifier">request</span>  = <span class="ruby-constant">Request</span>.<span class="ruby-identifier">new</span>
+ 82:       <span class="ruby-identifier">response</span> = <span class="ruby-constant">Response</span>.<span class="ruby-identifier">new</span>
+ 83:
+ 84:       <span class="ruby-identifier">request</span>.<span class="ruby-identifier">trace</span> = <span class="ruby-ivar">@trace</span>
+ 85:       <span class="ruby-identifier">trace</span> { <span class="ruby-value str">&quot;&gt;&gt; Tracing request parsing ... &quot;</span> }
+ 86:
+ 87:       <span class="ruby-comment cmt"># Parse the request checking for timeout to prevent DOS attacks</span>
+ 88:       <span class="ruby-constant">Timeout</span>.<span class="ruby-identifier">timeout</span>(<span class="ruby-ivar">@timeout</span>) { <span class="ruby-identifier">request</span>.<span class="ruby-identifier">parse!</span>(<span class="ruby-identifier">client</span>) }
+ 89:       <span class="ruby-identifier">trace</span> { <span class="ruby-identifier">request</span>.<span class="ruby-identifier">raw</span> }
+ 90:
+ 91:       <span class="ruby-comment cmt"># Add client info to the request env</span>
+ 92:       <span class="ruby-identifier">request</span>.<span class="ruby-identifier">params</span>[<span class="ruby-value str">'REMOTE_ADDR'</span>] = <span class="ruby-identifier">client</span>.<span class="ruby-identifier">peeraddr</span>.<span class="ruby-identifier">last</span>
+ 93:
+ 94:       <span class="ruby-comment cmt"># Add server info to the request env</span>
+ 95:       <span class="ruby-identifier">request</span>.<span class="ruby-identifier">params</span>[<span class="ruby-value str">'SERVER_SOFTWARE'</span>] = <span class="ruby-constant">SERVER</span>
+ 96:       <span class="ruby-identifier">request</span>.<span class="ruby-identifier">params</span>[<span class="ruby-value str">'SERVER_PORT'</span>]     = <span class="ruby-ivar">@port</span>.<span class="ruby-identifier">to_s</span>
+ 97:
+ 98:       <span class="ruby-identifier">served</span> = <span class="ruby-keyword kw">false</span>
+ 99:       <span class="ruby-ivar">@handlers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">handler</span><span class="ruby-operator">|</span>
+100:         <span class="ruby-identifier">served</span> = <span class="ruby-identifier">handler</span>.<span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
+101:         <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">served</span>
+102:       <span class="ruby-keyword kw">end</span>
+103:
+104:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">served</span>
+105:         <span class="ruby-identifier">trace</span> { <span class="ruby-value str">&quot;&gt;&gt; Sending response:\n&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">to_s</span> }
+106:         <span class="ruby-identifier">response</span>.<span class="ruby-identifier">write</span> <span class="ruby-identifier">client</span>
+107:       <span class="ruby-keyword kw">else</span>
+108:         <span class="ruby-identifier">client</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">ERROR_404_RESPONSE</span>
+109:       <span class="ruby-keyword kw">end</span>
+110:
+111:       <span class="ruby-identifier">trace</span> { <span class="ruby-value str">'Request finished'</span>.<span class="ruby-identifier">center</span>(<span class="ruby-value">80</span>, <span class="ruby-value str">'='</span>) }
+112:
+113:     <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EPIPE</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EINVAL</span>, <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EBADF</span>
+114:       <span class="ruby-comment cmt"># Can't do anything sorry, closing the socket in the ensure block</span>
+115:     <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">InvalidRequest</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+116:       <span class="ruby-identifier">log</span> <span class="ruby-node">&quot;Invalid request: #{e.message}&quot;</span>
+117:       <span class="ruby-identifier">trace</span> { <span class="ruby-identifier">e</span>.<span class="ruby-identifier">backtrace</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;\n&quot;</span>) }
+118:       <span class="ruby-identifier">client</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">ERROR_400_RESPONSE</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+119:     <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Object</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+120:       <span class="ruby-identifier">log</span> <span class="ruby-node">&quot;Unexpected error while processing request: #{e.message}&quot;</span>
+121:       <span class="ruby-identifier">log</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">backtrace</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;\n&quot;</span>)
+122:     <span class="ruby-keyword kw">ensure</span>
+123:       <span class="ruby-identifier">request</span>.<span class="ruby-identifier">close</span>  <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">request</span>            <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+124:       <span class="ruby-identifier">response</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">response</span>           <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+125:       <span class="ruby-identifier">client</span>.<span class="ruby-identifier">close</span>   <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">client</span>.<span class="ruby-identifier">closed?</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
+126:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000042" href="#M000042" title="Permalink to Public Instance method: start">start()</a></strong>
+</h4>
+<p>
+Starts the handlers.
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000042_source')" id="l_M000042_source">show source</a> ]</p>
+  <div id="M000042_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/thin/server.rb, line 39</span>
+39:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start</span>
+40:       <span class="ruby-identifier">log</span>   <span class="ruby-node">&quot;&gt;&gt; Thin web server (v#{VERSION::STRING})&quot;</span>
+41:       <span class="ruby-identifier">trace</span> <span class="ruby-value str">&quot;&gt;&gt; Tracing ON&quot;</span>
+42:
+43:       <span class="ruby-ivar">@handlers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">handler</span><span class="ruby-operator">|</span>
+44:         <span class="ruby-identifier">log</span> <span class="ruby-node">&quot;&gt;&gt; Starting #{handler} ...&quot;</span>
+45:         <span class="ruby-identifier">handler</span>.<span class="ruby-identifier">start</span>
+46:       <span class="ruby-keyword kw">end</span>
+47:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000043" href="#M000043" title="Permalink to Public Instance method: start!">start!()</a></strong>
+</h4>
+<p>
+Start the server and listen for connections
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">show source</a> ]</p>
+  <div id="M000043_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/thin/server.rb, line 50</span>
+50:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start!</span>
+51:       <span class="ruby-identifier">start</span>
+52:       <span class="ruby-identifier">listen!</span>
+53:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000046" href="#M000046" title="Permalink to Public Instance method: stop">stop()</a></strong>
+</h4>
+<p>
+Stop the server from accepting <a href="Server.html#M000041">new</a>
+request. If a request is processing, wait for this to finish and shutdown
+the server.
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show source</a> ]</p>
+  <div id="M000046_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/thin/server.rb, line 131</span>
+131:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stop</span>
+132:       <span class="ruby-ivar">@stop</span> = <span class="ruby-keyword kw">true</span>
+133:       <span class="ruby-identifier">stop!</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@processing</span>  <span class="ruby-comment cmt"># Not processing a request, so we can stop now</span>
+134:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000047" href="#M000047" title="Permalink to Public Instance method: stop!">stop!()</a></strong>
+</h4>
+<p>
+Force the server to <a href="Server.html#M000046">stop</a> right now!
+</p>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">show source</a> ]</p>
+  <div id="M000047_source" class="dyn-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/thin/server.rb, line 137</span>
+137:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stop!</span>
+138:       <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-comment cmt"># break the accept loop by closing the socket</span>
+139:     <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+      </div>
+    </div>
+    <div id="footer">
+      <hr />
+      &copy; <a href="http://macournoyer.com">Marc-Andr&eacute; Cournoyer</a>
+    </div>
+  </body>
+</html>

data/doc/rdoc/created.rid ADDED Viewed

	@@ -0,0 +1 @@
1	+ Mon, 03 Dec 2007 23:40:27 -0500

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

@@ -0,0 +1,260 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <title>
+  thin &raquo; 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", "width=400,height=400,scrollbars=yes" )
+    }
+    // ]]>
+  </script>
+</head>
+  <body>
+    <ul id="menu">
+      <li><a href="/thin/">home</a></li>
+      <li><a href="/thin/doc/">doc</a></li>
+      <li><a href="/thin/trac.fcgi/timeline">timeline</a></li>
+      <li><a href="/thin/trac.fcgi/browser">code</a></li>
+      <li><a href="/thin/trac.fcgi/report">tickets</a></li>
+      <li><a href="/thin/trac.fcgi/newticket">new ticket</a></li>
+    </ul>
+    <div id="sidebar">
+      <h2>Files</h2>
+      <ul class="list">
+        <li><a href="../files/README.html" value="File: README">README</a></li>
+        <li><a href="../files/lib/thin/cgi_rb.html" value="File: cgi.rb">lib/thin/cgi.rb</a></li>
+        <li><a href="../files/lib/thin/cluster_rb.html" value="File: cluster.rb">lib/thin/cluster.rb</a></li>
+        <li><a href="../files/lib/thin/command_rb.html" value="File: command.rb">lib/thin/command.rb</a></li>
+        <li><a href="../files/lib/thin/consts_rb.html" value="File: consts.rb">lib/thin/consts.rb</a></li>
+        <li><a href="../files/lib/thin/daemonizing_rb.html" value="File: daemonizing.rb">lib/thin/daemonizing.rb</a></li>
+        <li><a href="../files/lib/thin/handler_rb.html" value="File: handler.rb">lib/thin/handler.rb</a></li>
+        <li><a href="../files/lib/thin/headers_rb.html" value="File: headers.rb">lib/thin/headers.rb</a></li>
+        <li><a href="../files/lib/thin/logging_rb.html" value="File: logging.rb">lib/thin/logging.rb</a></li>
+        <li><a href="../files/lib/thin/mime_types_rb.html" value="File: mime_types.rb">lib/thin/mime_types.rb</a></li>
+        <li><a href="../files/lib/thin/rails_rb.html" value="File: rails.rb">lib/thin/rails.rb</a></li>
+        <li><a href="../files/lib/thin/recipes_rb.html" value="File: recipes.rb">lib/thin/recipes.rb</a></li>
+        <li><a href="../files/lib/thin/request_rb.html" value="File: request.rb">lib/thin/request.rb</a></li>
+        <li><a href="../files/lib/thin/response_rb.html" value="File: response.rb">lib/thin/response.rb</a></li>
+        <li><a href="../files/lib/thin/server_rb.html" value="File: server.rb">lib/thin/server.rb</a></li>
+        <li><a href="../files/lib/thin/statuses_rb.html" value="File: statuses.rb">lib/thin/statuses.rb</a></li>
+        <li><a href="../files/lib/thin/version_rb.html" value="File: version.rb">lib/thin/version.rb</a></li>
+        <li><a href="../files/bin/thin.html" value="File: thin">bin/thin</a></li>
+        <li><a href="../files/bin/thin_cluster.html" value="File: thin_cluster">bin/thin_cluster</a></li>
+      </ul>
+      <h2>Classes</h2>
+      <ul class="list">
+        <li><a href="../classes/Thin.html" title="Module: Thin">Thin</a></li>
+        <li><a href="../classes/Thin/Commands.html" title="Module: Thin::Commands">Thin::Commands</a></li>
+        <li><a href="../classes/Thin/Daemonizable.html" title="Module: Thin::Daemonizable">Thin::Daemonizable</a></li>
+        <li><a href="../classes/Thin/Daemonizable/ClassMethods.html" title="Module: Thin::Daemonizable::ClassMethods">Thin::Daemonizable::ClassMethods</a></li>
+        <li><a href="../classes/Thin/VERSION.html" title="Module: Thin::VERSION">Thin::VERSION</a></li>
+        <li><a href="../classes/Thin/Logging.html" title="Module: Thin::Logging">Thin::Logging</a></li>
+        <li><a href="../classes/Thin/DirHandler.html" title="Class: Thin::DirHandler">Thin::DirHandler</a></li>
+        <li><a href="../classes/Thin/InvalidRequest.html" title="Class: Thin::InvalidRequest">Thin::InvalidRequest</a></li>
+        <li><a href="../classes/Thin/CGIWrapper.html" title="Class: Thin::CGIWrapper">Thin::CGIWrapper</a></li>
+        <li><a href="../classes/Thin/Command.html" title="Class: Thin::Command">Thin::Command</a></li>
+        <li><a href="../classes/Thin/Response.html" title="Class: Thin::Response">Thin::Response</a></li>
+        <li><a href="../classes/Thin/Headers.html" title="Class: Thin::Headers">Thin::Headers</a></li>
+        <li><a href="../classes/Thin/Server.html" title="Class: Thin::Server">Thin::Server</a></li>
+        <li><a href="../classes/Thin/CommandError.html" title="Class: Thin::CommandError">Thin::CommandError</a></li>
+        <li><a href="../classes/Thin/Request.html" title="Class: Thin::Request">Thin::Request</a></li>
+        <li><a href="../classes/Thin/RailsServer.html" title="Class: Thin::RailsServer">Thin::RailsServer</a></li>
+        <li><a href="../classes/Thin/Cluster.html" title="Class: Thin::Cluster">Thin::Cluster</a></li>
+        <li><a href="../classes/Thin/RailsHandler.html" title="Class: Thin::RailsHandler">Thin::RailsHandler</a></li>
+        <li><a href="../classes/Thin/Handler.html" title="Class: Thin::Handler">Thin::Handler</a></li>
+        <li><a href="../classes/Process.html" title="Module: Process">Process</a></li>
+        <li><a href="../classes/Kernel.html" title="Module: Kernel">Kernel</a></li>
+      </ul>
+    </div>
+    <div id="container">
+      <div id="header">
+        <a href="/thin/" title="Home">
+          <img id="logo" src="../logo.gif" />
+        </a>
+        <h2 id="tag_line">A fast and very simple Ruby web server</h2>
+      </div>
+      <div id="content">
+        <h2>File: README</h2>
+  <div id="README" class="page_shade">
+<div class="page">
+<div class="header">
+  <div class="path">README / Mon Dec 03 23:24:17 -0500 2007</div>
+</div>
+<h2><a href="../classes/Thin.html">Thin</a></h2>
+<p>
+Tiny, fast &amp; funny HTTP server
+</p>
+<p>
+<a href="../classes/Thin.html">Thin</a> is a web server written entirely in
+Ruby in the simplest way possible. It does as little as possible to serve
+your Rails application, which makes it one of the fastest Rails server out
+there.
+</p>
+<h3>Installation</h3>
+<p>
+For the latest stable version:
+</p>
+<pre>
+ sudo gem install thin
+</pre>
+<p>
+For the risky but so much cooler alpha version:
+</p>
+<pre>
+ sudo gem install thin --source http://code.macournoyer.com
+</pre>
+<p>
+Or from source:
+</p>
+<pre>
+ svn co http://code.macournoyer.com/svn/thin/trunk thin
+ cd thin
+ rake install
+</pre>
+<h3>Usage</h3>
+<p>
+In your Rails app directory:
+</p>
+<pre>
+ thin start
+</pre>
+<p>
+See <a
+href="http://code.macournoyer.com/thin/doc/files/bin/thin.html">code.macournoyer.com/thin/doc/files/bin/thin.html</a>
+</p>
+<h3>Deployment</h3>
+<p>
+To deploy your Rails application using a cluster of thin servers. You can
+start it with:
+</p>
+<pre>
+ thin_cluster start
+</pre>
+<p>
+To use the Capistrano recipes, add this to your Capfile:
+</p>
+<pre>
+ require 'thin'
+ require 'thin/recipes'
+</pre>
+<p>
+and create a config file using:
+</p>
+<pre>
+ thin_cluster config
+</pre>
+<p>
+See <a
+href="http://code.macournoyer.com/thin/doc/files/bin/thin_cluster.html">code.macournoyer.com/thin/doc/files/bin/thin_cluster.html</a>
+</p>
+<h3>Security</h3>
+<p>
+<a href="../classes/Thin.html">Thin</a> should never be used facing the
+internet directly, it should always be hidden behind a proxy server!
+</p>
+<p>
+<a href="../classes/Thin.html">Thin</a> is faster because it doesn&#8216;t
+do a lot of things that other Ruby web servers do (use threads, validate
+the body length, be very strict about the request format, etc.) but that a
+good proxy server do very well (and a lot faster then any Ruby code could
+possibly do). So it is very important that you setup you proxy server
+correctly in order to secure <a href="../classes/Thin.html">Thin</a> from
+potential attacks.
+</p>
+<p>
+Nginx comes with everything you need and can be used securely out of the
+box with thin.
+</p>
+<p>
+Apache mod_proxy is not secure because it doesn&#8216;t cache the request
+before sending it to the backend, which open your server to easy DoS
+attacks. You need to install mod_accel (<a
+href="http://sysoev.ru/en">sysoev.ru/en</a>/) to make mod_proxy behave like
+Nginx on that side.
+</p>
+<h3>License</h3>
+<p>
+Ruby License, <a
+href="http://www.ruby-lang.org/en/LICENSE.txt">www.ruby-lang.org/en/LICENSE.txt</a>.
+</p>
+<h3>Credits</h3>
+<p>
+Lots of the code was inspired (or stolen entirely) from Mongrel <a
+href="http://mongrel.rubyforge.org">mongrel.rubyforge.org</a> by Zed Shaw.
+Mongrel Web Server (Mongrel) is copyrighted free software by Zed A. Shaw
+&lt;zedshaw at zedshaw dot com&gt; You can redistribute it and/or modify it
+under either the terms of the GPL.
+</p>
+<p>
+transat/parser.rb was taken from Piston source code. Copyright (c) 2006
+Francois Beausoleil &lt;francois@teksol.info&gt;
+</p>
+<p>
+<a href="../classes/Thin.html">Thin</a> is copyright Marc-Andre Cournoyer
+&lt;macournoyer@gmail.com&gt;
+</p>
+<p>
+Please report any bug at <a
+href="http://code.macournoyer.com/thin/trac.fcgi/newticket">code.macournoyer.com/thin/trac.fcgi/newticket</a>
+</p>
+</div>
+</div>
+      </div>
+    </div>
+    <div id="footer">
+      <hr />
+      &copy; <a href="http://macournoyer.com">Marc-Andr&eacute; Cournoyer</a>
+    </div>
+  </body>
+</html>