jim 98/08/10 17:24:31
Modified: htdocs/manual/misc perf-tuning.html htdocs/manual/mod core.html directives.html mod_status.html Log: And now the docs for ExtendedStatus Revision Changes Path 1.13 +8 -8 apache-1.3/htdocs/manual/misc/perf-tuning.html Index: perf-tuning.html =================================================================== RCS file: /export/home/cvs/apache-1.3/htdocs/manual/misc/perf-tuning.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- perf-tuning.html 1998/07/01 17:25:55 1.12 +++ perf-tuning.html 1998/08/11 00:24:24 1.13 @@ -227,16 +227,16 @@ <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 @@ 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 @@ 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 @@ <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 1.129 +35 -0 apache-1.3/htdocs/manual/mod/core.html Index: core.html =================================================================== RCS file: /export/home/cvs/apache-1.3/htdocs/manual/mod/core.html,v retrieving revision 1.128 retrieving revision 1.129 diff -u -r1.128 -r1.129 --- core.html 1998/07/28 05:57:13 1.128 +++ core.html 1998/08/11 00:24:27 1.129 @@ -38,6 +38,7 @@ <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"><Files></A> <LI><A HREF="#filesmatch"><FilesMatch></A> <LI><A HREF="#group">Group</A> @@ -844,6 +845,40 @@ <P><STRONG>See also:</STRONG> <A HREF="#loglevel">LogLevel</A> <P><HR> + +<H2><A NAME="extendedstatus">ExtendedStatus directive</A></H2> +<!--%plaintext <?INDEX {\tt ExtendedStatus} directive> --> +<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"><Files> directive</A></H2> <A 1.48 +1 -0 apache-1.3/htdocs/manual/mod/directives.html Index: directives.html =================================================================== RCS file: /export/home/cvs/apache-1.3/htdocs/manual/mod/directives.html,v retrieving revision 1.47 retrieving revision 1.48 diff -u -r1.47 -r1.48 --- directives.html 1998/07/09 19:45:40 1.47 +++ directives.html 1998/08/11 00:24:28 1.48 @@ -100,6 +100,7 @@ <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"><Files></A> <LI><A HREF="core.html#filesmatch"><FilesMatch></A> 1.12 +4 -5 apache-1.3/htdocs/manual/mod/mod_status.html Index: mod_status.html =================================================================== RCS file: /export/home/cvs/apache-1.3/htdocs/manual/mod/mod_status.html,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- mod_status.html 1998/05/20 14:12:59 1.11 +++ mod_status.html 1998/08/11 00:24:28 1.12 @@ -84,15 +84,14 @@ 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:[EMAIL PROTECTED]"> [EMAIL PROTECTED]</A> and tell me your configuration. +difference. If you do please contact <A HREF="mailto:[EMAIL PROTECTED]"> [EMAIL PROTECTED]</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>