Return-Path: 
 <cvs-return-16324-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 73602 invoked by uid 500); 25 Jun 2003 17:25:36 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
list-post: <mailto:cvs@httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 73574 invoked by uid 500); 25 Jun 2003 17:25:35 -0000
Delivered-To: apmail-httpd-2.0-cvs@apache.org
Date: 25 Jun 2003 17:25:34 -0000
Message-ID: <20030625172534.89378.qmail@icarus.apache.org>
From: rederpj@apache.org
To: httpd-2.0-cvs@apache.org
Subject: cvs commit: httpd-2.0/docs/manual/mod mpm_common.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

rederpj     2003/06/25 10:25:34

  Modified:    docs/manual/mod mpm_common.xml
  Log:
  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]
  
  Revision  Changes    Path
  1.30      +16 -0     httpd-2.0/docs/manual/mod/mpm_common.xml
  
  Index: mpm_common.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mpm_common.xml,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -r1.29 -r1.30
  --- mpm_common.xml	17 May 2003 19:32:02 -0000	1.29
  +++ mpm_common.xml	25 Jun 2003 17:25:34 -0000	1.30
  @@ -62,6 +62,22 @@
       >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>