Added Q&A section on "where's the dump?".

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

diff --git a/docs/manual/misc/FAQ.html b/docs/manual/misc/FAQ.html
index a8babca533bf898dfeaf218882d42a483bea2c97..c423040e2b90d5198cb40b1b5618b868ba5378c7 100644 (file)
--- a/docs/manual/misc/FAQ.html
+++ b/docs/manual/misc/FAQ.html
@@ -8,7 +8,7 @@
   <!--#include virtual="header.html" -->
   <H1>Apache Server Frequently Asked Questions</H1>
   <P>
-  $Revision: 1.39 $ ($Date: 1997/04/22 11:20:04 $)
+  $Revision: 1.40 $ ($Date: 1997/04/22 12:05:52 $)
   </P>
   <P>
   The latest version of this FAQ is always available from the main
@@ -18,18 +18,18 @@
        REL="Help"
       ><SAMP>http://www.apache.org/docs/misc/FAQ</SAMP></A>&gt;.
   </P>
-<!-- Notes about changes:                                          -->
-<!--  - If adding a relative link to another part of the           -->
+<!-- Notes about changes:                                           -->
+<!--  - If adding a relative link to another part of the            -->
 <!--    documentation, *do* include the ".html" portion.  There's a -->
-<!--   good chance that the user will be reading the documentation -->
-<!--   on his own system, which may not be configured for          -->
-<!--   multiviews.   Leave off the ".html" extension for absolute  -->
-<!--   links to sites which are known to run multiviews (e.g.,     -->
-<!--   apache.or or apacheweek.com).                               -->
+<!--    good chance that the user will be reading the documentation -->
+<!--    on his own system, which may not be configured for          -->
+<!--    multiviews.   Leave off the ".html" extension for absolute  -->
+<!--    links to sites which are known to run multiviews (e.g.,     -->
+<!--    apache.or or apacheweek.com).                               -->
 <!--  - When adding items, make sure they're put in the right place -->
-<!--    - verify that the numbering matches up.                            -->
-<!--  - Don't forget to include an HR tag after the last /P tag            -->
-<!--    but before the /LI in an item.                             -->
+<!--    - verify that the numbering matches up.                     -->
+<!--  - Don't forget to include an HR tag after the last /P tag     -->
+<!--    but before the /LI in an item.                              -->
   </P>
   <P>
   If you are reading a text-only version of this FAQ, you may find numbers
@@ -98,7 +98,7 @@
    </LI>
    <LI><A HREF="#premature-script-headers">What does it mean when my
         CGIs fail with &quot;<SAMP>Premature end of script
-       headers</SAMP>&quot;?</A> 
+        headers</SAMP>&quot;?</A> 
    </LI>
    <LI><A HREF="#ssi-part-i">How do I enable SSI (parsed HTML)?</A>
    </LI>
@@ -148,6 +148,9 @@
    <LI><A HREF="#linuxiovec">Why do I get complaints about redefinition
     of `struct iovec' when compiling under Linux?</A>
    </LI>
+   <LI><A HREF="#wheres-the-dump">The errorlog says Apache dumped core,
+    but where's the dump file?</A>
+   </LI>
   </OL>
  </LI>
 </UL>
@@ -1040,8 +1043,38 @@
   </UL>
   </P>
   <HR>
+ </LI>
+ <LI><A NAME="wheres-the-dump">
+      <STRONG>The errorlog says Apache dumped core, but where's the dump
+      file?</STRONG>
+     </A>
+  <P>
+  In Apache version 1.2 (beginning with 1.2b8), the error log message
+  about dumped core includes the directory where the dump file should be
+  located.  However, some operating systems regard the dumping of core
+  by processes with superuser authority as a potential security issue,
+  and short-circuit the dump code, leaving no file.  Since most Web
+  servers listen on port 80 (a privileged port), they need to run with
+  superuser authority, and so this short-circuit will apply to them.
+  </P>
+  <P>
+  Dealing with this is extremely operating system-specific, and may
+  require rebuilding your system kernel.  Consult your operating system
+  documentation or vendor for more information about whether your system
+  does this and how to bypass it.  If there <EM>is</EM> a documented way
+  of bypassing it, it is recommended that you bypass it only for the
+  <SAMP>httpd</SAMP> server process if possible.
+  </P>
+  <P>
+  The canonical location for Apache's core-dump files is the
+  <A
+   HREF="../mod/core.html#serverrot"
+  >ServerRoot</A>
+  directory.
+  </P>
+  <HR>
   <!-- Don't forget to add HR tags at the end of each list item.. -->
-  </LI>
+ </LI>
 </OL>
  <!--#include virtual="footer.html" -->
 </BODY>