coar 97/04/22 05:05:53
Modified: htdocs/manual/misc FAQ.html
Log:
Added Q&A section on "where's the dump?".
Revision Changes Path
1.40 +46 -13 apache/htdocs/manual/misc/FAQ.html
Index: FAQ.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/misc/FAQ.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -C3 -r1.39 -r1.40
*** FAQ.html 1997/04/22 11:20:04 1.39
--- FAQ.html 1997/04/22 12:05:52 1.40
***************
*** 8,14 ****
<!--#include virtual="header.html" -->
<H1>Apache Server Frequently Asked Questions</H1>
<P>
! $Revision: 1.39 $ ($Date: 1997/04/22 11:20:04 $)
</P>
<P>
The latest version of this FAQ is always available from the main
--- 8,14 ----
<!--#include virtual="header.html" -->
<H1>Apache Server Frequently Asked Questions</H1>
<P>
! $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,35 ****
REL="Help"
><SAMP>http://www.apache.org/docs/misc/FAQ</SAMP></A>>.
</P>
! <!-- 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). -->
<!-- - 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. -->
</P>
<P>
If you are reading a text-only version of this FAQ, you may find numbers
--- 18,35 ----
REL="Help"
><SAMP>http://www.apache.org/docs/misc/FAQ</SAMP></A>>.
</P>
! <!-- 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). -->
<!-- - 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. -->
</P>
<P>
If you are reading a text-only version of this FAQ, you may find numbers
***************
*** 98,104 ****
</LI>
<LI><A HREF="#premature-script-headers">What does it mean when my
CGIs fail with "<SAMP>Premature end of script
! headers</SAMP>"?</A>
</LI>
<LI><A HREF="#ssi-part-i">How do I enable SSI (parsed HTML)?</A>
</LI>
--- 98,104 ----
</LI>
<LI><A HREF="#premature-script-headers">What does it mean when my
CGIs fail with "<SAMP>Premature end of script
! headers</SAMP>"?</A>
</LI>
<LI><A HREF="#ssi-part-i">How do I enable SSI (parsed HTML)?</A>
</LI>
***************
*** 148,153 ****
--- 148,156 ----
<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,1047 ****
</UL>
</P>
<HR>
<!-- Don't forget to add HR tags at the end of each list item.. -->
! </LI>
</OL>
<!--#include virtual="footer.html" -->
</BODY>
--- 1043,1080 ----
</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>
</OL>
<!--#include virtual="footer.html" -->
</BODY>
Modified: htdocs/manual/misc FAQ.html
Log:
Added Q&A section on "where's the dump?".
Revision Changes Path
1.40 +46 -13 apache/htdocs/manual/misc/FAQ.html
Index: FAQ.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/misc/FAQ.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -C3 -r1.39 -r1.40
*** FAQ.html 1997/04/22 11:20:04 1.39
--- FAQ.html 1997/04/22 12:05:52 1.40
***************
*** 8,14 ****
<!--#include virtual="header.html" -->
<H1>Apache Server Frequently Asked Questions</H1>
<P>
! $Revision: 1.39 $ ($Date: 1997/04/22 11:20:04 $)
</P>
<P>
The latest version of this FAQ is always available from the main
--- 8,14 ----
<!--#include virtual="header.html" -->
<H1>Apache Server Frequently Asked Questions</H1>
<P>
! $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,35 ****
REL="Help"
><SAMP>http://www.apache.org/docs/misc/FAQ</SAMP></A>>.
</P>
! <!-- 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). -->
<!-- - 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. -->
</P>
<P>
If you are reading a text-only version of this FAQ, you may find numbers
--- 18,35 ----
REL="Help"
><SAMP>http://www.apache.org/docs/misc/FAQ</SAMP></A>>.
</P>
! <!-- 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). -->
<!-- - 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. -->
</P>
<P>
If you are reading a text-only version of this FAQ, you may find numbers
***************
*** 98,104 ****
</LI>
<LI><A HREF="#premature-script-headers">What does it mean when my
CGIs fail with "<SAMP>Premature end of script
! headers</SAMP>"?</A>
</LI>
<LI><A HREF="#ssi-part-i">How do I enable SSI (parsed HTML)?</A>
</LI>
--- 98,104 ----
</LI>
<LI><A HREF="#premature-script-headers">What does it mean when my
CGIs fail with "<SAMP>Premature end of script
! headers</SAMP>"?</A>
</LI>
<LI><A HREF="#ssi-part-i">How do I enable SSI (parsed HTML)?</A>
</LI>
***************
*** 148,153 ****
--- 148,156 ----
<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,1047 ****
</UL>
</P>
<HR>
<!-- Don't forget to add HR tags at the end of each list item.. -->
! </LI>
</OL>
<!--#include virtual="footer.html" -->
</BODY>
--- 1043,1080 ----
</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>
</OL>
<!--#include virtual="footer.html" -->
</BODY>