passenger 2.1.2 → 2.1.3

data/doc/Users guide.txt

@@ -235,6 +235,12 @@ Next, add a <<RailsBaseURI,RailsBaseURI>> option to the virtual host configurati
 -------------------------------------------
 Then restart Apache. The application has now been deployed.
 
+NOTE: If you're deploying to a sub-URI then please make sure that your view
+templates correctly handles references to sub-URI static assets! Otherwise
+you may find broken links to images, CSS files, JavaScripts, etc. Please read
+<<sub_uri_deployment_uri_fix,How to fix broken images/CSS/JavaScript URIs in sub-URI deployments>>
+for more information.
+
 [TIP]
 ======================================
 You can deploy multiple Rails applications under a virtual host, by specifying
@@ -1887,6 +1893,49 @@ then Rails will automatically reload your application code after each request.
 or when you're not developing a Rails application and your web framework
 does not support code reloading.
 
+[[sub_uri_deployment_uri_fix]]
+=== How to fix broken images/CSS/JavaScript URIs in sub-URI deployments
+
+Some people experience broken images and other broken static assets when they
+deploy their application to a sub-URI (i.e. 'http://mysite.com/railsapp/').
+The reason for this usually is that you used a
+static URI for your image in the views. This means your 'img' source probably refers
+to something like '/images/foo.jpg'. The leading slash means that it's an absolute URI:
+you're telling the browser to always load 'http://mysite.com/images/foo.jpg' no
+matter what. The problem is that the image is actually at
+'http://mysite.com/railsapp/images/foo.jpg'. There are two ways to fix this.
+
+The first way (not recommended) is to change your view templates to refer to
+'images/foo.jpg'. This is a relative URI: note the lack of a leading slash). What
+this does is making the path relative to the current URI. The problem is that if you
+use restful URIs, then your images will probably break again when you add a level to
+the URI.
+For example, when you're at 'http://mysite.com/railsapp' the browser will look for
+'http://mysite.com/railsapp/images/foo.jpg'. But when you're at
+'http://mysite.com/railsapp/controller'. the browser will look for
+'http://mysite.com/railsapp/controller/images/foo.jpg'.
+So relative URIs usually don't work well with layout templates.
+
+The second and highly recommended way is to always use Rails helper methods to
+output tags for static assets. These helper methods automatically take care
+of prepending the base URI that you've deployed the application to. For images
+there is `image_tag`, for JavaScript there is `javascript_include_tag` and for
+CSS there is `stylesheet_link_tag`. In the above example you would simply remove
+the '<img>' HTML tag and replace it with inline Ruby like this:
+
+---------------------------------------
+<%= image_tag("foo.jpg") %>
+---------------------------------------
+
+This will generate the proper image tag to `$RAILS_ROOT/public/images/foo.jpg`
+so that your images will always work no matter what sub-URI you've deployed to.
+
+These helper methods are more valuable than you may think. For example they also
+append a timestamp to the URI to better facilitate HTTP caching. For more information,
+please refer to
+link:http://api.rubyonrails.org/classes/ActionView/Helpers/AssetTagHelper.html[the Rails API docs].
+
+
 == Appendix A: About this document ==
 
 The text of this document is licensed under the

data/doc/cxxapi/ApplicationPoolServer_8h-source.html

@@ -419,381 +419,409 @@
 <a name="l00403"></a>00403                                 UPDATE_TRACE_POINT();
 <a name="l00404"></a>00404                                 data-&gt;disconnect();
 <a name="l00405"></a>00405                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"The ApplicationPool server unexpectedly "</span>
-<a name="l00406"></a>00406                                         <span class="stringliteral">"closed the connection."</span>);
-<a name="l00407"></a>00407                         }
-<a name="l00408"></a>00408                         <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"ok"</span>) {
-<a name="l00409"></a>00409                                 UPDATE_TRACE_POINT();
-<a name="l00410"></a>00410                                 pid_t pid = (pid_t) <a class="code" href="group__Support.html#g7b50461f1bc2b370c956967870da2762" title="Converts the given string to a long integer.">atol</a>(args[1]);
-<a name="l00411"></a>00411                                 <span class="keywordtype">int</span> sessionID = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(args[2]);
-<a name="l00412"></a>00412                                 
-<a name="l00413"></a>00413                                 <span class="keywordflow">try</span> {
-<a name="l00414"></a>00414                                         stream = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
-<a name="l00415"></a>00415                                 } <span class="keywordflow">catch</span> (...) {
-<a name="l00416"></a>00416                                         UPDATE_TRACE_POINT();
-<a name="l00417"></a>00417                                         data-&gt;disconnect();
-<a name="l00418"></a>00418                                         <span class="keywordflow">throw</span>;
-<a name="l00419"></a>00419                                 }
-<a name="l00420"></a>00420                                 
-<a name="l00421"></a>00421                                 <span class="keywordflow">return</span> <a class="code" href="group__Support.html#g41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(<span class="keyword">new</span> RemoteSession(dataSmartPointer,
-<a name="l00422"></a>00422                                         pid, sessionID, stream));
-<a name="l00423"></a>00423                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"SpawnException"</span>) {
-<a name="l00424"></a>00424                                 UPDATE_TRACE_POINT();
-<a name="l00425"></a>00425                                 <span class="keywordflow">if</span> (args[2] == <span class="stringliteral">"true"</span>) {
-<a name="l00426"></a>00426                                         <span class="keywordtype">string</span> errorPage;
-<a name="l00427"></a>00427                                         
-<a name="l00428"></a>00428                                         <span class="keywordflow">try</span> {
-<a name="l00429"></a>00429                                                 result = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(errorPage);
-<a name="l00430"></a>00430                                         } <span class="keywordflow">catch</span> (...) {
-<a name="l00431"></a>00431                                                 data-&gt;disconnect();
-<a name="l00432"></a>00432                                                 <span class="keywordflow">throw</span>;
-<a name="l00433"></a>00433                                         }
-<a name="l00434"></a>00434                                         <span class="keywordflow">if</span> (!result) {
-<a name="l00435"></a>00435                                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"The ApplicationPool server "</span>
-<a name="l00436"></a>00436                                                         <span class="stringliteral">"unexpectedly closed the connection."</span>);
-<a name="l00437"></a>00437                                         }
-<a name="l00438"></a>00438                                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(args[1], errorPage);
-<a name="l00439"></a>00439                                 } <span class="keywordflow">else</span> {
-<a name="l00440"></a>00440                                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(args[1]);
-<a name="l00441"></a>00441                                 }
-<a name="l00442"></a>00442                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"BusyException"</span>) {
-<a name="l00443"></a>00443                                 UPDATE_TRACE_POINT();
-<a name="l00444"></a>00444                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1BusyException.html" title="The application pool is too busy and cannot fulfill a get() request.">BusyException</a>(args[1]);
-<a name="l00445"></a>00445                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"IOException"</span>) {
-<a name="l00446"></a>00446                                 UPDATE_TRACE_POINT();
-<a name="l00447"></a>00447                                 data-&gt;disconnect();
-<a name="l00448"></a>00448                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(args[1]);
-<a name="l00449"></a>00449                         } <span class="keywordflow">else</span> {
-<a name="l00450"></a>00450                                 UPDATE_TRACE_POINT();
-<a name="l00451"></a>00451                                 data-&gt;disconnect();
-<a name="l00452"></a>00452                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"The ApplicationPool server returned "</span>
-<a name="l00453"></a>00453                                         <span class="stringliteral">"an unknown message: "</span> + <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(args));
-<a name="l00454"></a>00454                         }
-<a name="l00455"></a>00455                 }
-<a name="l00456"></a>00456         };
-<a name="l00457"></a>00457         
-<a name="l00458"></a>00458         
-<a name="l00459"></a>00459         <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> SERVER_SOCKET_FD = 3;
+<a name="l00406"></a>00406                                         <span class="stringliteral">"closed the connection while we're reading a response "</span>
+<a name="l00407"></a>00407                                         <span class="stringliteral">"for the 'get' command."</span>);
+<a name="l00408"></a>00408                         }
+<a name="l00409"></a>00409                         <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"ok"</span>) {
+<a name="l00410"></a>00410                                 UPDATE_TRACE_POINT();
+<a name="l00411"></a>00411                                 pid_t pid = (pid_t) <a class="code" href="group__Support.html#g7b50461f1bc2b370c956967870da2762" title="Converts the given string to a long integer.">atol</a>(args[1]);
+<a name="l00412"></a>00412                                 <span class="keywordtype">int</span> sessionID = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(args[2]);
+<a name="l00413"></a>00413                                 
+<a name="l00414"></a>00414                                 <span class="keywordflow">try</span> {
+<a name="l00415"></a>00415                                         stream = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
+<a name="l00416"></a>00416                                 } <span class="keywordflow">catch</span> (...) {
+<a name="l00417"></a>00417                                         UPDATE_TRACE_POINT();
+<a name="l00418"></a>00418                                         data-&gt;disconnect();
+<a name="l00419"></a>00419                                         <span class="keywordflow">throw</span>;
+<a name="l00420"></a>00420                                 }
+<a name="l00421"></a>00421                                 
+<a name="l00422"></a>00422                                 <span class="keywordflow">return</span> <a class="code" href="group__Support.html#g41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(<span class="keyword">new</span> RemoteSession(dataSmartPointer,
+<a name="l00423"></a>00423                                         pid, sessionID, stream));
+<a name="l00424"></a>00424                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"SpawnException"</span>) {
+<a name="l00425"></a>00425                                 UPDATE_TRACE_POINT();
+<a name="l00426"></a>00426                                 <span class="keywordflow">if</span> (args[2] == <span class="stringliteral">"true"</span>) {
+<a name="l00427"></a>00427                                         <span class="keywordtype">string</span> errorPage;
+<a name="l00428"></a>00428                                         
+<a name="l00429"></a>00429                                         <span class="keywordflow">try</span> {
+<a name="l00430"></a>00430                                                 result = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(errorPage);
+<a name="l00431"></a>00431                                         } <span class="keywordflow">catch</span> (...) {
+<a name="l00432"></a>00432                                                 data-&gt;disconnect();
+<a name="l00433"></a>00433                                                 <span class="keywordflow">throw</span>;
+<a name="l00434"></a>00434                                         }
+<a name="l00435"></a>00435                                         <span class="keywordflow">if</span> (!result) {
+<a name="l00436"></a>00436                                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"The ApplicationPool server "</span>
+<a name="l00437"></a>00437                                                         <span class="stringliteral">"unexpectedly closed the connection while "</span>
+<a name="l00438"></a>00438                                                         <span class="stringliteral">"we're reading the error page data."</span>);
+<a name="l00439"></a>00439                                         }
+<a name="l00440"></a>00440                                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(args[1], errorPage);
+<a name="l00441"></a>00441                                 } <span class="keywordflow">else</span> {
+<a name="l00442"></a>00442                                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(args[1]);
+<a name="l00443"></a>00443                                 }
+<a name="l00444"></a>00444                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"BusyException"</span>) {
+<a name="l00445"></a>00445                                 UPDATE_TRACE_POINT();
+<a name="l00446"></a>00446                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1BusyException.html" title="The application pool is too busy and cannot fulfill a get() request.">BusyException</a>(args[1]);
+<a name="l00447"></a>00447                         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"IOException"</span>) {
+<a name="l00448"></a>00448                                 UPDATE_TRACE_POINT();
+<a name="l00449"></a>00449                                 data-&gt;disconnect();
+<a name="l00450"></a>00450                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(args[1]);
+<a name="l00451"></a>00451                         } <span class="keywordflow">else</span> {
+<a name="l00452"></a>00452                                 UPDATE_TRACE_POINT();
+<a name="l00453"></a>00453                                 data-&gt;disconnect();
+<a name="l00454"></a>00454                                 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"The ApplicationPool server returned "</span>
+<a name="l00455"></a>00455                                         <span class="stringliteral">"an unknown message: "</span> + <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(args));
+<a name="l00456"></a>00456                         }
+<a name="l00457"></a>00457                 }
+<a name="l00458"></a>00458         };
+<a name="l00459"></a>00459         
 <a name="l00460"></a>00460         
-<a name="l00461"></a>00461         <span class="keywordtype">string</span> m_serverExecutable;
-<a name="l00462"></a>00462         <span class="keywordtype">string</span> m_spawnServerCommand;
-<a name="l00463"></a>00463         <span class="keywordtype">string</span> m_logFile;
-<a name="l00464"></a>00464         <span class="keywordtype">string</span> m_rubyCommand;
-<a name="l00465"></a>00465         <span class="keywordtype">string</span> m_user;
-<a name="l00466"></a>00466         <span class="keywordtype">string</span> statusReportFIFO;
-<a name="l00467"></a>00467         <span class="comment"></span>
-<a name="l00468"></a>00468 <span class="comment">        /**</span>
-<a name="l00469"></a>00469 <span class="comment">         * The PID of the ApplicationPool server process. If no server process</span>
-<a name="l00470"></a>00470 <span class="comment">         * is running, then &lt;tt&gt;serverPid == 0&lt;/tt&gt;.</span>
-<a name="l00471"></a>00471 <span class="comment">         *</span>
-<a name="l00472"></a>00472 <span class="comment">         * @invariant</span>
-<a name="l00473"></a>00473 <span class="comment">         *    if serverPid == 0:</span>
-<a name="l00474"></a>00474 <span class="comment">         *       serverSocket == -1</span>
-<a name="l00475"></a>00475 <span class="comment">         */</span>
-<a name="l00476"></a>00476         pid_t serverPid;
-<a name="l00477"></a>00477         <span class="comment"></span>
-<a name="l00478"></a>00478 <span class="comment">        /**</span>
-<a name="l00479"></a>00479 <span class="comment">         * The connection to the ApplicationPool server process. If no server</span>
-<a name="l00480"></a>00480 <span class="comment">         * process is running, then &lt;tt&gt;serverSocket == -1&lt;/tt&gt;.</span>
-<a name="l00481"></a>00481 <span class="comment">         *</span>
-<a name="l00482"></a>00482 <span class="comment">         * @invariant</span>
-<a name="l00483"></a>00483 <span class="comment">         *    if serverPid == 0:</span>
-<a name="l00484"></a>00484 <span class="comment">         *       serverSocket == -1</span>
-<a name="l00485"></a>00485 <span class="comment">         */</span>
-<a name="l00486"></a>00486         <span class="keywordtype">int</span> serverSocket;
-<a name="l00487"></a>00487         <span class="comment"></span>
-<a name="l00488"></a>00488 <span class="comment">        /**</span>
-<a name="l00489"></a>00489 <span class="comment">         * Shutdown the currently running ApplicationPool server process.</span>
-<a name="l00490"></a>00490 <span class="comment">         *</span>
-<a name="l00491"></a>00491 <span class="comment">         * @pre System call interruption is disabled.</span>
-<a name="l00492"></a>00492 <span class="comment">         * @pre serverSocket != -1 &amp;&amp; serverPid != 0</span>
-<a name="l00493"></a>00493 <span class="comment">         * @post serverSocket == -1 &amp;&amp; serverPid == 0</span>
-<a name="l00494"></a>00494 <span class="comment">         */</span>
-<a name="l00495"></a>00495         <span class="keywordtype">void</span> shutdownServer() {
-<a name="l00496"></a>00496                 TRACE_POINT();
-<a name="l00497"></a>00497                 this_thread::disable_syscall_interruption dsi;
-<a name="l00498"></a>00498                 <span class="keywordtype">int</span> ret;
-<a name="l00499"></a>00499                 time_t begin;
-<a name="l00500"></a>00500                 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
-<a name="l00501"></a>00501                 
-<a name="l00502"></a>00502                 syscalls::close(serverSocket);
-<a name="l00503"></a>00503                 <span class="keywordflow">if</span> (!statusReportFIFO.empty()) {
-<a name="l00504"></a>00504                         <span class="keywordflow">do</span> {
-<a name="l00505"></a>00505                                 ret = unlink(statusReportFIFO.c_str());
-<a name="l00506"></a>00506                         } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
-<a name="l00507"></a>00507                 }
-<a name="l00508"></a>00508                 
-<a name="l00509"></a>00509                 P_TRACE(2, <span class="stringliteral">"Waiting for existing ApplicationPoolServerExecutable (PID "</span> &lt;&lt;
-<a name="l00510"></a>00510                         serverPid &lt;&lt; <span class="stringliteral">") to exit..."</span>);
-<a name="l00511"></a>00511                 begin = syscalls::time(NULL);
-<a name="l00512"></a>00512                 <span class="keywordflow">while</span> (!done &amp;&amp; syscalls::time(NULL) &lt; begin + 5) {
-<a name="l00513"></a>00513                         <span class="comment">/*</span>
-<a name="l00514"></a>00514 <span class="comment">                         * Some Apache modules fork(), but don't close file descriptors.</span>
-<a name="l00515"></a>00515 <span class="comment">                         * mod_wsgi is one such example. Because of that, closing serverSocket</span>
-<a name="l00516"></a>00516 <span class="comment">                         * won't always cause the ApplicationPool server to exit. So we send it a</span>
-<a name="l00517"></a>00517 <span class="comment">                         * signal.</span>
-<a name="l00518"></a>00518 <span class="comment">                         */</span>
-<a name="l00519"></a>00519                         syscalls::kill(serverPid, SIGINT);
-<a name="l00520"></a>00520                         
-<a name="l00521"></a>00521                         ret = syscalls::waitpid(serverPid, NULL, WNOHANG);
-<a name="l00522"></a>00522                         done = ret &gt; 0 || ret == -1;
-<a name="l00523"></a>00523                         <span class="keywordflow">if</span> (!done) {
-<a name="l00524"></a>00524                                 syscalls::usleep(100000);
-<a name="l00525"></a>00525                         }
-<a name="l00526"></a>00526                 }
-<a name="l00527"></a>00527                 <span class="keywordflow">if</span> (done) {
-<a name="l00528"></a>00528                         P_TRACE(2, <span class="stringliteral">"ApplicationPoolServerExecutable exited."</span>);
-<a name="l00529"></a>00529                 } <span class="keywordflow">else</span> {
-<a name="l00530"></a>00530                         P_DEBUG(<span class="stringliteral">"ApplicationPoolServerExecutable not exited in time. Killing it..."</span>);
-<a name="l00531"></a>00531                         syscalls::kill(serverPid, SIGTERM);
-<a name="l00532"></a>00532                         syscalls::waitpid(serverPid, NULL, 0);
-<a name="l00533"></a>00533                 }
-<a name="l00534"></a>00534                 
-<a name="l00535"></a>00535                 serverSocket = -1;
-<a name="l00536"></a>00536                 serverPid = 0;
-<a name="l00537"></a>00537         }
-<a name="l00538"></a>00538         <span class="comment"></span>
-<a name="l00539"></a>00539 <span class="comment">        /**</span>
-<a name="l00540"></a>00540 <span class="comment">         * Start an ApplicationPool server process. If there's already one running,</span>
-<a name="l00541"></a>00541 <span class="comment">         * then the currently running one will be shutdown.</span>
-<a name="l00542"></a>00542 <span class="comment">         *</span>
-<a name="l00543"></a>00543 <span class="comment">         * @pre System call interruption is disabled.</span>
-<a name="l00544"></a>00544 <span class="comment">         * @post serverSocket != -1 &amp;&amp; serverPid != 0</span>
-<a name="l00545"></a>00545 <span class="comment">         * @throw SystemException Something went wrong.</span>
-<a name="l00546"></a>00546 <span class="comment">         */</span>
-<a name="l00547"></a>00547         <span class="keywordtype">void</span> restartServer() {
-<a name="l00548"></a>00548                 TRACE_POINT();
-<a name="l00549"></a>00549                 <span class="keywordtype">int</span> fds[2];
-<a name="l00550"></a>00550                 pid_t pid;
-<a name="l00551"></a>00551                 
-<a name="l00552"></a>00552                 <span class="keywordflow">if</span> (serverPid != 0) {
-<a name="l00553"></a>00553                         shutdownServer();
-<a name="l00554"></a>00554                 }
-<a name="l00555"></a>00555                 
-<a name="l00556"></a>00556                 <span class="keywordflow">if</span> (syscalls::socketpair(AF_UNIX, SOCK_STREAM, 0, fds) == -1) {
-<a name="l00557"></a>00557                         <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>(<span class="stringliteral">"Cannot create a Unix socket pair"</span>, errno);
-<a name="l00558"></a>00558                 }
-<a name="l00559"></a>00559                 
-<a name="l00560"></a>00560                 createStatusReportFIFO();
-<a name="l00561"></a>00561                 
-<a name="l00562"></a>00562                 pid = syscalls::fork();
-<a name="l00563"></a>00563                 <span class="keywordflow">if</span> (pid == 0) { <span class="comment">// Child process.</span>
-<a name="l00564"></a>00564                         dup2(STDERR_FILENO, STDOUT_FILENO);  <span class="comment">// Redirect stdout to the same channel as stderr.</span>
-<a name="l00565"></a>00565                         dup2(fds[0], SERVER_SOCKET_FD);
-<a name="l00566"></a>00566                         
-<a name="l00567"></a>00567                         <span class="comment">// Close all unnecessary file descriptors</span>
-<a name="l00568"></a>00568                         <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = sysconf(_SC_OPEN_MAX) - 1; i &gt; SERVER_SOCKET_FD; i--) {
-<a name="l00569"></a>00569                                 close(i);
-<a name="l00570"></a>00570                         }
-<a name="l00571"></a>00571                         
-<a name="l00572"></a>00572                         execlp(
-<a name="l00573"></a>00573                                 #<span class="keywordflow">if</span> 0
-<a name="l00574"></a>00574                                         <span class="stringliteral">"valgrind"</span>,
-<a name="l00575"></a>00575                                         <span class="stringliteral">"valgrind"</span>,
-<a name="l00576"></a>00576                                 #<span class="keywordflow">else</span>
-<a name="l00577"></a>00577                                         m_serverExecutable.c_str(),
-<a name="l00578"></a>00578 <span class="preprocessor">                                #endif</span>
-<a name="l00579"></a>00579 <span class="preprocessor"></span>                                m_serverExecutable.c_str(),
-<a name="l00580"></a>00580                                 <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(Passenger::getLogLevel()).c_str(),
-<a name="l00581"></a>00581                                 m_spawnServerCommand.c_str(),
-<a name="l00582"></a>00582                                 m_logFile.c_str(),
-<a name="l00583"></a>00583                                 m_rubyCommand.c_str(),
-<a name="l00584"></a>00584                                 m_user.c_str(),
-<a name="l00585"></a>00585                                 statusReportFIFO.c_str(),
-<a name="l00586"></a>00586                                 (<span class="keywordtype">char</span> *) 0);
-<a name="l00587"></a>00587                         <span class="keywordtype">int</span> e = errno;
-<a name="l00588"></a>00588                         fprintf(stderr, <span class="stringliteral">"*** Passenger ERROR (%s:%d):\n"</span>
-<a name="l00589"></a>00589                                 <span class="stringliteral">"Cannot execute %s: %s (%d)\n"</span>,
-<a name="l00590"></a>00590                                 __FILE__, __LINE__,
-<a name="l00591"></a>00591                                 m_serverExecutable.c_str(), strerror(e), e);
-<a name="l00592"></a>00592                         fflush(stderr);
-<a name="l00593"></a>00593                         _exit(1);
-<a name="l00594"></a>00594                 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pid == -1) { <span class="comment">// Error.</span>
-<a name="l00595"></a>00595                         syscalls::close(fds[0]);
-<a name="l00596"></a>00596                         syscalls::close(fds[1]);
-<a name="l00597"></a>00597                         <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>(<span class="stringliteral">"Cannot create a new process"</span>, errno);
-<a name="l00598"></a>00598                 } <span class="keywordflow">else</span> { <span class="comment">// Parent process.</span>
-<a name="l00599"></a>00599                         syscalls::close(fds[0]);
-<a name="l00600"></a>00600                         serverSocket = fds[1];
-<a name="l00601"></a>00601                         
-<a name="l00602"></a>00602                         <span class="keywordtype">int</span> flags = fcntl(serverSocket, F_GETFD);
-<a name="l00603"></a>00603                         <span class="keywordflow">if</span> (flags != -1) {
-<a name="l00604"></a>00604                                 fcntl(serverSocket, F_SETFD, flags | FD_CLOEXEC);
-<a name="l00605"></a>00605                         }
-<a name="l00606"></a>00606                         
-<a name="l00607"></a>00607                         serverPid = pid;
-<a name="l00608"></a>00608                 }
-<a name="l00609"></a>00609         }
-<a name="l00610"></a>00610         
-<a name="l00611"></a>00611         <span class="keywordtype">void</span> createStatusReportFIFO() {
-<a name="l00612"></a>00612                 TRACE_POINT();
-<a name="l00613"></a>00613                 <span class="keywordtype">char</span> filename[PATH_MAX];
-<a name="l00614"></a>00614                 <span class="keywordtype">int</span> ret;
-<a name="l00615"></a>00615                 mode_t permissions;
-<a name="l00616"></a>00616                 
-<a name="l00617"></a>00617                 createPassengerTempDir();
-<a name="l00618"></a>00618                 
-<a name="l00619"></a>00619                 <span class="keywordflow">if</span> (m_user.empty()) {
-<a name="l00620"></a>00620                         permissions = S_IRUSR | S_IWUSR;
-<a name="l00621"></a>00621                 } <span class="keywordflow">else</span> {
-<a name="l00622"></a>00622                         permissions = S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH;
+<a name="l00461"></a>00461         <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> SERVER_SOCKET_FD = 3;
+<a name="l00462"></a>00462         
+<a name="l00463"></a>00463         <span class="keywordtype">string</span> m_serverExecutable;
+<a name="l00464"></a>00464         <span class="keywordtype">string</span> m_spawnServerCommand;
+<a name="l00465"></a>00465         <span class="keywordtype">string</span> m_logFile;
+<a name="l00466"></a>00466         <span class="keywordtype">string</span> m_rubyCommand;
+<a name="l00467"></a>00467         <span class="keywordtype">string</span> m_user;
+<a name="l00468"></a>00468         <span class="keywordtype">string</span> statusReportFIFO;
+<a name="l00469"></a>00469         <span class="comment"></span>
+<a name="l00470"></a>00470 <span class="comment">        /**</span>
+<a name="l00471"></a>00471 <span class="comment">         * The PID of the ApplicationPool server process. If no server process</span>
+<a name="l00472"></a>00472 <span class="comment">         * is running, then &lt;tt&gt;serverPid == 0&lt;/tt&gt;.</span>
+<a name="l00473"></a>00473 <span class="comment">         *</span>
+<a name="l00474"></a>00474 <span class="comment">         * @invariant</span>
+<a name="l00475"></a>00475 <span class="comment">         *    if serverPid == 0:</span>
+<a name="l00476"></a>00476 <span class="comment">         *       serverSocket == -1</span>
+<a name="l00477"></a>00477 <span class="comment">         */</span>
+<a name="l00478"></a>00478         pid_t serverPid;
+<a name="l00479"></a>00479         <span class="comment"></span>
+<a name="l00480"></a>00480 <span class="comment">        /**</span>
+<a name="l00481"></a>00481 <span class="comment">         * The connection to the ApplicationPool server process. If no server</span>
+<a name="l00482"></a>00482 <span class="comment">         * process is running, then &lt;tt&gt;serverSocket == -1&lt;/tt&gt;.</span>
+<a name="l00483"></a>00483 <span class="comment">         *</span>
+<a name="l00484"></a>00484 <span class="comment">         * @invariant</span>
+<a name="l00485"></a>00485 <span class="comment">         *    if serverPid == 0:</span>
+<a name="l00486"></a>00486 <span class="comment">         *       serverSocket == -1</span>
+<a name="l00487"></a>00487 <span class="comment">         */</span>
+<a name="l00488"></a>00488         <span class="keywordtype">int</span> serverSocket;
+<a name="l00489"></a>00489         <span class="comment"></span>
+<a name="l00490"></a>00490 <span class="comment">        /**</span>
+<a name="l00491"></a>00491 <span class="comment">         * Shutdown the currently running ApplicationPool server process.</span>
+<a name="l00492"></a>00492 <span class="comment">         *</span>
+<a name="l00493"></a>00493 <span class="comment">         * @pre System call interruption is disabled.</span>
+<a name="l00494"></a>00494 <span class="comment">         * @pre serverSocket != -1 &amp;&amp; serverPid != 0</span>
+<a name="l00495"></a>00495 <span class="comment">         * @post serverSocket == -1 &amp;&amp; serverPid == 0</span>
+<a name="l00496"></a>00496 <span class="comment">         */</span>
+<a name="l00497"></a>00497         <span class="keywordtype">void</span> shutdownServer() {
+<a name="l00498"></a>00498                 TRACE_POINT();
+<a name="l00499"></a>00499                 this_thread::disable_syscall_interruption dsi;
+<a name="l00500"></a>00500                 <span class="keywordtype">int</span> ret, status;
+<a name="l00501"></a>00501                 time_t begin;
+<a name="l00502"></a>00502                 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
+<a name="l00503"></a>00503                 
+<a name="l00504"></a>00504                 syscalls::close(serverSocket);
+<a name="l00505"></a>00505                 <span class="keywordflow">if</span> (!statusReportFIFO.empty()) {
+<a name="l00506"></a>00506                         <span class="keywordflow">do</span> {
+<a name="l00507"></a>00507                                 ret = unlink(statusReportFIFO.c_str());
+<a name="l00508"></a>00508                         } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
+<a name="l00509"></a>00509                 }
+<a name="l00510"></a>00510                 
+<a name="l00511"></a>00511                 P_TRACE(2, <span class="stringliteral">"Waiting for existing ApplicationPoolServerExecutable (PID "</span> &lt;&lt;
+<a name="l00512"></a>00512                         serverPid &lt;&lt; <span class="stringliteral">") to exit..."</span>);
+<a name="l00513"></a>00513                 begin = syscalls::time(NULL);
+<a name="l00514"></a>00514                 <span class="keywordflow">while</span> (!done &amp;&amp; syscalls::time(NULL) &lt; begin + 5) {
+<a name="l00515"></a>00515                         <span class="comment">/*</span>
+<a name="l00516"></a>00516 <span class="comment">                         * Some Apache modules fork(), but don't close file descriptors.</span>
+<a name="l00517"></a>00517 <span class="comment">                         * mod_wsgi is one such example. Because of that, closing serverSocket</span>
+<a name="l00518"></a>00518 <span class="comment">                         * won't always cause the ApplicationPool server to exit. So we send it a</span>
+<a name="l00519"></a>00519 <span class="comment">                         * signal. This must be the same as the oxt/system_calls.hpp interruption</span>
+<a name="l00520"></a>00520 <span class="comment">                         * signal.</span>
+<a name="l00521"></a>00521 <span class="comment">                         */</span>
+<a name="l00522"></a>00522                         syscalls::kill(serverPid, SIGINT);
+<a name="l00523"></a>00523                         
+<a name="l00524"></a>00524                         ret = syscalls::waitpid(serverPid, &amp;status, WNOHANG);
+<a name="l00525"></a>00525                         done = ret &gt; 0 || ret == -1;
+<a name="l00526"></a>00526                         <span class="keywordflow">if</span> (!done) {
+<a name="l00527"></a>00527                                 syscalls::usleep(100000);
+<a name="l00528"></a>00528                         }
+<a name="l00529"></a>00529                 }
+<a name="l00530"></a>00530                 <span class="keywordflow">if</span> (done) {
+<a name="l00531"></a>00531                         <span class="keywordflow">if</span> (ret &gt; 0) {
+<a name="l00532"></a>00532                                 <span class="keywordflow">if</span> (WIFEXITED(status)) {
+<a name="l00533"></a>00533                                         P_TRACE(2, <span class="stringliteral">"ApplicationPoolServerExecutable exited with exit status "</span> &lt;&lt;
+<a name="l00534"></a>00534                                                 WEXITSTATUS(status) &lt;&lt; <span class="stringliteral">"."</span>);
+<a name="l00535"></a>00535                                 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (WIFSIGNALED(status)) {
+<a name="l00536"></a>00536                                         P_TRACE(2, <span class="stringliteral">"ApplicationPoolServerExecutable exited because of signal "</span> &lt;&lt;
+<a name="l00537"></a>00537                                                 WTERMSIG(status) &lt;&lt; <span class="stringliteral">"."</span>);
+<a name="l00538"></a>00538                                 } <span class="keywordflow">else</span> {
+<a name="l00539"></a>00539                                         P_TRACE(2, <span class="stringliteral">"ApplicationPoolServerExecutable exited for an unknown reason."</span>);
+<a name="l00540"></a>00540                                 }
+<a name="l00541"></a>00541                         } <span class="keywordflow">else</span> {
+<a name="l00542"></a>00542                                 P_TRACE(2, <span class="stringliteral">"ApplicationPoolServerExecutable exited."</span>);
+<a name="l00543"></a>00543                         }
+<a name="l00544"></a>00544                 } <span class="keywordflow">else</span> {
+<a name="l00545"></a>00545                         P_DEBUG(<span class="stringliteral">"ApplicationPoolServerExecutable not exited in time. Killing it..."</span>);
+<a name="l00546"></a>00546                         syscalls::kill(serverPid, SIGKILL);
+<a name="l00547"></a>00547                         syscalls::waitpid(serverPid, NULL, 0);
+<a name="l00548"></a>00548                 }
+<a name="l00549"></a>00549                 
+<a name="l00550"></a>00550                 serverSocket = -1;
+<a name="l00551"></a>00551                 serverPid = 0;
+<a name="l00552"></a>00552         }
+<a name="l00553"></a>00553         <span class="comment"></span>
+<a name="l00554"></a>00554 <span class="comment">        /**</span>
+<a name="l00555"></a>00555 <span class="comment">         * Start an ApplicationPool server process. If there's already one running,</span>
+<a name="l00556"></a>00556 <span class="comment">         * then the currently running one will be shutdown.</span>
+<a name="l00557"></a>00557 <span class="comment">         *</span>
+<a name="l00558"></a>00558 <span class="comment">         * @pre System call interruption is disabled.</span>
+<a name="l00559"></a>00559 <span class="comment">         * @post serverSocket != -1 &amp;&amp; serverPid != 0</span>
+<a name="l00560"></a>00560 <span class="comment">         * @throw SystemException Something went wrong.</span>
+<a name="l00561"></a>00561 <span class="comment">         */</span>
+<a name="l00562"></a>00562         <span class="keywordtype">void</span> restartServer() {
+<a name="l00563"></a>00563                 TRACE_POINT();
+<a name="l00564"></a>00564                 <span class="keywordtype">int</span> fds[2];
+<a name="l00565"></a>00565                 pid_t pid;
+<a name="l00566"></a>00566                 
+<a name="l00567"></a>00567                 <span class="keywordflow">if</span> (serverPid != 0) {
+<a name="l00568"></a>00568                         shutdownServer();
+<a name="l00569"></a>00569                 }
+<a name="l00570"></a>00570                 
+<a name="l00571"></a>00571                 <span class="keywordflow">if</span> (syscalls::socketpair(AF_UNIX, SOCK_STREAM, 0, fds) == -1) {
+<a name="l00572"></a>00572                         <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>(<span class="stringliteral">"Cannot create a Unix socket pair"</span>, errno);
+<a name="l00573"></a>00573                 }
+<a name="l00574"></a>00574                 
+<a name="l00575"></a>00575                 createStatusReportFIFO();
+<a name="l00576"></a>00576                 
+<a name="l00577"></a>00577                 pid = syscalls::fork();
+<a name="l00578"></a>00578                 <span class="keywordflow">if</span> (pid == 0) { <span class="comment">// Child process.</span>
+<a name="l00579"></a>00579                         dup2(STDERR_FILENO, STDOUT_FILENO);  <span class="comment">// Redirect stdout to the same channel as stderr.</span>
+<a name="l00580"></a>00580                         dup2(fds[0], SERVER_SOCKET_FD);
+<a name="l00581"></a>00581                         
+<a name="l00582"></a>00582                         <span class="comment">// Close all unnecessary file descriptors</span>
+<a name="l00583"></a>00583                         <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = sysconf(_SC_OPEN_MAX) - 1; i &gt; SERVER_SOCKET_FD; i--) {
+<a name="l00584"></a>00584                                 close(i);
+<a name="l00585"></a>00585                         }
+<a name="l00586"></a>00586                         
+<a name="l00587"></a>00587                         execlp(
+<a name="l00588"></a>00588                                 #<span class="keywordflow">if</span> 0
+<a name="l00589"></a>00589                                         <span class="stringliteral">"valgrind"</span>,
+<a name="l00590"></a>00590                                         <span class="stringliteral">"valgrind"</span>,
+<a name="l00591"></a>00591                                 #<span class="keywordflow">else</span>
+<a name="l00592"></a>00592                                         m_serverExecutable.c_str(),
+<a name="l00593"></a>00593 <span class="preprocessor">                                #endif</span>
+<a name="l00594"></a>00594 <span class="preprocessor"></span>                                m_serverExecutable.c_str(),
+<a name="l00595"></a>00595                                 <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(Passenger::getLogLevel()).c_str(),
+<a name="l00596"></a>00596                                 m_spawnServerCommand.c_str(),
+<a name="l00597"></a>00597                                 m_logFile.c_str(),
+<a name="l00598"></a>00598                                 m_rubyCommand.c_str(),
+<a name="l00599"></a>00599                                 m_user.c_str(),
+<a name="l00600"></a>00600                                 statusReportFIFO.c_str(),
+<a name="l00601"></a>00601                                 (<span class="keywordtype">char</span> *) 0);
+<a name="l00602"></a>00602                         <span class="keywordtype">int</span> e = errno;
+<a name="l00603"></a>00603                         fprintf(stderr, <span class="stringliteral">"*** Passenger ERROR (%s:%d):\n"</span>
+<a name="l00604"></a>00604                                 <span class="stringliteral">"Cannot execute %s: %s (%d)\n"</span>,
+<a name="l00605"></a>00605                                 __FILE__, __LINE__,
+<a name="l00606"></a>00606                                 m_serverExecutable.c_str(), strerror(e), e);
+<a name="l00607"></a>00607                         fflush(stderr);
+<a name="l00608"></a>00608                         _exit(1);
+<a name="l00609"></a>00609                 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pid == -1) { <span class="comment">// Error.</span>
+<a name="l00610"></a>00610                         syscalls::close(fds[0]);
+<a name="l00611"></a>00611                         syscalls::close(fds[1]);
+<a name="l00612"></a>00612                         <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>(<span class="stringliteral">"Cannot create a new process"</span>, errno);
+<a name="l00613"></a>00613                 } <span class="keywordflow">else</span> { <span class="comment">// Parent process.</span>
+<a name="l00614"></a>00614                         syscalls::close(fds[0]);
+<a name="l00615"></a>00615                         serverSocket = fds[1];
+<a name="l00616"></a>00616                         
+<a name="l00617"></a>00617                         <span class="keywordtype">int</span> flags = fcntl(serverSocket, F_GETFD);
+<a name="l00618"></a>00618                         <span class="keywordflow">if</span> (flags != -1) {
+<a name="l00619"></a>00619                                 fcntl(serverSocket, F_SETFD, flags | FD_CLOEXEC);
+<a name="l00620"></a>00620                         }
+<a name="l00621"></a>00621                         
+<a name="l00622"></a>00622                         serverPid = pid;
 <a name="l00623"></a>00623                 }
-<a name="l00624"></a>00624                 
-<a name="l00625"></a>00625                 snprintf(filename, <span class="keyword">sizeof</span>(filename), <span class="stringliteral">"%s/status.fifo"</span>,
-<a name="l00626"></a>00626                                 <a class="code" href="group__Support.html#g5d3a5c5fe2944a898e425e30b53ac0ac" title="Return the path name for the directory in which Phusion Passenger-specific temporary...">getPassengerTempDir</a>().c_str());
-<a name="l00627"></a>00627                 filename[PATH_MAX - 1] = <span class="charliteral">'\0'</span>;
-<a name="l00628"></a>00628                 <span class="keywordflow">do</span> {
-<a name="l00629"></a>00629                         ret = mkfifo(filename, permissions);
-<a name="l00630"></a>00630                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
-<a name="l00631"></a>00631                 <span class="keywordflow">if</span> (ret == -1 &amp;&amp; errno != EEXIST) {
-<a name="l00632"></a>00632                         <span class="keywordtype">int</span> e = errno;
-<a name="l00633"></a>00633                         P_WARN(<span class="stringliteral">"*** WARNING: Could not create FIFO '"</span> &lt;&lt; filename &lt;&lt;
-<a name="l00634"></a>00634                                 <span class="stringliteral">"': "</span> &lt;&lt; strerror(e) &lt;&lt; <span class="stringliteral">" ("</span> &lt;&lt; e &lt;&lt; <span class="stringliteral">")"</span> &lt;&lt; endl &lt;&lt;
-<a name="l00635"></a>00635                                 <span class="stringliteral">"Disabling Passenger ApplicationPool status reporting."</span>);
-<a name="l00636"></a>00636                         statusReportFIFO = <span class="stringliteral">""</span>;
-<a name="l00637"></a>00637                 } <span class="keywordflow">else</span> {
-<a name="l00638"></a>00638                         statusReportFIFO = filename;
-<a name="l00639"></a>00639                         
-<a name="l00640"></a>00640                         <span class="comment">// It seems that the permissions passed to mkfifo()</span>
-<a name="l00641"></a>00641                         <span class="comment">// aren't respected, so here we chmod the file.</span>
-<a name="l00642"></a>00642                         <span class="keywordflow">do</span> {
-<a name="l00643"></a>00643                                 ret = chmod(filename, permissions);
-<a name="l00644"></a>00644                         } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
-<a name="l00645"></a>00645                 }
-<a name="l00646"></a>00646         }
-<a name="l00647"></a>00647 
-<a name="l00648"></a>00648 <span class="keyword">public</span>:<span class="comment"></span>
-<a name="l00649"></a>00649 <span class="comment">        /**</span>
-<a name="l00650"></a>00650 <span class="comment">         * Create a new ApplicationPoolServer object.</span>
-<a name="l00651"></a>00651 <span class="comment">         *</span>
-<a name="l00652"></a>00652 <span class="comment">         * @param serverExecutable The filename of the ApplicationPool server</span>
-<a name="l00653"></a>00653 <span class="comment">         *            executable to use.</span>
-<a name="l00654"></a>00654 <span class="comment">         * @param spawnServerCommand The filename of the spawn server to use.</span>
-<a name="l00655"></a>00655 <span class="comment">         * @param logFile Specify a log file that the spawn server should use.</span>
-<a name="l00656"></a>00656 <span class="comment">         *            Messages on its standard output and standard error channels</span>
-<a name="l00657"></a>00657 <span class="comment">         *            will be written to this log file. If an empty string is</span>
-<a name="l00658"></a>00658 <span class="comment">         *            specified, no log file will be used, and the spawn server</span>
-<a name="l00659"></a>00659 <span class="comment">         *            will use the same standard output/error channels as the</span>
-<a name="l00660"></a>00660 <span class="comment">         *            current process.</span>
-<a name="l00661"></a>00661 <span class="comment">         * @param rubyCommand The Ruby interpreter's command.</span>
-<a name="l00662"></a>00662 <span class="comment">         * @param user The user that the spawn manager should run as. This</span>
-<a name="l00663"></a>00663 <span class="comment">         *             parameter only has effect if the current process is</span>
-<a name="l00664"></a>00664 <span class="comment">         *             running as root. If the empty string is given, or if</span>
-<a name="l00665"></a>00665 <span class="comment">         *             the &lt;tt&gt;user&lt;/tt&gt; is not a valid username, then</span>
-<a name="l00666"></a>00666 <span class="comment">         *             the spawn manager will be run as the current user.</span>
-<a name="l00667"></a>00667 <span class="comment">         * @throws SystemException An error occured while trying to setup the spawn server</span>
-<a name="l00668"></a>00668 <span class="comment">         *            or the server socket.</span>
-<a name="l00669"></a>00669 <span class="comment">         * @throws IOException The specified log file could not be opened.</span>
-<a name="l00670"></a>00670 <span class="comment">         */</span>
-<a name="l00671"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#2203db62a022579d569ceddff8ef6ca9">00671</a>         <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#2203db62a022579d569ceddff8ef6ca9" title="Create a new ApplicationPoolServer object.">ApplicationPoolServer</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;serverExecutable,
-<a name="l00672"></a>00672                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;spawnServerCommand,
-<a name="l00673"></a>00673                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;logFile = <span class="stringliteral">""</span>,
-<a name="l00674"></a>00674                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;rubyCommand = <span class="stringliteral">"ruby"</span>,
-<a name="l00675"></a>00675                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;user = <span class="stringliteral">""</span>)
-<a name="l00676"></a>00676         : m_serverExecutable(serverExecutable),
-<a name="l00677"></a>00677           m_spawnServerCommand(spawnServerCommand),
-<a name="l00678"></a>00678           m_logFile(logFile),
-<a name="l00679"></a>00679           m_rubyCommand(rubyCommand),
-<a name="l00680"></a>00680           m_user(user) {
-<a name="l00681"></a>00681                 TRACE_POINT();
-<a name="l00682"></a>00682                 serverSocket = -1;
-<a name="l00683"></a>00683                 serverPid = 0;
-<a name="l00684"></a>00684                 this_thread::disable_syscall_interruption dsi;
-<a name="l00685"></a>00685                 restartServer();
-<a name="l00686"></a>00686         }
-<a name="l00687"></a>00687         
-<a name="l00688"></a>00688         ~<a class="code" href="classPassenger_1_1ApplicationPoolServer.html" title="Multi-process usage support for ApplicationPool.">ApplicationPoolServer</a>() {
-<a name="l00689"></a>00689                 TRACE_POINT();
-<a name="l00690"></a>00690                 <span class="keywordflow">if</span> (serverSocket != -1) {
-<a name="l00691"></a>00691                         UPDATE_TRACE_POINT();
-<a name="l00692"></a>00692                         this_thread::disable_syscall_interruption dsi;
-<a name="l00693"></a>00693                         shutdownServer();
-<a name="l00694"></a>00694                 }
-<a name="l00695"></a>00695         }
-<a name="l00696"></a>00696         <span class="comment"></span>
-<a name="l00697"></a>00697 <span class="comment">        /**</span>
-<a name="l00698"></a>00698 <span class="comment">         * Connects to the server and returns a usable ApplicationPool object.</span>
-<a name="l00699"></a>00699 <span class="comment">         * All cache/pool data of this ApplicationPool is actually stored on</span>
-<a name="l00700"></a>00700 <span class="comment">         * the server and shared with other clients, but that is totally</span>
-<a name="l00701"></a>00701 <span class="comment">         * transparent to the user of the ApplicationPool object.</span>
-<a name="l00702"></a>00702 <span class="comment">         *</span>
-<a name="l00703"></a>00703 <span class="comment">         * @note</span>
-<a name="l00704"></a>00704 <span class="comment">         *   All methods of the returned ApplicationPool object may throw</span>
-<a name="l00705"></a>00705 <span class="comment">         *   SystemException, IOException or boost::thread_interrupted.</span>
-<a name="l00706"></a>00706 <span class="comment">         *</span>
-<a name="l00707"></a>00707 <span class="comment">         * @warning</span>
-<a name="l00708"></a>00708 <span class="comment">         * One may only use the returned ApplicationPool object for handling</span>
-<a name="l00709"></a>00709 <span class="comment">         * one session at a time. For example, don't do stuff like this:</span>
-<a name="l00710"></a>00710 <span class="comment">         * @code</span>
-<a name="l00711"></a>00711 <span class="comment">         *   ApplicationPoolPtr pool = server.connect();</span>
-<a name="l00712"></a>00712 <span class="comment">         *   Application::SessionPtr session1 = pool-&gt;get(...);</span>
-<a name="l00713"></a>00713 <span class="comment">         *   Application::SessionPtr session2 = pool-&gt;get(...);</span>
-<a name="l00714"></a>00714 <span class="comment">         * @endcode</span>
-<a name="l00715"></a>00715 <span class="comment">         * Otherwise, a deadlock can occur under certain circumstances.</span>
-<a name="l00716"></a>00716 <span class="comment">         * @warning</span>
-<a name="l00717"></a>00717 <span class="comment">         * Instead, one should call connect() multiple times:</span>
-<a name="l00718"></a>00718 <span class="comment">         * @code</span>
-<a name="l00719"></a>00719 <span class="comment">         *   ApplicationPoolPtr pool1 = server.connect();</span>
-<a name="l00720"></a>00720 <span class="comment">         *   Application::SessionPtr session1 = pool1-&gt;get(...);</span>
-<a name="l00721"></a>00721 <span class="comment">         *   </span>
-<a name="l00722"></a>00722 <span class="comment">         *   ApplicationPoolPtr pool2 = server.connect();</span>
-<a name="l00723"></a>00723 <span class="comment">         *   Application::SessionPtr session2 = pool2-&gt;get(...);</span>
-<a name="l00724"></a>00724 <span class="comment">         * @endcode</span>
-<a name="l00725"></a>00725 <span class="comment">         *</span>
-<a name="l00726"></a>00726 <span class="comment">         * @throws SystemException Something went wrong.</span>
-<a name="l00727"></a>00727 <span class="comment">         * @throws IOException Something went wrong.</span>
-<a name="l00728"></a>00728 <span class="comment">         */</span>
-<a name="l00729"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#18f77057cc28e7924a8f4d1397aa0468">00729</a>         ApplicationPoolPtr <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#18f77057cc28e7924a8f4d1397aa0468" title="Connects to the server and returns a usable ApplicationPool object.">connect</a>() {
-<a name="l00730"></a>00730                 TRACE_POINT();
-<a name="l00731"></a>00731                 <span class="keywordflow">try</span> {
-<a name="l00732"></a>00732                         this_thread::disable_syscall_interruption dsi;
-<a name="l00733"></a>00733                         <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel(serverSocket);
-<a name="l00734"></a>00734                         <span class="keywordtype">int</span> clientConnection;
-<a name="l00735"></a>00735                         
-<a name="l00736"></a>00736                         <span class="comment">// Write some random data to wake up the server.</span>
-<a name="l00737"></a>00737                         channel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(<span class="stringliteral">"x"</span>, 1);
-<a name="l00738"></a>00738                         
-<a name="l00739"></a>00739                         clientConnection = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
-<a name="l00740"></a>00740                         <span class="keywordflow">return</span> <a class="code" href="group__Support.html#g41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(<span class="keyword">new</span> Client(clientConnection));
-<a name="l00741"></a>00741                 } <span class="keywordflow">catch</span> (<span class="keyword">const</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> &amp;e) {
-<a name="l00742"></a>00742                         <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>(<span class="stringliteral">"Could not connect to the ApplicationPool server"</span>, e.<a class="code" href="classPassenger_1_1SystemException.html#ee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>());
-<a name="l00743"></a>00743                 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
-<a name="l00744"></a>00744                         <span class="keywordtype">string</span> message(<span class="stringliteral">"Could not connect to the ApplicationPool server: "</span>);
-<a name="l00745"></a>00745                         message.append(e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
-<a name="l00746"></a>00746                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message);
-<a name="l00747"></a>00747                 }
-<a name="l00748"></a>00748         }
-<a name="l00749"></a>00749         <span class="comment"></span>
-<a name="l00750"></a>00750 <span class="comment">        /**</span>
-<a name="l00751"></a>00751 <span class="comment">         * Detach the server, thereby telling it that we don't want to connect</span>
-<a name="l00752"></a>00752 <span class="comment">         * to it anymore. This frees up some resources in the current process,</span>
-<a name="l00753"></a>00753 <span class="comment">         * such as file descriptors.</span>
-<a name="l00754"></a>00754 <span class="comment">         *</span>
-<a name="l00755"></a>00755 <span class="comment">         * This method is particularily useful to Apache worker processes that</span>
-<a name="l00756"></a>00756 <span class="comment">         * have just established a connection with the ApplicationPool server.</span>
-<a name="l00757"></a>00757 <span class="comment">         * Any sessions that are opened prior to calling detach(), will keep</span>
-<a name="l00758"></a>00758 <span class="comment">         * working even after a detach().</span>
-<a name="l00759"></a>00759 <span class="comment">         *</span>
-<a name="l00760"></a>00760 <span class="comment">         * This method may only be called once. The ApplicationPoolServer object</span>
-<a name="l00761"></a>00761 <span class="comment">         * will become unusable once detach() has been called, so call connect()</span>
-<a name="l00762"></a>00762 <span class="comment">         * before calling detach().</span>
-<a name="l00763"></a>00763 <span class="comment">         */</span>
-<a name="l00764"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#b13957e32ae8ca36ba85f2e6ffefd5ce">00764</a>         <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#b13957e32ae8ca36ba85f2e6ffefd5ce" title="Detach the server, thereby telling it that we don&amp;#39;t want to connect to it anymore...">detach</a>() {
-<a name="l00765"></a>00765                 TRACE_POINT();
-<a name="l00766"></a>00766                 <span class="keywordtype">int</span> ret;
-<a name="l00767"></a>00767                 <span class="keywordflow">do</span> {
-<a name="l00768"></a>00768                         ret = close(serverSocket);
-<a name="l00769"></a>00769                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
-<a name="l00770"></a>00770                 serverSocket = -1;
-<a name="l00771"></a>00771         }
-<a name="l00772"></a>00772 };
-<a name="l00773"></a>00773 
-<a name="l00774"></a>00774 <span class="keyword">typedef</span> shared_ptr&lt;ApplicationPoolServer&gt; ApplicationPoolServerPtr;
-<a name="l00775"></a>00775 
-<a name="l00776"></a>00776 } <span class="comment">// namespace Passenger</span>
-<a name="l00777"></a>00777 
-<a name="l00778"></a>00778 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_APPLICATION_POOL_SERVER_H_ */</span>
+<a name="l00624"></a>00624         }
+<a name="l00625"></a>00625         
+<a name="l00626"></a>00626         <span class="keywordtype">void</span> createStatusReportFIFO() {
+<a name="l00627"></a>00627                 TRACE_POINT();
+<a name="l00628"></a>00628                 <span class="keywordtype">char</span> filename[PATH_MAX];
+<a name="l00629"></a>00629                 <span class="keywordtype">int</span> ret;
+<a name="l00630"></a>00630                 mode_t permissions = S_IRUSR | S_IWUSR;
+<a name="l00631"></a>00631                 
+<a name="l00632"></a>00632                 createPassengerTempDir(<a class="code" href="group__Support.html#g68f4105c5a8e510520b5ea3eecb66213" title="Return the path name for the directory in which the system stores general temporary...">getSystemTempDir</a>(), m_user.empty(),
+<a name="l00633"></a>00633                         <span class="stringliteral">"nobody"</span>, geteuid(), getegid());
+<a name="l00634"></a>00634                 
+<a name="l00635"></a>00635                 snprintf(filename, <span class="keyword">sizeof</span>(filename), <span class="stringliteral">"%s/info/status.fifo"</span>,
+<a name="l00636"></a>00636                                 <a class="code" href="group__Support.html#g69deb6b299b45039dc24b60ad9175541" title="Return the path name for the directory in which Phusion Passenger-specific temporary...">getPassengerTempDir</a>().c_str());
+<a name="l00637"></a>00637                 filename[PATH_MAX - 1] = <span class="charliteral">'\0'</span>;
+<a name="l00638"></a>00638                 <span class="keywordflow">do</span> {
+<a name="l00639"></a>00639                         ret = mkfifo(filename, permissions);
+<a name="l00640"></a>00640                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
+<a name="l00641"></a>00641                 <span class="keywordflow">if</span> (ret == -1 &amp;&amp; errno != EEXIST) {
+<a name="l00642"></a>00642                         <span class="keywordtype">int</span> e = errno;
+<a name="l00643"></a>00643                         P_WARN(<span class="stringliteral">"*** WARNING: Could not create FIFO '"</span> &lt;&lt; filename &lt;&lt;
+<a name="l00644"></a>00644                                 <span class="stringliteral">"': "</span> &lt;&lt; strerror(e) &lt;&lt; <span class="stringliteral">" ("</span> &lt;&lt; e &lt;&lt; <span class="stringliteral">")"</span> &lt;&lt; endl &lt;&lt;
+<a name="l00645"></a>00645                                 <span class="stringliteral">"Disabling Passenger ApplicationPool status reporting."</span>);
+<a name="l00646"></a>00646                         statusReportFIFO = <span class="stringliteral">""</span>;
+<a name="l00647"></a>00647                 } <span class="keywordflow">else</span> {
+<a name="l00648"></a>00648                         statusReportFIFO = filename;
+<a name="l00649"></a>00649                         
+<a name="l00650"></a>00650                         <span class="comment">// It seems that the permissions passed to mkfifo()</span>
+<a name="l00651"></a>00651                         <span class="comment">// aren't respected, so here we chmod the file.</span>
+<a name="l00652"></a>00652                         <span class="keywordflow">do</span> {
+<a name="l00653"></a>00653                                 ret = chmod(filename, permissions);
+<a name="l00654"></a>00654                         } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
+<a name="l00655"></a>00655                         
+<a name="l00656"></a>00656                         <span class="comment">// Set the FIFO's owner according to whether we're running as root</span>
+<a name="l00657"></a>00657                         <span class="comment">// and whether user switching is enabled.</span>
+<a name="l00658"></a>00658                         <span class="keywordflow">if</span> (geteuid() == 0 &amp;&amp; !m_user.empty()) {
+<a name="l00659"></a>00659                                 uid_t uid;
+<a name="l00660"></a>00660                                 gid_t gid;
+<a name="l00661"></a>00661                                 
+<a name="l00662"></a>00662                                 determineLowestUserAndGroup(m_user, uid, gid);
+<a name="l00663"></a>00663                                 <span class="keywordflow">do</span> {
+<a name="l00664"></a>00664                                         ret = chown(filename, uid, gid);
+<a name="l00665"></a>00665                                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
+<a name="l00666"></a>00666                                 <span class="keywordflow">if</span> (errno == -1) {
+<a name="l00667"></a>00667                                         <span class="keywordtype">int</span> e = errno;
+<a name="l00668"></a>00668                                         P_WARN(<span class="stringliteral">"*** WARNING: Unable to set the FIFO file '"</span> &lt;&lt;
+<a name="l00669"></a>00669                                                 filename &lt;&lt; <span class="stringliteral">"' its owner and group to that of user "</span> &lt;&lt;
+<a name="l00670"></a>00670                                                 m_user &lt;&lt; <span class="stringliteral">": "</span> &lt;&lt; strerror(e) &lt;&lt; <span class="stringliteral">" ("</span> &lt;&lt; e &lt;&lt; <span class="stringliteral">")"</span>);
+<a name="l00671"></a>00671                                 }
+<a name="l00672"></a>00672                         }
+<a name="l00673"></a>00673                 }
+<a name="l00674"></a>00674         }
+<a name="l00675"></a>00675 
+<a name="l00676"></a>00676 <span class="keyword">public</span>:<span class="comment"></span>
+<a name="l00677"></a>00677 <span class="comment">        /**</span>
+<a name="l00678"></a>00678 <span class="comment">         * Create a new ApplicationPoolServer object.</span>
+<a name="l00679"></a>00679 <span class="comment">         *</span>
+<a name="l00680"></a>00680 <span class="comment">         * @param serverExecutable The filename of the ApplicationPool server</span>
+<a name="l00681"></a>00681 <span class="comment">         *            executable to use.</span>
+<a name="l00682"></a>00682 <span class="comment">         * @param spawnServerCommand The filename of the spawn server to use.</span>
+<a name="l00683"></a>00683 <span class="comment">         * @param logFile Specify a log file that the spawn server should use.</span>
+<a name="l00684"></a>00684 <span class="comment">         *            Messages on its standard output and standard error channels</span>
+<a name="l00685"></a>00685 <span class="comment">         *            will be written to this log file. If an empty string is</span>
+<a name="l00686"></a>00686 <span class="comment">         *            specified, no log file will be used, and the spawn server</span>
+<a name="l00687"></a>00687 <span class="comment">         *            will use the same standard output/error channels as the</span>
+<a name="l00688"></a>00688 <span class="comment">         *            current process.</span>
+<a name="l00689"></a>00689 <span class="comment">         * @param rubyCommand The Ruby interpreter's command.</span>
+<a name="l00690"></a>00690 <span class="comment">         * @param user The user that the spawn manager should run as. This</span>
+<a name="l00691"></a>00691 <span class="comment">         *             parameter only has effect if the current process is</span>
+<a name="l00692"></a>00692 <span class="comment">         *             running as root. If the empty string is given, or if</span>
+<a name="l00693"></a>00693 <span class="comment">         *             the &lt;tt&gt;user&lt;/tt&gt; is not a valid username, then</span>
+<a name="l00694"></a>00694 <span class="comment">         *             the spawn manager will be run as the current user.</span>
+<a name="l00695"></a>00695 <span class="comment">         * @throws SystemException An error occured while trying to setup the spawn server</span>
+<a name="l00696"></a>00696 <span class="comment">         *            or the server socket.</span>
+<a name="l00697"></a>00697 <span class="comment">         * @throws IOException The specified log file could not be opened.</span>
+<a name="l00698"></a>00698 <span class="comment">         */</span>
+<a name="l00699"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#2203db62a022579d569ceddff8ef6ca9">00699</a>         <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#2203db62a022579d569ceddff8ef6ca9" title="Create a new ApplicationPoolServer object.">ApplicationPoolServer</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;serverExecutable,
+<a name="l00700"></a>00700                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;spawnServerCommand,
+<a name="l00701"></a>00701                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;logFile = <span class="stringliteral">""</span>,
+<a name="l00702"></a>00702                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;rubyCommand = <span class="stringliteral">"ruby"</span>,
+<a name="l00703"></a>00703                      <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;user = <span class="stringliteral">""</span>)
+<a name="l00704"></a>00704         : m_serverExecutable(serverExecutable),
+<a name="l00705"></a>00705           m_spawnServerCommand(spawnServerCommand),
+<a name="l00706"></a>00706           m_logFile(logFile),
+<a name="l00707"></a>00707           m_rubyCommand(rubyCommand),
+<a name="l00708"></a>00708           m_user(user) {
+<a name="l00709"></a>00709                 TRACE_POINT();
+<a name="l00710"></a>00710                 serverSocket = -1;
+<a name="l00711"></a>00711                 serverPid = 0;
+<a name="l00712"></a>00712                 this_thread::disable_syscall_interruption dsi;
+<a name="l00713"></a>00713                 restartServer();
+<a name="l00714"></a>00714         }
+<a name="l00715"></a>00715         
+<a name="l00716"></a>00716         ~<a class="code" href="classPassenger_1_1ApplicationPoolServer.html" title="Multi-process usage support for ApplicationPool.">ApplicationPoolServer</a>() {
+<a name="l00717"></a>00717                 TRACE_POINT();
+<a name="l00718"></a>00718                 <span class="keywordflow">if</span> (serverSocket != -1) {
+<a name="l00719"></a>00719                         UPDATE_TRACE_POINT();
+<a name="l00720"></a>00720                         this_thread::disable_syscall_interruption dsi;
+<a name="l00721"></a>00721                         shutdownServer();
+<a name="l00722"></a>00722                 }
+<a name="l00723"></a>00723         }
+<a name="l00724"></a>00724         <span class="comment"></span>
+<a name="l00725"></a>00725 <span class="comment">        /**</span>
+<a name="l00726"></a>00726 <span class="comment">         * Connects to the server and returns a usable ApplicationPool object.</span>
+<a name="l00727"></a>00727 <span class="comment">         * All cache/pool data of this ApplicationPool is actually stored on</span>
+<a name="l00728"></a>00728 <span class="comment">         * the server and shared with other clients, but that is totally</span>
+<a name="l00729"></a>00729 <span class="comment">         * transparent to the user of the ApplicationPool object.</span>
+<a name="l00730"></a>00730 <span class="comment">         *</span>
+<a name="l00731"></a>00731 <span class="comment">         * @note</span>
+<a name="l00732"></a>00732 <span class="comment">         *   All methods of the returned ApplicationPool object may throw</span>
+<a name="l00733"></a>00733 <span class="comment">         *   SystemException, IOException or boost::thread_interrupted.</span>
+<a name="l00734"></a>00734 <span class="comment">         *</span>
+<a name="l00735"></a>00735 <span class="comment">         * @warning</span>
+<a name="l00736"></a>00736 <span class="comment">         * One may only use the returned ApplicationPool object for handling</span>
+<a name="l00737"></a>00737 <span class="comment">         * one session at a time. For example, don't do stuff like this:</span>
+<a name="l00738"></a>00738 <span class="comment">         * @code</span>
+<a name="l00739"></a>00739 <span class="comment">         *   ApplicationPoolPtr pool = server.connect();</span>
+<a name="l00740"></a>00740 <span class="comment">         *   Application::SessionPtr session1 = pool-&gt;get(...);</span>
+<a name="l00741"></a>00741 <span class="comment">         *   Application::SessionPtr session2 = pool-&gt;get(...);</span>
+<a name="l00742"></a>00742 <span class="comment">         * @endcode</span>
+<a name="l00743"></a>00743 <span class="comment">         * Otherwise, a deadlock can occur under certain circumstances.</span>
+<a name="l00744"></a>00744 <span class="comment">         * @warning</span>
+<a name="l00745"></a>00745 <span class="comment">         * Instead, one should call connect() multiple times:</span>
+<a name="l00746"></a>00746 <span class="comment">         * @code</span>
+<a name="l00747"></a>00747 <span class="comment">         *   ApplicationPoolPtr pool1 = server.connect();</span>
+<a name="l00748"></a>00748 <span class="comment">         *   Application::SessionPtr session1 = pool1-&gt;get(...);</span>
+<a name="l00749"></a>00749 <span class="comment">         *   </span>
+<a name="l00750"></a>00750 <span class="comment">         *   ApplicationPoolPtr pool2 = server.connect();</span>
+<a name="l00751"></a>00751 <span class="comment">         *   Application::SessionPtr session2 = pool2-&gt;get(...);</span>
+<a name="l00752"></a>00752 <span class="comment">         * @endcode</span>
+<a name="l00753"></a>00753 <span class="comment">         *</span>
+<a name="l00754"></a>00754 <span class="comment">         * @throws SystemException Something went wrong.</span>
+<a name="l00755"></a>00755 <span class="comment">         * @throws IOException Something went wrong.</span>
+<a name="l00756"></a>00756 <span class="comment">         */</span>
+<a name="l00757"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#18f77057cc28e7924a8f4d1397aa0468">00757</a>         ApplicationPoolPtr <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#18f77057cc28e7924a8f4d1397aa0468" title="Connects to the server and returns a usable ApplicationPool object.">connect</a>() {
+<a name="l00758"></a>00758                 TRACE_POINT();
+<a name="l00759"></a>00759                 <span class="keywordflow">try</span> {
+<a name="l00760"></a>00760                         this_thread::disable_syscall_interruption dsi;
+<a name="l00761"></a>00761                         <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel(serverSocket);
+<a name="l00762"></a>00762                         <span class="keywordtype">int</span> clientConnection;
+<a name="l00763"></a>00763                         
+<a name="l00764"></a>00764                         <span class="comment">// Write some random data to wake up the server.</span>
+<a name="l00765"></a>00765                         channel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(<span class="stringliteral">"x"</span>, 1);
+<a name="l00766"></a>00766                         
+<a name="l00767"></a>00767                         clientConnection = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
+<a name="l00768"></a>00768                         <span class="keywordflow">return</span> <a class="code" href="group__Support.html#g41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(<span class="keyword">new</span> Client(clientConnection));
+<a name="l00769"></a>00769                 } <span class="keywordflow">catch</span> (<span class="keyword">const</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> &amp;e) {
+<a name="l00770"></a>00770                         <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>(<span class="stringliteral">"Could not connect to the ApplicationPool server"</span>, e.<a class="code" href="classPassenger_1_1SystemException.html#ee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>());
+<a name="l00771"></a>00771                 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
+<a name="l00772"></a>00772                         <span class="keywordtype">string</span> message(<span class="stringliteral">"Could not connect to the ApplicationPool server: "</span>);
+<a name="l00773"></a>00773                         message.append(e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
+<a name="l00774"></a>00774                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message);
+<a name="l00775"></a>00775                 }
+<a name="l00776"></a>00776         }
+<a name="l00777"></a>00777         <span class="comment"></span>
+<a name="l00778"></a>00778 <span class="comment">        /**</span>
+<a name="l00779"></a>00779 <span class="comment">         * Detach the server, thereby telling it that we don't want to connect</span>
+<a name="l00780"></a>00780 <span class="comment">         * to it anymore. This frees up some resources in the current process,</span>
+<a name="l00781"></a>00781 <span class="comment">         * such as file descriptors.</span>
+<a name="l00782"></a>00782 <span class="comment">         *</span>
+<a name="l00783"></a>00783 <span class="comment">         * This method is particularily useful to Apache worker processes that</span>
+<a name="l00784"></a>00784 <span class="comment">         * have just established a connection with the ApplicationPool server.</span>
+<a name="l00785"></a>00785 <span class="comment">         * Any sessions that are opened prior to calling detach(), will keep</span>
+<a name="l00786"></a>00786 <span class="comment">         * working even after a detach().</span>
+<a name="l00787"></a>00787 <span class="comment">         *</span>
+<a name="l00788"></a>00788 <span class="comment">         * This method may only be called once. The ApplicationPoolServer object</span>
+<a name="l00789"></a>00789 <span class="comment">         * will become unusable once detach() has been called, so call connect()</span>
+<a name="l00790"></a>00790 <span class="comment">         * before calling detach().</span>
+<a name="l00791"></a>00791 <span class="comment">         */</span>
+<a name="l00792"></a><a class="code" href="classPassenger_1_1ApplicationPoolServer.html#b13957e32ae8ca36ba85f2e6ffefd5ce">00792</a>         <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1ApplicationPoolServer.html#b13957e32ae8ca36ba85f2e6ffefd5ce" title="Detach the server, thereby telling it that we don&amp;#39;t want to connect to it anymore...">detach</a>() {
+<a name="l00793"></a>00793                 TRACE_POINT();
+<a name="l00794"></a>00794                 <span class="keywordtype">int</span> ret;
+<a name="l00795"></a>00795                 <span class="keywordflow">do</span> {
+<a name="l00796"></a>00796                         ret = close(serverSocket);
+<a name="l00797"></a>00797                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
+<a name="l00798"></a>00798                 serverSocket = -1;
+<a name="l00799"></a>00799         }
+<a name="l00800"></a>00800 };
+<a name="l00801"></a>00801 
+<a name="l00802"></a>00802 <span class="keyword">typedef</span> shared_ptr&lt;ApplicationPoolServer&gt; ApplicationPoolServerPtr;
+<a name="l00803"></a>00803 
+<a name="l00804"></a>00804 } <span class="comment">// namespace Passenger</span>
+<a name="l00805"></a>00805 
+<a name="l00806"></a>00806 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_APPLICATION_POOL_SERVER_H_ */</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 13 19:24:32 2009 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Mar 31 14:00:27 2009 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
 </body>