You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by nd...@apache.org on 2004/03/15 21:45:59 UTC
cvs commit: httpd-2.0/docs/manual/mod leader.xml mpm_common.xml perchild.xml prefork.xml threadpool.xml worker.xml
nd 2004/03/15 12:45:59
Modified: docs/manual/mod leader.xml mpm_common.xml perchild.xml
prefork.xml threadpool.xml worker.xml
Log:
add initial documentation for EnableExceptionHook. Please review.
Revision Changes Path
1.7 +2 -0 httpd-2.0/docs/manual/mod/leader.xml
Index: leader.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/leader.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -u -r1.6 -r1.7
--- leader.xml 13 Mar 2004 14:07:40 -0000 1.6
+++ leader.xml 15 Mar 2004 20:45:58 -0000 1.7
@@ -55,6 +55,8 @@
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
</directivesynopsis>
+<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
+</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Group</name>
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Listen</name>
1.37 +25 -0 httpd-2.0/docs/manual/mod/mpm_common.xml
Index: mpm_common.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mpm_common.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -u -r1.36 -r1.37
--- mpm_common.xml 13 Mar 2004 14:07:40 -0000 1.36
+++ mpm_common.xml 15 Mar 2004 20:45:58 -0000 1.37
@@ -129,6 +129,31 @@
</directivesynopsis>
<directivesynopsis>
+<name>EnableExceptionHook</name>
+<description>Enable the fatal exception handler after a crash</description>
+<syntax>EnableExceptionHook On|Off</syntax>
+<default>EnableExceptionHook Off</default>
+<contextlist><context>server config</context></contextlist>
+<modulelist><module>leader</module><module>perchild</module>
+<module>prefork</module><module>threadpool</module>
+<module>worker</module></modulelist>
+<compatibility>Available in version 2.0.49 an later</compatibility>
+
+<usage>
+ <p>For safety reasons this directive is only available if the server was
+ configured with the <code>--enable-exception-hook</code> option. It
+ enables a hook that allows external modules to plug in and do something
+ after a child crashed.</p>
+
+ <p>There are already two modules, <code>mod_whatkilledus</code> and
+ <code>mod_backtrace</code> that make use of this hook. Please have a
+ look at Jeff Trawick's <a
+ href="http://www.apache.org/~trawick/exception_hook.html"
+ >EnableExceptionHook site</a> for more information about these.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
<name>Group</name>
<description>Group under which the server will answer
requests</description>
1.13 +2 -0 httpd-2.0/docs/manual/mod/perchild.xml
Index: perchild.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/perchild.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -u -r1.12 -r1.13
--- perchild.xml 13 Mar 2004 14:07:40 -0000 1.12
+++ perchild.xml 15 Mar 2004 20:45:58 -0000 1.13
@@ -144,6 +144,8 @@
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
</directivesynopsis>
+<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
+</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Group</name>
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>PidFile</name>
1.15 +2 -0 httpd-2.0/docs/manual/mod/prefork.xml
Index: prefork.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/prefork.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -u -r1.14 -r1.15
--- prefork.xml 9 Feb 2004 20:16:08 -0000 1.14
+++ prefork.xml 15 Mar 2004 20:45:58 -0000 1.15
@@ -85,6 +85,8 @@
<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
</directivesynopsis>
+<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
+</directivesynopsis>
<directivesynopsis location="mpm_common"><name>PidFile</name>
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Listen</name>
1.6 +2 -0 httpd-2.0/docs/manual/mod/threadpool.xml
Index: threadpool.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/threadpool.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -u -r1.5 -r1.6
--- threadpool.xml 13 Mar 2004 14:07:40 -0000 1.5
+++ threadpool.xml 15 Mar 2004 20:45:58 -0000 1.6
@@ -50,6 +50,8 @@
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
</directivesynopsis>
+<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
+</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Group</name>
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Listen</name>
1.16 +2 -0 httpd-2.0/docs/manual/mod/worker.xml
Index: worker.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/worker.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -u -r1.15 -r1.16
--- worker.xml 13 Mar 2004 14:07:40 -0000 1.15
+++ worker.xml 15 Mar 2004 20:45:58 -0000 1.16
@@ -141,6 +141,8 @@
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
</directivesynopsis>
+<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
+</directivesynopsis>
<directivesynopsis location="mpm_common"><name>Group</name>
</directivesynopsis>
<directivesynopsis location="mpm_common"><name>PidFile</name>
Re: cvs commit: httpd-2.0/docs/manual/mod leader.xml mpm_common.xml
perchild.xml prefork.xml threadpool.xml worker.xml
Posted by Jeff Trawick <tr...@attglobal.net>.
nd@apache.org wrote:
> nd 2004/03/15 12:45:59
>
> Modified: docs/manual/mod leader.xml mpm_common.xml perchild.xml
> prefork.xml threadpool.xml worker.xml
> Log:
> add initial documentation for EnableExceptionHook. Please review.
> Index: mpm_common.xml
> ===================================================================
> RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mpm_common.xml,v
> retrieving revision 1.36
> retrieving revision 1.37
> diff -u -u -r1.36 -r1.37
> --- mpm_common.xml 13 Mar 2004 14:07:40 -0000 1.36
> +++ mpm_common.xml 15 Mar 2004 20:45:58 -0000 1.37
> @@ -129,6 +129,31 @@
> </directivesynopsis>
>
> <directivesynopsis>
> +<name>EnableExceptionHook</name>
> +<description>Enable the fatal exception handler after a crash</description>
> +<syntax>EnableExceptionHook On|Off</syntax>
> +<default>EnableExceptionHook Off</default>
> +<contextlist><context>server config</context></contextlist>
> +<modulelist><module>leader</module><module>perchild</module>
> +<module>prefork</module><module>threadpool</module>
> +<module>worker</module></modulelist>
> +<compatibility>Available in version 2.0.49 an later</compatibility>
s/an/and/
(I'll be happy to fix if still broken in the a.m.)
looks more than good enough for now... note that I will finish getting
mod_backtrace and mod_whatkilledus in sync with the 1.3.30 versions pretty soon
and want to then put them in 2.1-dev experimental, at which time I'll revisit
the text