From: André Malo <nd@apache.org>
Date: Sat, 17 May 2003 19:32:02 +0000 (+0000)
Subject: Try a better explanation of core dump issues on Linux
X-Git-Tag: pre_ajp_proxy~1672
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2daad4d628a42f27e7cfe1e7171d0d36a09b3b0e;p=thirdparty%2Fapache%2Fhttpd.git

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 7838168afed..ce1785b88f2 100644
--- 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 80aaac94ba4..c007c1f3894 100644
--- 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>