try a better explanation of coredump enabling on linux

Reviewed by: Astrid Ke�ler

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

diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en
index c8b59f64748c747856dbe543ce3ef0e173204ae1..3105ddd15e1566fc75f9222350aa121ede508231 100644 (file)
--- a/docs/manual/mod/mpm_common.html.en
+++ b/docs/manual/mod/mpm_common.html.en
@@ -148,6 +148,13 @@ switch before dumping core</td></tr>
     dump for debugging, you can use this directive to place it in a
     different location.</p>
 
+    <div class="note"><h3>Core Dumps on Linux</h3>
+      <p>If Apache starts as root and switches to another user, the
+      Linux kernel <em>disables</em> core dumps even if the directory is
+      writable for the process. Apache (2.0.46 and later) reenables core dumps
+      on Linux 2.4 and beyond, but only if you explicitly configure a <code class="directive">CoreDumpDirectory</code>.</p>
+    </div>
+
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="Group" id="Group">Group</a> <a name="group" id="group">Directive</a></h2>

diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml
index 06f830a6eb18ada42a74d36c589f98c5e3cd935c..546f3e7ecf01420350106062aa76968300d923be 100644 (file)
--- a/docs/manual/mod/mpm_common.xml
+++ b/docs/manual/mod/mpm_common.xml
@@ -110,6 +110,14 @@ switch before dumping core</description>
     as, core dumps won't normally get written. If you want a core
     dump for debugging, you can use this directive to place it in a
     different location.</p>
+
+    <note><title>Core Dumps on Linux</title>
+      <p>If Apache starts as root and switches to another user, the
+      Linux kernel <em>disables</em> core dumps even if the directory is
+      writable for the process. Apache (2.0.46 and later) reenables core dumps
+      on Linux 2.4 and beyond, but only if you explicitly configure a <directive
+      >CoreDumpDirectory</directive>.</p>
+    </note>
 </usage>
 </directivesynopsis>