passenger 3.0.0 → 3.0.1

data/doc/cxxapi/Utils_8h_source.html

@@ -380,60 +380,77 @@
 <a name="l00355"></a>00355 <span class="comment"> * Convert a signal number to its associated name.</span>
 <a name="l00356"></a>00356 <span class="comment"> */</span>
 <a name="l00357"></a>00357 <span class="keywordtype">string</span> <a class="code" href="namespacePassenger.html#a979cb43cef743bf261c329b13e712366" title="Convert a signal number to its associated name.">getSignalName</a>(<span class="keywordtype">int</span> sig);
-<a name="l00358"></a>00358 
-<a name="l00359"></a>00359 <span class="comment"></span>
-<a name="l00360"></a>00360 <span class="comment">/**</span>
-<a name="l00361"></a>00361 <span class="comment"> * Represents a buffered upload file.</span>
-<a name="l00362"></a>00362 <span class="comment"> *</span>
-<a name="l00363"></a>00363 <span class="comment"> * @ingroup Support</span>
-<a name="l00364"></a>00364 <span class="comment"> */</span>
-<a name="l00365"></a><a class="code" href="classPassenger_1_1BufferedUpload.html">00365</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a> {
-<a name="l00366"></a>00366 <span class="keyword">public</span>:<span class="comment"></span>
-<a name="l00367"></a>00367 <span class="comment">        /** The file handle. */</span>
-<a name="l00368"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac">00368</a>         FILE *<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>;
-<a name="l00369"></a>00369         <span class="comment"></span>
-<a name="l00370"></a>00370 <span class="comment">        /**</span>
-<a name="l00371"></a>00371 <span class="comment">         * Create an empty upload bufer file, and open it for reading and writing.</span>
-<a name="l00372"></a>00372 <span class="comment">         *</span>
-<a name="l00373"></a>00373 <span class="comment">         * @throws SystemException Something went wrong.</span>
-<a name="l00374"></a>00374 <span class="comment">         */</span>
-<a name="l00375"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc">00375</a>         <a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc" title="Create an empty upload bufer file, and open it for reading and writing.">BufferedUpload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, <span class="keyword">const</span> <span class="keywordtype">char</span> *identifier = <span class="stringliteral">&quot;temp&quot;</span>) {
-<a name="l00376"></a>00376                 <span class="keywordtype">char</span> templ[PATH_MAX];
-<a name="l00377"></a>00377                 <span class="keywordtype">int</span> fd;
-<a name="l00378"></a>00378                 
-<a name="l00379"></a>00379                 snprintf(templ, <span class="keyword">sizeof</span>(templ), <span class="stringliteral">&quot;%s/%s.XXXXXX&quot;</span>, dir.c_str(), identifier);
-<a name="l00380"></a>00380                 templ[<span class="keyword">sizeof</span>(templ) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
-<a name="l00381"></a>00381                 fd = mkstemp(templ);
-<a name="l00382"></a>00382                 <span class="keywordflow">if</span> (fd == -1) {
-<a name="l00383"></a>00383                         <span class="keywordtype">char</span> message[1024];
-<a name="l00384"></a>00384                         <span class="keywordtype">int</span> e = errno;
-<a name="l00385"></a>00385                         
-<a name="l00386"></a>00386                         snprintf(message, <span class="keyword">sizeof</span>(message), <span class="stringliteral">&quot;Cannot create a temporary file &#39;%s&#39;&quot;</span>, templ);
-<a name="l00387"></a>00387                         message[<span class="keyword">sizeof</span>(message) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
-<a name="l00388"></a>00388                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(message, e);
-<a name="l00389"></a>00389                 }
-<a name="l00390"></a>00390                 
-<a name="l00391"></a>00391                 <span class="comment">/* We use a POSIX trick here: the file&#39;s permissions are set to &quot;u=,g=,o=&quot;</span>
-<a name="l00392"></a>00392 <span class="comment">                 * and the file is deleted immediately from the filesystem, while we</span>
-<a name="l00393"></a>00393 <span class="comment">                 * keep its file handle open. The result is that no other processes</span>
-<a name="l00394"></a>00394 <span class="comment">                 * will be able to access this file&#39;s contents anymore, except us.</span>
-<a name="l00395"></a>00395 <span class="comment">                 * We now have an anonymous disk-backed buffer.</span>
-<a name="l00396"></a>00396 <span class="comment">                 */</span>
-<a name="l00397"></a>00397                 fchmod(fd, 0000);
-<a name="l00398"></a>00398                 unlink(templ);
-<a name="l00399"></a>00399                 
-<a name="l00400"></a>00400                 <a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a> = fdopen(fd, <span class="stringliteral">&quot;w+&quot;</span>);
-<a name="l00401"></a>00401         }
-<a name="l00402"></a>00402         
-<a name="l00403"></a>00403         ~<a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a>() {
-<a name="l00404"></a>00404                 fclose(<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>);
-<a name="l00405"></a>00405         }
-<a name="l00406"></a>00406 };
-<a name="l00407"></a>00407 
-<a name="l00408"></a>00408 } <span class="comment">// namespace Passenger</span>
-<a name="l00409"></a>00409 
-<a name="l00410"></a>00410 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_UTILS_H_ */</span>
-<a name="l00411"></a>00411 
+<a name="l00358"></a>00358 <span class="comment"></span>
+<a name="l00359"></a>00359 <span class="comment">/**</span>
+<a name="l00360"></a>00360 <span class="comment"> * Resets the current process&#39;s signal handler disposition and signal mask</span>
+<a name="l00361"></a>00361 <span class="comment"> * to default values. One should call this every time one forks a child process;</span>
+<a name="l00362"></a>00362 <span class="comment"> * non-default signal masks/handler dispositions can cause all kinds of weird quirks,</span>
+<a name="l00363"></a>00363 <span class="comment"> * like waitpid() malfunctioning on OS X.</span>
+<a name="l00364"></a>00364 <span class="comment"> *</span>
+<a name="l00365"></a>00365 <span class="comment"> * This function is async-signal safe.</span>
+<a name="l00366"></a>00366 <span class="comment"> */</span>
+<a name="l00367"></a>00367 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#a2029ad8cb57611ab161b20ef9df39c86" title="Resets the current process&amp;#39;s signal handler disposition and signal mask to default...">resetSignalHandlersAndMask</a>();
+<a name="l00368"></a>00368 <span class="comment"></span>
+<a name="l00369"></a>00369 <span class="comment">/**</span>
+<a name="l00370"></a>00370 <span class="comment"> * Close all file descriptors that are higher than &lt;em&gt;lastToKeepOpen&lt;/em&gt;.</span>
+<a name="l00371"></a>00371 <span class="comment"> * This function is async-signal safe. But make sure there are no other</span>
+<a name="l00372"></a>00372 <span class="comment"> * threads running that might open file descriptors!</span>
+<a name="l00373"></a>00373 <span class="comment"> */</span>
+<a name="l00374"></a>00374 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#af116b11276c90901729b6ce541dd2a07" title="Close all file descriptors that are higher than lastToKeepOpen.">closeAllFileDescriptors</a>(<span class="keywordtype">int</span> lastToKeepOpen);
+<a name="l00375"></a>00375 
+<a name="l00376"></a>00376 <span class="comment"></span>
+<a name="l00377"></a>00377 <span class="comment">/**</span>
+<a name="l00378"></a>00378 <span class="comment"> * Represents a buffered upload file.</span>
+<a name="l00379"></a>00379 <span class="comment"> *</span>
+<a name="l00380"></a>00380 <span class="comment"> * @ingroup Support</span>
+<a name="l00381"></a>00381 <span class="comment"> */</span>
+<a name="l00382"></a><a class="code" href="classPassenger_1_1BufferedUpload.html">00382</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a> {
+<a name="l00383"></a>00383 <span class="keyword">public</span>:<span class="comment"></span>
+<a name="l00384"></a>00384 <span class="comment">        /** The file handle. */</span>
+<a name="l00385"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac">00385</a>         FILE *<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>;
+<a name="l00386"></a>00386         <span class="comment"></span>
+<a name="l00387"></a>00387 <span class="comment">        /**</span>
+<a name="l00388"></a>00388 <span class="comment">         * Create an empty upload bufer file, and open it for reading and writing.</span>
+<a name="l00389"></a>00389 <span class="comment">         *</span>
+<a name="l00390"></a>00390 <span class="comment">         * @throws SystemException Something went wrong.</span>
+<a name="l00391"></a>00391 <span class="comment">         */</span>
+<a name="l00392"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc">00392</a>         <a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc" title="Create an empty upload bufer file, and open it for reading and writing.">BufferedUpload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, <span class="keyword">const</span> <span class="keywordtype">char</span> *identifier = <span class="stringliteral">&quot;temp&quot;</span>) {
+<a name="l00393"></a>00393                 <span class="keywordtype">char</span> templ[PATH_MAX];
+<a name="l00394"></a>00394                 <span class="keywordtype">int</span> fd;
+<a name="l00395"></a>00395                 
+<a name="l00396"></a>00396                 snprintf(templ, <span class="keyword">sizeof</span>(templ), <span class="stringliteral">&quot;%s/%s.XXXXXX&quot;</span>, dir.c_str(), identifier);
+<a name="l00397"></a>00397                 templ[<span class="keyword">sizeof</span>(templ) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
+<a name="l00398"></a>00398                 fd = mkstemp(templ);
+<a name="l00399"></a>00399                 <span class="keywordflow">if</span> (fd == -1) {
+<a name="l00400"></a>00400                         <span class="keywordtype">char</span> message[1024];
+<a name="l00401"></a>00401                         <span class="keywordtype">int</span> e = errno;
+<a name="l00402"></a>00402                         
+<a name="l00403"></a>00403                         snprintf(message, <span class="keyword">sizeof</span>(message), <span class="stringliteral">&quot;Cannot create a temporary file &#39;%s&#39;&quot;</span>, templ);
+<a name="l00404"></a>00404                         message[<span class="keyword">sizeof</span>(message) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
+<a name="l00405"></a>00405                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(message, e);
+<a name="l00406"></a>00406                 }
+<a name="l00407"></a>00407                 
+<a name="l00408"></a>00408                 <span class="comment">/* We use a POSIX trick here: the file&#39;s permissions are set to &quot;u=,g=,o=&quot;</span>
+<a name="l00409"></a>00409 <span class="comment">                 * and the file is deleted immediately from the filesystem, while we</span>
+<a name="l00410"></a>00410 <span class="comment">                 * keep its file handle open. The result is that no other processes</span>
+<a name="l00411"></a>00411 <span class="comment">                 * will be able to access this file&#39;s contents anymore, except us.</span>
+<a name="l00412"></a>00412 <span class="comment">                 * We now have an anonymous disk-backed buffer.</span>
+<a name="l00413"></a>00413 <span class="comment">                 */</span>
+<a name="l00414"></a>00414                 fchmod(fd, 0000);
+<a name="l00415"></a>00415                 unlink(templ);
+<a name="l00416"></a>00416                 
+<a name="l00417"></a>00417                 <a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a> = fdopen(fd, <span class="stringliteral">&quot;w+&quot;</span>);
+<a name="l00418"></a>00418         }
+<a name="l00419"></a>00419         
+<a name="l00420"></a>00420         ~<a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a>() {
+<a name="l00421"></a>00421                 fclose(<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>);
+<a name="l00422"></a>00422         }
+<a name="l00423"></a>00423 };
+<a name="l00424"></a>00424 
+<a name="l00425"></a>00425 } <span class="comment">// namespace Passenger</span>
+<a name="l00426"></a>00426 
+<a name="l00427"></a>00427 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_UTILS_H_ */</span>
+<a name="l00428"></a>00428 
 </pre></div></div>
 <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
 <a href="http://www.doxygen.org/index.html">

data/doc/cxxapi/annotated.html

@@ -46,6 +46,7 @@
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1EventedServer.html">Passenger::EventedServer</a></td><td class="indexvalue">A base class for writing single-threaded, evented servers that use non-blocking I/O </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1EventFd.html">Passenger::EventFd</a></td><td class="indexvalue">A synchronization mechanism that's implemented with file descriptors, and as such can be used in combination with select() and friends </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td class="indexvalue">Wrapper class around a file descriptor integer, for RAII behavior </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classPassenger_1_1FileDescriptorPair.html">Passenger::FileDescriptorPair</a></td><td class="indexvalue">A structure containing two <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> objects </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1FileNotFoundException.html">Passenger::FileNotFoundException</a></td><td class="indexvalue">Thrown when a certain file cannot be found </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1FileSystemException.html">Passenger::FileSystemException</a></td><td class="indexvalue">A filesystem error, as returned by the operating system </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1MessageServer_1_1Handler.html">Passenger::MessageServer::Handler</a></td><td class="indexvalue">An abstract message handler class </td></tr>
@@ -58,7 +59,9 @@
   <tr><td class="indexkey"><a class="el" href="structPassenger_1_1PoolOptions.html">Passenger::PoolOptions</a></td><td class="indexvalue">This struct encapsulates information for ApplicationPool::get() and for <a class="el" href="classPassenger_1_1SpawnManager.html#a88a94ba4d41dab492cb1dc8a0f998973" title="Spawn a new application process.">SpawnManager::spawn()</a>, such as which application is to be spawned </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td class="indexvalue">Represents a single application process, as spawned by <a class="el" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a> or by ApplicationPool::Interface::get() </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1RandomGenerator.html">Passenger::RandomGenerator</a></td><td class="indexvalue">A random data generator </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classPassenger_1_1ResourceLocator.html">Passenger::ResourceLocator</a></td><td class="indexvalue">Locates various Phusion <a class="el" href="namespacePassenger.html" title="Common code for all agents.">Passenger</a> resources on the filesystem </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1RuntimeException.html">Passenger::RuntimeException</a></td><td class="indexvalue">A generic runtime exception </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classPassenger_1_1SafeLibev.html">Passenger::SafeLibev</a></td><td class="indexvalue">Class for thread-safely using libev </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1ScalarMessage.html">Passenger::ScalarMessage</a></td><td class="indexvalue">Class for reading a scalar message </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1ScgiRequestParser.html">Passenger::ScgiRequestParser</a></td><td class="indexvalue">A parser for SCGI requests </td></tr>
   <tr><td class="indexkey"><a class="el" href="classPassenger_1_1SecurityException.html">Passenger::SecurityException</a></td><td class="indexvalue">Represents some kind of security error </td></tr>

data/doc/cxxapi/classAgentWatcher.html

@@ -52,7 +52,7 @@
 string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classAgentWatcher.html#a80ef9eaf1a84d994e7ba5f1507616fde">getErrorBacktrace</a> () const </td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The error backtrace, if applicable. <br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classPassenger_1_1FileDescriptor.html">FileDescriptor</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classAgentWatcher.html#ac0749ab103ed5d1adc81b53a7ddc93d8">getFeedbackFd</a> () const </td></tr>
-<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the agent process feedback fd, or NULL if the agent process hasn't been started yet.  <a href="#ac0749ab103ed5d1adc81b53a7ddc93d8"></a><br/></td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the agent process feedback fd, or -1 if the agent process hasn't been started yet.  <a href="#ac0749ab103ed5d1adc81b53a7ddc93d8"></a><br/></td></tr>
 <tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">virtual string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classAgentWatcher.html#a77279925d786a774bdf097468c36af96">getExeFilename</a> () const =0</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the filename of the agent process's executable.  <a href="#a77279925d786a774bdf097468c36af96"></a><br/></td></tr>
@@ -177,7 +177,7 @@ boost::mutex&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" hr
 </div>
 <div class="memdoc">
 
-<p>Returns the agent process feedback fd, or NULL if the agent process hasn't been started yet. </p>
+<p>Returns the agent process feedback fd, or -1 if the agent process hasn't been started yet. </p>
 <p>Can be used to check whether this agent process has exited without using waitpid(). </p>
 
 </div>

data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html

@@ -32,7 +32,6 @@
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#aba438d86ca263972a47540956bf11ec1">getApplicationType</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#ac46f0e74ffd05b7fe9924dd99a057cf7">getApplicationTypeString</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821">getBaseURI</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
-  <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#af5091e3cef3878e160e5d3b2181d82fb">getEnvironment</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1DirectoryMapper.html#aef969f27622fb215990a870076648aa1">getPublicDirectory</a>()</td><td><a class="el" href="classPassenger_1_1DirectoryMapper.html">Passenger::DirectoryMapper</a></td><td><code> [inline]</code></td></tr>
 </table></div>
 <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;

data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html

@@ -51,8 +51,6 @@
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the application type that's associated with the HTTP request.  <a href="#aba438d86ca263972a47540956bf11ec1"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1DirectoryMapper.html#ac46f0e74ffd05b7fe9924dd99a057cf7">getApplicationTypeString</a> ()</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the application type (as a string) that's associated with the HTTP request.  <a href="#ac46f0e74ffd05b7fe9924dd99a057cf7"></a><br/></td></tr>
-<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1DirectoryMapper.html#af5091e3cef3878e160e5d3b2181d82fb">getEnvironment</a> ()</td></tr>
-<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the environment under which the application should be spawned.  <a href="#af5091e3cef3878e160e5d3b2181d82fb"></a><br/></td></tr>
 </table>
 <hr/><a name="_details"></a><h2>Detailed Description</h2>
 <p>Utility class for determining URI-to-application directory mappings. </p>
@@ -186,31 +184,6 @@
 </dl>
 <dl class="warning"><dt><b>Warning:</b></dt><dd>The return value may only be used as long as <code>config</code> hasn't been destroyed. </dd></dl>
 
-</div>
-</div>
-<a class="anchor" id="af5091e3cef3878e160e5d3b2181d82fb"></a><!-- doxytag: member="Passenger::DirectoryMapper::getEnvironment" ref="af5091e3cef3878e160e5d3b2181d82fb" args="()" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">const char* Passenger::DirectoryMapper::getEnvironment </td>
-          <td>(</td>
-          <td class="paramname"></td>
-          <td>&nbsp;)&nbsp;</td>
-          <td><code> [inline]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>Returns the environment under which the application should be spawned. </p>
-<dl><dt><b>Exceptions:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a></em>&nbsp;</td><td>An error occured while examening the filesystem. </td></tr>
-  </table>
-  </dd>
-</dl>
-
 </div>
 </div>
 <a class="anchor" id="aef969f27622fb215990a870076648aa1"></a><!-- doxytag: member="Passenger::DirectoryMapper::getPublicDirectory" ref="aef969f27622fb215990a870076648aa1" args="()" -->

data/doc/cxxapi/classPassenger_1_1EventedClient-members.html

@@ -28,8 +28,11 @@
 </div>
 <div class="contents">
 <h1>Passenger::EventedClient Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a>, including all inherited members.<table>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a9161e34ddc473c00fe4df8fdb1d1baef">closeWrite</a>()</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a408b593d118c3483bcef8118a7edba0f">detach</a>()</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a5b1a3011165ea9a47f6fe668a5010a20">disconnect</a>(bool force=false)</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a931edf284fed32f74ebf9dc35d993f17a627c2190c3a4dc848dc1a332ef9f5105">DISCONNECT_FULL</a> enum value</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a931edf284fed32f74ebf9dc35d993f17a232760bee5b535fd40e609ff8c088693">DISCONNECT_WRITE</a> enum value</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#ac3c45bfa7ac30b6d59ef08dc296f3c4e">EventedClient</a>(struct ev_loop *loop, const FileDescriptor &amp;_fd)</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a4473719c16cae760e1811b7ccb1dc491">fd</a></td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a50436eb8ec0cc38b5a7278962e98a22c">ioAllowed</a>() const </td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
@@ -46,6 +49,8 @@
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a1e480f15dfd339ff781f8daedc5b8190">unref</a>()</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#a793c843b7ba01cc1bb2c568c6539b9e0">userData</a></td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#aa07723456786b9f18b973bd88ff51e27">write</a>(const StaticString data[], unsigned int count)</td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#aca719fb03ade09839827a16caa0e6e30">writeAllowed</a>() const </td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1EventedClient.html#afc0934988a978a25538b7d8f2566c90a">writeErrorAction</a></td><td><a class="el" href="classPassenger_1_1EventedClient.html">Passenger::EventedClient</a></td><td></td></tr>
 </table></div>
 <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
 <a href="http://www.doxygen.org/index.html">

data/doc/cxxapi/classPassenger_1_1EventedClient.html

@@ -39,6 +39,12 @@
 
 <p><a href="classPassenger_1_1EventedClient-members.html">List of all members.</a></p>
 <table border="0" cellpadding="0" cellspacing="0">
+<tr><td colspan="2"><h2>Public Types</h2></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom">{ <a class="el" href="classPassenger_1_1EventedClient.html#a931edf284fed32f74ebf9dc35d993f17a627c2190c3a4dc848dc1a332ef9f5105">DISCONNECT_FULL</a>, 
+<a class="el" href="classPassenger_1_1EventedClient.html#a931edf284fed32f74ebf9dc35d993f17a232760bee5b535fd40e609ff8c088693">DISCONNECT_WRITE</a>
+ }</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><p>Controls what to do when a write error is encountered. </p>
+ <a href="classPassenger_1_1EventedClient.html#a931edf284fed32f74ebf9dc35d993f17">More...</a><br/></td></tr>
 <tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#ac3c45bfa7ac30b6d59ef08dc296f3c4e">EventedClient</a> (struct ev_loop *loop, const <a class="el" href="classPassenger_1_1FileDescriptor.html">FileDescriptor</a> &amp;_fd)</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates a new <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> with the given libev loop and file descriptor.  <a href="#ac3c45bfa7ac30b6d59ef08dc296f3c4e"></a><br/></td></tr>
@@ -48,7 +54,9 @@ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="clas
 <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a1e480f15dfd339ff781f8daedc5b8190">unref</a> ()</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Decrease reference count.  <a href="#a1e480f15dfd339ff781f8daedc5b8190"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a50436eb8ec0cc38b5a7278962e98a22c">ioAllowed</a> () const </td></tr>
-<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns whether it is allowed to perform any I/O with this client.  <a href="#a50436eb8ec0cc38b5a7278962e98a22c"></a><br/></td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns whether it is allowed to perform some kind of I/O with this client, either reading or writing.  <a href="#a50436eb8ec0cc38b5a7278962e98a22c"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#aca719fb03ade09839827a16caa0e6e30">writeAllowed</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns whether it is allowed to write data to the client.  <a href="#aca719fb03ade09839827a16caa0e6e30"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a129f6d6a6123c9af1999eca4ae04a75a">readWatcherActive</a> () const </td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Used by unit tests.  <a href="#a129f6d6a6123c9af1999eca4ae04a75a"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">size_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a0a032e54979b074641ffda807648a6e2">pendingWrites</a> () const </td></tr>
@@ -59,6 +67,8 @@ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="clas
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets a limit on the client outbox.  <a href="#ac1eb48c0d5382a97facbf9af40924849"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#aa07723456786b9f18b973bd88ff51e27">write</a> (const <a class="el" href="classPassenger_1_1StaticString.html">StaticString</a> data[], unsigned int count)</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sends data to this client.  <a href="#aa07723456786b9f18b973bd88ff51e27"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a9161e34ddc473c00fe4df8fdb1d1baef">closeWrite</a> ()</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Close only the writer side of the client connection.  <a href="#a9161e34ddc473c00fe4df8fdb1d1baef"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a5b1a3011165ea9a47f6fe668a5010a20">disconnect</a> (bool force=false)</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Disconnects the client.  <a href="#a5b1a3011165ea9a47f6fe668a5010a20"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPassenger_1_1FileDescriptor.html">FileDescriptor</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a408b593d118c3483bcef8118a7edba0f">detach</a> ()</td></tr>
@@ -66,6 +76,9 @@ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="clas
 <tr><td colspan="2"><h2>Public Attributes</h2></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classPassenger_1_1FileDescriptor.html">FileDescriptor</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a4473719c16cae760e1811b7ccb1dc491">fd</a></td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The client's file descriptor.  <a href="#a4473719c16cae760e1811b7ccb1dc491"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">enum <br class="typebreak"/>
+Passenger::EventedClient:: { ... } &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#afc0934988a978a25538b7d8f2566c90a">writeErrorAction</a></td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Controls what to do when a write error is encountered.  <a href="#afc0934988a978a25538b7d8f2566c90a"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">Callback&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a155988f311fba920bef3031f3d9b6f6a">onReadable</a></td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Called when the file descriptor becomes readable and read notifications are enabled (see <code>notifyRead()</code>).  <a href="#a155988f311fba920bef3031f3d9b6f6a"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">Callback&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1EventedClient.html#a211210ecd85eb2da47d200215132bb2d">onDisconnect</a></td></tr>
@@ -105,6 +118,32 @@ SystemErrorCallback&nbsp;</td><td class="memItemRight" valign="bottom"><a class=
  client-&gt;notifyReads(<span class="keyword">true</span>);
 </pre></div><h2>Error handling</h2>
 <p><a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> never raises exceptions, except when your callbacks do. It reports errors with the <code>onSystemError</code> callback. That said, <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> is exception-aware and will ensure that its internal state stays consistent even when your callbacks throw exceptions. </p>
+<hr/><h2>Member Enumeration Documentation</h2>
+<a class="anchor" id="a931edf284fed32f74ebf9dc35d993f17"></a><!-- doxytag: member="Passenger::EventedClient::@1" ref="a931edf284fed32f74ebf9dc35d993f17" args="" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">anonymous enum</td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Controls what to do when a write error is encountered. </p>
+<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
+<tr><td valign="top"><em><a class="anchor" id="a931edf284fed32f74ebf9dc35d993f17a627c2190c3a4dc848dc1a332ef9f5105"></a><!-- doxytag: member="DISCONNECT_FULL" ref="a931edf284fed32f74ebf9dc35d993f17a627c2190c3a4dc848dc1a332ef9f5105" args="" -->DISCONNECT_FULL</em>&nbsp;</td><td>
+<p>Forcefully disconnect the client. </p>
+</td></tr>
+<tr><td valign="top"><em><a class="anchor" id="a931edf284fed32f74ebf9dc35d993f17a232760bee5b535fd40e609ff8c088693"></a><!-- doxytag: member="DISCONNECT_WRITE" ref="a931edf284fed32f74ebf9dc35d993f17a232760bee5b535fd40e609ff8c088693" args="" -->DISCONNECT_WRITE</em>&nbsp;</td><td>
+<p>Close the writer side of the connection, but continue allowing reading. </p>
+</td></tr>
+</table>
+</dd>
+</dl>
+
+</div>
+</div>
 <hr/><h2>Constructor &amp; Destructor Documentation</h2>
 <a class="anchor" id="ac3c45bfa7ac30b6d59ef08dc296f3c4e"></a><!-- doxytag: member="Passenger::EventedClient::EventedClient" ref="ac3c45bfa7ac30b6d59ef08dc296f3c4e" args="(struct ev_loop *loop, const FileDescriptor &amp;_fd)" -->
 <div class="memitem">
@@ -137,6 +176,27 @@ SystemErrorCallback&nbsp;</td><td class="memItemRight" valign="bottom"><a class=
 </div>
 </div>
 <hr/><h2>Member Function Documentation</h2>
+<a class="anchor" id="a9161e34ddc473c00fe4df8fdb1d1baef"></a><!-- doxytag: member="Passenger::EventedClient::closeWrite" ref="a9161e34ddc473c00fe4df8fdb1d1baef" args="()" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void Passenger::EventedClient::closeWrite </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Close only the writer side of the client connection. </p>
+<p>After calling this method, subsequent write() calls won't do anything anymore. Any pending outgoing data will be sent out whenever the opportunity arises.</p>
+<p>This function does nothing if the client is being disconnected, already disconnected or if only the writer side is closed. </p>
+
+</div>
+</div>
 <a class="anchor" id="a408b593d118c3483bcef8118a7edba0f"></a><!-- doxytag: member="Passenger::EventedClient::detach" ref="a408b593d118c3483bcef8118a7edba0f" args="()" -->
 <div class="memitem">
 <div class="memproto">
@@ -153,7 +213,7 @@ SystemErrorCallback&nbsp;</td><td class="memItemRight" valign="bottom"><a class=
 <div class="memdoc">
 
 <p>Detaches the client file descriptor so that this <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> no longer has any control over it. </p>
-<p>Any <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> I/O watchers on the client file descriptor will be stopped and further I/O on the file descriptor via <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> will become impossible. The original client file descriptor is returned and <code>onDetach</code> is called. Subsequent calls to this function will return -1 and will no longer call <code>onDetach</code>.</p>
+<p>Any <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> I/O watchers on the client file descriptor will be stopped and further I/O on the file descriptor via <a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> will become impossible. Any pending outgoing data will be discarded. The original client file descriptor is returned and <code>onDetach</code> is called. Subsequent calls to this function will return -1 and will no longer call <code>onDetach</code>.</p>
 <dl class="post"><dt><b>Postcondition:</b></dt><dd>!ioAllowed() </dd>
 <dd>
 fd == -1 </dd></dl>
@@ -200,8 +260,8 @@ fd == -1 </dd></dl>
 </div>
 <div class="memdoc">
 
-<p>Returns whether it is allowed to perform any I/O with this client. </p>
-<p>Usually true, and false when the client is either being disconnected or has been disconnected. A return value of false indicates that <code>fd</code> might be -1, but even when it isn't -1 you shouldn't access <code>fd</code> anymore. </p>
+<p>Returns whether it is allowed to perform some kind of I/O with this client, either reading or writing. </p>
+<p>Usually true, and false when the client is either being disconnected or has been disconnected. A return value of false indicates that <code>fd</code> might be -1, but even when it isn't -1 you shouldn't access <code>fd</code> anymore. When the connection is half-closed (e.g. after <a class="el" href="classPassenger_1_1EventedClient.html#a9161e34ddc473c00fe4df8fdb1d1baef" title="Close only the writer side of the client connection.">closeWrite()</a> has been called) the return value is still be true. Only when I/O of any kind is disallowed will this function return false. </p>
 
 </div>
 </div>
@@ -337,10 +397,30 @@ fd == -1 </dd></dl>
 
 <p>Sends data to this client. </p>
 <p>This method will try to send the data immediately (in which no intermediate copies of the data will be made), but if the client is not yet ready to receive data (e.g. because of network congestion) then the data will be buffered and scheduled for sending later.</p>
-<p>If an I/O error was encountered then the client connection will be closed by calling <code>disconnect(true)</code>. This means this method could potentially call the <code>onDisconnect</code> callback.</p>
-<p>If the client connection is already being closed or has already been closed then this method does nothing.</p>
+<p>If an I/O error was encountered then the action taken depends on the value of <em>writeActionError</em>. By default it is DISCONNECT_FULL, meaning the client connection will be closed by calling <code>disconnect(true)</code>. This means this method could potentially call the <code>onDisconnect</code> callback.</p>
+<p>If the client connection is already being closed, has already been closed or if the writer side is closed, then this method does nothing.</p>
 <p>The <code>onPendingDataFlushed</code> callback will be called after this data and whatever existing pending data have been written out. That may either be immediately or after a short period of of time. </p>
 
+</div>
+</div>
+<a class="anchor" id="aca719fb03ade09839827a16caa0e6e30"></a><!-- doxytag: member="Passenger::EventedClient::writeAllowed" ref="aca719fb03ade09839827a16caa0e6e30" args="() const " -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">bool Passenger::EventedClient::writeAllowed </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td> const<code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Returns whether it is allowed to write data to the client. </p>
+<p>Usually true, and false when the client is either being disconnected or has been disconnected or when the writer side of the client connection has been closed. write() will do nothing if this function returns false. </p>
+
 </div>
 </div>
 <hr/><h2>Member Data Documentation</h2>
@@ -356,7 +436,7 @@ fd == -1 </dd></dl>
 <div class="memdoc">
 
 <p>The client's file descriptor. </p>
-<p>Could be -1: see <code><a class="el" href="classPassenger_1_1EventedClient.html#a50436eb8ec0cc38b5a7278962e98a22c" title="Returns whether it is allowed to perform any I/O with this client.">ioAllowed()</a></code>. </p>
+<p>Could be -1: see <code><a class="el" href="classPassenger_1_1EventedClient.html#a50436eb8ec0cc38b5a7278962e98a22c" title="Returns whether it is allowed to perform some kind of I/O with this client, either...">ioAllowed()</a></code>. </p>
 
 </div>
 </div>
@@ -423,6 +503,21 @@ fd == -1 </dd></dl>
 <p><a class="el" href="classPassenger_1_1EventedClient.html" title="A utility class for making I/O handling in non-blocking libev evented servers much...">EventedClient</a> doesn't do anything with this. </p>
 <p>Set it to whatever you want. </p>
 
+</div>
+</div>
+<a class="anchor" id="afc0934988a978a25538b7d8f2566c90a"></a><!-- doxytag: member="Passenger::EventedClient::writeErrorAction" ref="afc0934988a978a25538b7d8f2566c90a" args="" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">enum { ... }   <a class="el" href="classPassenger_1_1EventedClient.html#afc0934988a978a25538b7d8f2566c90a">Passenger::EventedClient::writeErrorAction</a></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Controls what to do when a write error is encountered. </p>
+
 </div>
 </div>
 <hr/>The documentation for this class was generated from the following file:<ul>

data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html

@@ -28,7 +28,8 @@
 </div>
 <div class="contents">
 <h1>Passenger::FileDescriptor Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a>, including all inherited members.<table>
-  <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432">close</a>()</td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b">close</a>(bool checkErrors=true)</td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#ad9f7acde3003ab0730bc248948a63777">detach</a>()</td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#a05d83ad9cc77c493a3ce4f2b51d44559">FileDescriptor</a>()</td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#a62c05b925cb1cf964169cef7635650ee">FileDescriptor</a>(int fd)</td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classPassenger_1_1FileDescriptor.html#ac335c2a97f3a6c8e3920f573b0d04081">operator int</a>() const </td><td><a class="el" href="classPassenger_1_1FileDescriptor.html">Passenger::FileDescriptor</a></td><td><code> [inline]</code></td></tr>

data/doc/cxxapi/classPassenger_1_1FileDescriptor.html

@@ -42,15 +42,17 @@
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates a new empty <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> instance that has no underlying file descriptor.  <a href="#a05d83ad9cc77c493a3ce4f2b51d44559"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1FileDescriptor.html#a62c05b925cb1cf964169cef7635650ee">FileDescriptor</a> (int fd)</td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates a new <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> instance with the given fd as a handle.  <a href="#a62c05b925cb1cf964169cef7635650ee"></a><br/></td></tr>
-<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432">close</a> ()</td></tr>
-<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Close the underlying file descriptor.  <a href="#ad7c1a99531181878cbab74a7400c5432"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b">close</a> (bool checkErrors=true)</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Close the underlying file descriptor.  <a href="#a02062f3cfb689b32781e11114c0abe5b"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1FileDescriptor.html#ad9f7acde3003ab0730bc248948a63777">detach</a> ()</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Detach from the underlying file descriptor without closing it.  <a href="#ad9f7acde3003ab0730bc248948a63777"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1FileDescriptor.html#ac335c2a97f3a6c8e3920f573b0d04081">operator int</a> () const </td></tr>
 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Overloads the integer cast operator so that it will return the underlying file descriptor handle as an integer.  <a href="#ac335c2a97f3a6c8e3920f573b0d04081"></a><br/></td></tr>
 </table>
 <hr/><a name="_details"></a><h2>Detailed Description</h2>
 <p>Wrapper class around a file descriptor integer, for RAII behavior. </p>
-<p>A <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> object behaves just like an int, so that you can pass it to system calls such as read(). It performs reference counting. When the last copy of a <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> has been destroyed, the underlying file descriptor will be automatically closed. In this case, any <a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">close()</a> system call errors are silently ignored. If you are interested in whether the <a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">close()</a> system call succeeded, then you should call <a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">FileDescriptor::close()</a>.</p>
-<p>This class is *not* thread-safe. It is safe to call system calls on the underlying file descriptor from multiple threads, but it's not safe to call <a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">FileDescriptor::close()</a> from multiple threads if all those <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> objects point to the same underlying file descriptor. </p>
+<p>A <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> object behaves just like an int, so that you can pass it to system calls such as read(). It performs reference counting. When the last copy of a <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> has been destroyed, the underlying file descriptor will be automatically closed. In this case, any <a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close()</a> system call errors are silently ignored. If you are interested in whether the <a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close()</a> system call succeeded, then you should call <a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">FileDescriptor::close()</a>.</p>
+<p>This class is *not* thread-safe. It is safe to call system calls on the underlying file descriptor from multiple threads, but it's not safe to call <a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">FileDescriptor::close()</a> from multiple threads if all those <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> objects point to the same underlying file descriptor. </p>
 <hr/><h2>Constructor &amp; Destructor Documentation</h2>
 <a class="anchor" id="a05d83ad9cc77c493a3ce4f2b51d44559"></a><!-- doxytag: member="Passenger::FileDescriptor::FileDescriptor" ref="a05d83ad9cc77c493a3ce4f2b51d44559" args="()" -->
 <div class="memitem">
@@ -94,14 +96,15 @@
 </div>
 </div>
 <hr/><h2>Member Function Documentation</h2>
-<a class="anchor" id="ad7c1a99531181878cbab74a7400c5432"></a><!-- doxytag: member="Passenger::FileDescriptor::close" ref="ad7c1a99531181878cbab74a7400c5432" args="()" -->
+<a class="anchor" id="a02062f3cfb689b32781e11114c0abe5b"></a><!-- doxytag: member="Passenger::FileDescriptor::close" ref="a02062f3cfb689b32781e11114c0abe5b" args="(bool checkErrors=true)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
           <td class="memname">void Passenger::FileDescriptor::close </td>
           <td>(</td>
-          <td class="paramname"></td>
+          <td class="paramtype">bool&nbsp;</td>
+          <td class="paramname"> <em>checkErrors</em> = <code>true</code></td>
           <td>&nbsp;)&nbsp;</td>
           <td><code> [inline]</code></td>
         </tr>
@@ -111,14 +114,37 @@
 
 <p>Close the underlying file descriptor. </p>
 <p>If it was already closed, then nothing will happen. If there are multiple copies of this <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> then the underlying file descriptor will be closed for every one of them.</p>
+<p>checkErrors Whether a <a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> should be thrown in case closing the file descriptor fails. If false, errors are silently ignored. </p>
 <dl><dt><b>Exceptions:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Something went wrong while closing the file descriptor. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Something went wrong while closing the file descriptor. Only thrown if checkErrors is true. </td></tr>
   </table>
   </dd>
 </dl>
 <dl class="post"><dt><b>Postcondition:</b></dt><dd>*this == -1 </dd></dl>
 
+</div>
+</div>
+<a class="anchor" id="ad9f7acde3003ab0730bc248948a63777"></a><!-- doxytag: member="Passenger::FileDescriptor::detach" ref="ad9f7acde3003ab0730bc248948a63777" args="()" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int Passenger::FileDescriptor::detach </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Detach from the underlying file descriptor without closing it. </p>
+<p>This <a class="el" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> and all copies will no longer affect the underlying file descriptors.</p>
+<dl class="return"><dt><b>Returns:</b></dt><dd>The underlying file descriptor, or -1 if already closed. </dd></dl>
+<dl class="post"><dt><b>Postcondition:</b></dt><dd>*this == -1 </dd></dl>
+
 </div>
 </div>
 <a class="anchor" id="ac335c2a97f3a6c8e3920f573b0d04081"></a><!-- doxytag: member="Passenger::FileDescriptor::operator int" ref="ac335c2a97f3a6c8e3920f573b0d04081" args="() const " -->
@@ -137,7 +163,7 @@
 <div class="memdoc">
 
 <p>Overloads the integer cast operator so that it will return the underlying file descriptor handle as an integer. </p>
-<p>Returns -1 if <a class="el" href="classPassenger_1_1FileDescriptor.html#ad7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">FileDescriptor::close()</a> was called. </p>
+<p>Returns -1 if <a class="el" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">FileDescriptor::close()</a> was called. </p>
 
 </div>
 </div>