Try a better explanation of core dump issues on Linux

Reviewed by: Astrid Ke�ler

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

diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en
index 7838168afed36fff31f4fa70fbedb90d29786f7c..ce1785b88f2b6d48886b46a62c178ef8c86d1998 100644 (file)
--- a/docs/manual/mod/mpm_common.html.en
+++ b/docs/manual/mod/mpm_common.html.en
@@ -120,9 +120,13 @@ switch before dumping core</td></tr>
     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>
-    <p>Linux 2.4 and beyond: If you start Apache as <code>root</code> and you
-    explicitly configure <code class="directive">CoreDumpDirectory</code>, Apache
-    enables core dumps.</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>

diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml
index 80aaac94ba48e01c3752ffe8e7c6b3acfc73bd81..c007c1f3894a298289cb063064c2b9ec5de7d064 100644 (file)
--- a/docs/manual/mod/mpm_common.xml
+++ b/docs/manual/mod/mpm_common.xml
@@ -84,9 +84,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>
-    <p>Linux 2.4 and beyond: If you start Apache as <code>root</code> and you
-    explicitly configure <directive>CoreDumpDirectory</directive>, Apache
-    enables core dumps.</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>