From 2daad4d628a42f27e7cfe1e7171d0d36a09b3b0e Mon Sep 17 00:00:00 2001
From: =?utf8?q?Andr=C3=A9=20Malo?= <nd@apache.org>
Date: Sat, 17 May 2003 19:32:02 +0000
Subject: [PATCH] Try a better explanation of core dump issues on Linux
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

Reviewed by: Astrid Ke�ler


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@99900 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mpm_common.html.en | 10 +++++++---
 docs/manual/mod/mpm_common.xml     | 11 ++++++++---
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en
index 7838168afe..ce1785b88f 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 80aaac94ba..c007c1f389 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>
 
-- 
2.50.1