From: Paul J. Reder <rederpj@apache.org>
Date: Wed, 25 Jun 2003 17:25:34 +0000 (+0000)
Subject: Added a warning to the AcceptMutex directive documentation indicating
X-Git-Tag: pre_ajp_proxy~1511
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=745afde49ab26bc99a78a799468447b32152bdbc;p=apache

Added a warning to the AcceptMutex directive documentation indicating
that the pthread option can result in a non-responsive server on
systems that can't reclaim a locked mutex from the segfaulted child
holding it. [Paul J. Reder]


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@100358 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml
index c007c1f389..ac6ba7da41 100644
--- a/docs/manual/mod/mpm_common.xml
+++ b/docs/manual/mod/mpm_common.xml
@@ -62,6 +62,22 @@ accepting requests on network sockets</description>
     >LogLevel</directive> to <code>debug</code>. Then the default <directive
     >AcceptMutex</directive> will be written into the <directive
     module="core">ErrorLog</directive>.</p>
+
+  <note type="warning"><strong>Warning:</strong>
+     <p>On most systems, when the <code>pthread</code> option
+     is selected, if a child process terminates abnormally
+     while holding the <code>AcceptCntl</code> mutex the
+     server will stop responding to requests. When this
+     occurs, the server will require a manual restart to
+     recover.</p>
+     <p>Solaris is a notable exception as it provides a
+     mechanism, used by Apache, which usually allows the
+     mutex to be recovered after a child process terminates
+     abnormally while holding a mutex.</p>
+     <p>If your system implements the
+     <code>pthread_mutexattr_setrobust_np()</code> function,
+     you may be able to use the <code>pthread</code> option safely.</p>
+  </note>
 </usage>
 </directivesynopsis>