From: William A. Rowe Jr
Date: Tue, 20 Sep 2005 17:56:22 +0000 (+0000)
Subject: At last, TraceEnable docs
X-Git-Tag: 2.3.0~2980
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e3e60c60765fdd9354556648960b6cc4346db8ef;p=apache
At last, TraceEnable docs
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@290495 13f79535-47bb-0310-9956-ffa450edef68
---
diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index 262cfaed00..761d2e9ef7 100644
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -91,6 +91,7 @@ available
SetInputFilter
SetOutputFilter
TimeOut
+
TraceEnable
UseCanonicalName
<VirtualHost>
@@ -3052,6 +3053,32 @@ certain events before failing a request
default because there may still be odd places in the code where
the timer is not reset when a packet is sent.
+
+
+
+
+
This directive overrides the behavior of TRACE for both
+ the core server and mod_proxy. The default TraceEnable
+ on
permits TRACE requests per RFC 2616, which disallows
+ any request body to accompany the request. TraceEnable
+ off
causes the core server and mod_proxy to return
+ a 405 FORBIDDEN error to the client.
+
+
Finally, for testing and diagnostic purposes only, request
+ bodies may be allowed using the non-compliant TraceEnable
+ extended
directive. The core (as an origin server) will
+ restrict the request body to 64k (plus 8k for chunk headers if
+ Transfer-Encoding: chunked is used). The core will reflect the
+ full headers and all chunk headers with the request body. As a
+ proxy server, the request body is not restricted to 64k.
+

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 1573105376..411f79e4d1 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -3011,6 +3011,32 @@ certain events before failing a request
+
+TraceEnable
+Name of the distributed configuration file
+TraceEnable [on|off|extended]
+TraceEnable on
+server config
+
+
+
+ This directive overrides the behavior of TRACE for both
+ the core server and mod_proxy. The default TraceEnable
+ on
permits TRACE requests per RFC 2616, which disallows
+ any request body to accompany the request. TraceEnable
+ off
causes the core server and mod_proxy to return
+ a 405 FORBIDDEN error to the client.
+
+ Finally, for testing and diagnostic purposes only, request
+ bodies may be allowed using the non-compliant TraceEnable
+ extended
directive. The core (as an origin server) will
+ restrict the request body to 64k (plus 8k for chunk headers if
+ Transfer-Encoding: chunked is used). The core will reflect the
+ full headers and all chunk headers with the request body. As a
+ proxy server, the request body is not restricted to 64k.
+
+
+
UseCanonicalName
Configures how the server determines its own name and
diff --git a/docs/manual/mod/directives.html.en b/docs/manual/mod/directives.html.en
index 52b3234772..db938f09dd 100644
--- a/docs/manual/mod/directives.html.en
+++ b/docs/manual/mod/directives.html.en
@@ -406,6 +406,7 @@
ThreadsPerChild
ThreadStackSize
TimeOut
+TraceEnable
TransferLog
TypesConfig
UnsetEnv
diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en
index 2ccb8d14a4..a370c4db16 100644
--- a/docs/manual/mod/quickreference.html.en
+++ b/docs/manual/mod/quickreference.html.en
@@ -713,29 +713,30 @@ per child process
client connections
TimeOut seconds | 300 | s | C |
Amount of time the server will wait for
certain events before failing a request |
-TransferLog file|pipe | | sv | B |
Specify location of a log file |
-TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file |
-UnsetEnv env-variable [env-variable]
-... | | svdh | B |
Removes variables from the environment |
-UseCanonicalName On|Off|DNS | Off | svd | C |
Configures how the server determines its own name and
+ |
TraceEnable [on|off|extended] | on | s | C |
Name of the distributed configuration file |
+TransferLog file|pipe | | sv | B |
Specify location of a log file |
+TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file |
+UnsetEnv env-variable [env-variable]
+... | | svdh | B |
Removes variables from the environment |
+UseCanonicalName On|Off|DNS | Off | svd | C |
Configures how the server determines its own name and
port |
-User unix-userid | #-1 | s | M |
The userid under which the server will answer
+ |
User unix-userid | #-1 | s | M |
The userid under which the server will answer
requests |
-UserDir directory-filename | | sv | B |
Location of the user-specific directories |
-VirtualDocumentRoot interpolated-directory|none | none | sv | E |
Dynamically configure the location of the document root
+ |
UserDir directory-filename | | sv | B |
Location of the user-specific directories |
+VirtualDocumentRoot interpolated-directory|none | none | sv | E |
Dynamically configure the location of the document root
for a given virtual host |
-VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
Dynamically configure the location of the document root
+ |
VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
Dynamically configure the location of the document root
for a given virtual host |
-<VirtualHost
+<VirtualHost
addr[:port] [addr[:port]]
- ...> ... </VirtualHost> | | s | C | Contains directives that apply only to a specific
+ ...> ... </VirtualHost> | | s | C | Contains directives that apply only to a specific
hostname or IP address |
-VirtualScriptAlias interpolated-directory|none | none | sv | E | Dynamically configure the location of the CGI directory for
+ | VirtualScriptAlias interpolated-directory|none | none | sv | E | Dynamically configure the location of the CGI directory for
a given virtual host |
-VirtualScriptAliasIP interpolated-directory|none | none | sv | E | Dynamically configure the location of the cgi directory for
+ | VirtualScriptAliasIP interpolated-directory|none | none | sv | E | Dynamically configure the location of the cgi directory for
a given virtual host |
-Win32DisableAcceptEx | | s | M | Use accept() rather than AcceptEx() to accept network connections |
-XBitHack on|off|full | off | svdh | B | Parse SSI directives in files with the execute bit
+ | Win32DisableAcceptEx | | s | M | Use accept() rather than AcceptEx() to accept network connections |
+XBitHack on|off|full | off | svdh | B | Parse SSI directives in files with the execute bit
set |
|