From 0235dbf1b462a30ec39a7cd852f49b6c1ccf3b39 Mon Sep 17 00:00:00 2001
From: Eric Covener <covener@apache.org>
Date: Sun, 9 Jan 2011 23:04:56 +0000
Subject: [PATCH] warn about FAQ of trying to decrease thread stack size with
 ThreadStackSize on Linux.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1057049 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mpm_common.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml
index 602195335c..16ac26606b 100644
--- a/docs/manual/mod/mpm_common.xml
+++ b/docs/manual/mod/mpm_common.xml
@@ -741,6 +741,12 @@ client connections</description>
       The minimum required stack size strongly depends on the modules
       used, but any change in the web server configuration can invalidate
       the current <directive>ThreadStackSize</directive> setting.</li>
+
+      <li>On Linux, this directive can only be used to increase the default
+      stack size, as the underlying system call uses the value as a 
+      <em>minimum</em> stack size.  The (often large) soft limit for 
+      <code>ulimit -s</code> (8MB if unlimited) is used as the default stack 
+      size.</li>
     </ul>
 
     <note>It is recommended to not reduce <directive>ThreadStackSize</directive>
-- 
2.50.1