From: Jim Jagielski Date: Tue, 11 Aug 1998 00:24:28 +0000 (+0000) Subject: And now the docs for ExtendedStatus X-Git-Tag: 1.3.2~27 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e44cc22be0cfc3724e880067d0eee7e93e69568b;p=apache And now the docs for ExtendedStatus git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@81902 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/misc/perf-tuning.html b/docs/manual/misc/perf-tuning.html index 3f7d6e86c8..8e6178bd03 100644 --- a/docs/manual/misc/perf-tuning.html +++ b/docs/manual/misc/perf-tuning.html @@ -227,16 +227,16 @@ In no event should you raise this above about 60 seconds, as

Compile-Time Configuration Issues

-

mod_status and Rule STATUS=yes

+

mod_status and ExtendedStatus On

If you include mod_status -and you also set Rule STATUS=yes when building +and you also set ExtendedStatus On when building and running Apache, then on every request Apache will perform two calls to gettimeofday(2) (or times(2) depending on your operating system), and (pre-1.3) several extra calls to time(2). This is all done so that the status report -contains timing indications. For highest performance, set Rule -STATUS=no. +contains timing indications. For highest performance, set +ExtendedStatus off (which is the default).

accept Serialization - multiple sockets

@@ -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 patches section below. -

As described earlier, Rule STATUS=yes causes two +

As described earlier, ExtendedStatus On causes two gettimeofday calls and a call to times: 

@@ -670,8 +670,8 @@ gettimeofday({873959960, 417742}, NULL) = 0
 times({tms_utime=5, tms_stime=0, tms_cutime=0, tms_cstime=0}) = 446747
-These can be removed by either removing mod_status or -setting Rule STATUS=no. +These can be removed by setting ExtendedStatus Off (which +is the default).

It might seem odd to call stat: @@ -766,7 +766,7 @@ which were described earlier.

Let's apply some of these optimizations: -DSINGLE_LISTEN_UNSERIALIZED_ACCEPT -DBUFFERED_LOGS and -Rule STATUS=no. Here's the final trace: +ExtendedStatus Off. Here's the final trace: 

 accept(15, {sin_family=AF_INET, sin_port=htons(22286), sin_addr=inet_addr("127.0.0.1")}, [16]) = 3
diff --git a/docs/manual/mod/core.html b/docs/manual/mod/core.html
index 5f3abff39b..bec8764d6c 100644
--- a/docs/manual/mod/core.html
+++ b/docs/manual/mod/core.html
@@ -38,6 +38,7 @@ always available.
 
  • DocumentRoot
 
  • ErrorDocument
 
  • ErrorLog
+
  • ExtendedStatus
 
  • <Files>
 
  • <FilesMatch>
 
  • Group
@@ -845,6 +846,40 @@ than the user that starts the server.
 
    See also: LogLevel
 
    
 
+
    ExtendedStatus directive
    
+
+Syntax: ExtendedStatus On|Off
    
+Default: ExtendedStatus Off
    
+Context: server config 
    
+Status: core
    
+Compatibility: ExtendedStatus is only available
+ in Apache 1.3 and later
+
+
    
+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.
+
    
+
    
+This setting applies to the entire server, and cannot be enabled or
+disabled on a virtualhost-by-virtualhost basis.
+
    
+
 
    <Files> directive
    
 ExpiresActive
 
  • ExpiresByType
 
  • ExpiresDefault
+
  • ExtendedStatus
 
  • FancyIndexing
 
  • <Files>
 
  • <FilesMatch>
diff --git a/docs/manual/mod/mod_status.html b/docs/manual/mod/mod_status.html
index 6b61adfa26..481c8c3f48 100644
--- a/docs/manual/mod/mod_status.html
+++ b/docs/manual/mod/mod_status.html
@@ -84,15 +84,14 @@ directory of Apache, log_server_status.
 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 
-mark@ukweb.com and tell me your configuration.
+difference.  If you do please contact 
+jim@apache.org and tell us your configuration.
 
 
    
 
-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:
 
    -        AUX_CFLAGS= (something) -DSTATUS
+        ExtendedStatus On