Commit 86b27f2d authored by Jim Jagielski's avatar Jim Jagielski
Browse files

And now the docs for ExtendedStatus 


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

docs/manual/misc/perf-tuning.html

+8 −8
Changes for docs/manual/misc/perf-tuning.html: 8 added lines, 8 removed lines.
Original line number Diff line number Diff line
@@ -227,16 +227,16 @@ In no event should you raise this above about 60 seconds, as 


<H3>Compile-Time Configuration Issues</H3>



<H4>mod_status and Rule STATUS=yes</H4>

<H4>mod_status and ExtendedStatus On</H4>



<P>If you include <CODE>mod_status</CODE>

and you also set <CODE>Rule STATUS=yes</CODE> when building

and you also set <CODE>ExtendedStatus On</CODE> when building and running

Apache, then on every request Apache will perform two calls to

<CODE>gettimeofday(2)</CODE> (or <CODE>times(2)</CODE> depending

on your operating system), and (pre-1.3) several extra calls to

<CODE>time(2)</CODE>.  This is all done so that the status report

contains timing indications.  For highest performance, set <CODE>Rule

STATUS=no</CODE>.

contains timing indications.  For highest performance, set

<CODE>ExtendedStatus off</CODE> (which is the default).



<H4>accept Serialization - multiple sockets</H4>
@@ -660,7 +660,7 @@ end of the request. A custom logging module could eliminate one of the 
calls.  Or you can use a method which moves the time into shared memory,

see the <A HREF="#patches">patches section below</A>.



<P>As described earlier, <CODE>Rule STATUS=yes</CODE> causes two

<P>As described earlier, <CODE>ExtendedStatus On</CODE> causes two

<CODE>gettimeofday</CODE> calls and a call to <CODE>times</CODE>:



<BLOCKQUOTE><PRE>
@@ -670,8 +670,8 @@ gettimeofday({873959960, 417742}, NULL) = 0 
times({tms_utime=5, tms_stime=0, tms_cutime=0, tms_cstime=0}) = 446747

</PRE></BLOCKQUOTE>



These can be removed by either removing <CODE>mod_status</CODE> or

setting <CODE>Rule STATUS=no</CODE>.

These can be removed by setting <CODE>ExtendedStatus Off</CODE> (which

is the default).



<P>It might seem odd to call <CODE>stat</CODE>:
@@ -766,7 +766,7 @@ which were described earlier. 


<P>Let's apply some of these optimizations:

<CODE>-DSINGLE_LISTEN_UNSERIALIZED_ACCEPT -DBUFFERED_LOGS</CODE> and

<CODE>Rule STATUS=no</CODE>.  Here's the final trace:

<CODE>ExtendedStatus Off</CODE>.  Here's the final trace:



<BLOCKQUOTE><PRE>

accept(15, {sin_family=AF_INET, sin_port=htons(22286), sin_addr=inet_addr("127.0.0.1")}, [16]) = 3

docs/manual/mod/core.html

+35 −0
Changes for docs/manual/mod/core.html: 35 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -38,6 +38,7 @@ always available. 
<LI><A HREF="#documentroot">DocumentRoot</A>

<LI><A HREF="#errordocument">ErrorDocument</A>

<LI><A HREF="#errorlog">ErrorLog</A>

<LI><A HREF="#extendedstatus">ExtendedStatus</A>

<LI><A HREF="#files">&lt;Files&gt;</A>

<LI><A HREF="#filesmatch">&lt;FilesMatch&gt;</A>

<LI><A HREF="#group">Group</A>
@@ -845,6 +846,40 @@ than the user that starts the server. 
<P><STRONG>See also:</STRONG> <A HREF="#loglevel">LogLevel</A>

<P><HR>



<H2><A NAME="extendedstatus">ExtendedStatus directive</A></H2>

<!--%plaintext &lt;?INDEX {\tt ExtendedStatus} directive&gt; -->

<A

 HREF="directive-dict.html#Syntax"

 REL="Help"

><STRONG>Syntax:</STRONG></A> ExtendedStatus <EM>On|Off</EM><BR>

<A

 HREF="directive-dict.html#Default"

 REL="Help"

><STRONG>Default:</STRONG></A> <CODE>ExtendedStatus Off</CODE><BR>

<A

 HREF="directive-dict.html#Context"

 REL="Help"

><STRONG>Context:</STRONG></A> server config <BR>

<A

 HREF="directive-dict.html#Status"

 REL="Help"

><STRONG>Status:</STRONG></A> core<BR>

<A

 HREF="directive-dict.html#Compatibility"

 REL="Help"

><STRONG>Compatibility:</STRONG></A> ExtendedStatus is only available

 in Apache 1.3 and later



<P>

This directive controls whether the server keeps track of extended

status information for each request. This is only useful if the status module

is enabled on the server.

</P>

<P>

This setting applies to the entire server, and cannot be enabled or

disabled on a virtualhost-by-virtualhost basis.

</P><HR>



<H2><A NAME="files">&lt;Files&gt; directive</A></H2>

<A

 HREF="directive-dict.html#Syntax"

docs/manual/mod/directives.html

+1 −0
Changes for docs/manual/mod/directives.html: 1 added line, 0 removed lines.
Original line number Diff line number Diff line
@@ -100,6 +100,7 @@ of the terms used in their descriptions available. 
<LI><A HREF="mod_expires.html#expiresactive">ExpiresActive</A>

<LI><A HREF="mod_expires.html#expiresbytype">ExpiresByType</A>

<LI><A HREF="mod_expires.html#expiresdefault">ExpiresDefault</A>

<LI><A HREF="core.html#extendedstatus">ExtendedStatus</A>

<LI><A HREF="mod_autoindex.html#fancyindexing">FancyIndexing</A>

<LI><A HREF="core.html#files">&lt;Files&gt;</A>

<LI><A HREF="core.html#filesmatch">&lt;FilesMatch&gt;</A>

docs/manual/mod/mod_status.html

+4 −5
Changes for docs/manual/mod/mod_status.html: 4 added lines, 5 removed lines.
Original line number Diff line number Diff line
@@ -84,15 +84,14 @@ directory of Apache, <CODE>log_server_status</CODE>. 
To obtain full statistics you must compile Apache with a special

directive.  On some machines there may be a small performance loss

if you do this.  Try full statistics and see if you notice any

difference.  If you do please contact <A HREF="mailto:mark@ukweb.com">

mark@ukweb.com</A> and tell me your configuration.

difference.  If you do please contact <A HREF="mailto:jim@apache.org">

jim@apache.org</A> and tell us your configuration.



<P>



Do this by adding the following to the AUX_CFLAGS line in the

"Configuration" file and then recompiling as usual.

Do this by using the following run-time directive:

<PRE>

        AUX_CFLAGS= (something) -DSTATUS

        ExtendedStatus On

</PRE>



<BLOCKQUOTE>