]> granicus.if.org Git - apache/commitdiff
And now the docs for ExtendedStatus
authorJim Jagielski <jim@apache.org>
Tue, 11 Aug 1998 00:24:28 +0000 (00:24 +0000)
committerJim Jagielski <jim@apache.org>
Tue, 11 Aug 1998 00:24:28 +0000 (00:24 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@81902 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/misc/perf-tuning.html
docs/manual/mod/core.html
docs/manual/mod/directives.html
docs/manual/mod/mod_status.html

index 3f7d6e86c889306752b5433c2c3a659cffe899e0..8e6178bd038e54072b51b81ac7f63962cd0b2cc4 100644 (file)
@@ -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
index 5f3abff39b055e7c3661273c2bb1535d23cc0e40..bec8764d6c63e1374253434f81720b96d05a633e 100644 (file)
@@ -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"
index bdb0a48b25a4b2a373fbff8bcaeda45ce70f5ff4..41dc12b319f2892947981748bcd7d387f32a87ce 100644 (file)
@@ -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>
index 6b61adfa26933ee49152f61292d2477c43403b31..481c8c3f48dfa2d0b46699e4f74769a71f583231 100644 (file)
@@ -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>