You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ji...@hyperreal.org on 1998/08/11 02:24:31 UTC
cvs commit: apache-1.3/htdocs/manual/mod core.html directives.html mod_status.html
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: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>