From c73b14fe8a6e7d3973ba10e079d635ea56a61890 Mon Sep 17 00:00:00 2001 From: "William A. Rowe Jr" Date: Tue, 20 Sep 2005 18:18:57 +0000 Subject: [PATCH] TraceEnable docs, backported git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@290508 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/core.html.en | 27 ++++++++++++++++++++++ docs/manual/mod/core.xml | 26 +++++++++++++++++++++ docs/manual/mod/directives.html.en | 1 + docs/manual/mod/quickreference.html.en | 31 +++++++++++++------------- 4 files changed, 70 insertions(+), 15 deletions(-) diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index 85747b2b855..4bf05d31610 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -92,6 +92,7 @@ available
  • SetInputFilter
  • SetOutputFilter
  • TimeOut
    • +
  • TraceEnable
  • UseCanonicalName
  • <VirtualHost>
    • @@ -3023,6 +3024,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.

    + +
    top
    +

    TraceEnable Directive

    + + + + + + + +
    Description:Name of the distributed configuration file
    Syntax:TraceEnable [on|off|extended]
    Default:TraceEnable on
    Context:server config
    Status:Core
    Module:core
    +

    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.

    +
    top

    UseCanonicalName Directive

    diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml index 10d8a21f6c3..64ffde2a37d 100644 --- a/docs/manual/mod/core.xml +++ b/docs/manual/mod/core.xml @@ -2979,6 +2979,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 a6015bc68ee..9f295431a55 100644 --- a/docs/manual/mod/directives.html.en +++ b/docs/manual/mod/directives.html.en @@ -383,6 +383,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 dac7b02c2e3..5132286809a 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -678,29 +678,30 @@ per child process ThreadStackSize number 65536 sMDetermine the stack size for each thread TimeOut seconds 300 sCAmount of time the server will wait for certain events before failing a request -TransferLog file|pipesvBSpecify location of a log file -TypesConfig file-path conf/mime.types sBThe location of the mime.types file -UnsetEnv env-variable [env-variable] -...svdhBRemoves variables from the environment -UseCanonicalName On|Off|DNS On svdCConfigures how the server determines its own name and +TraceEnable [on|off|extended] on sCName of the distributed configuration file +TransferLog file|pipesvBSpecify location of a log file +TypesConfig file-path conf/mime.types sBThe location of the mime.types file +UnsetEnv env-variable [env-variable] +...svdhBRemoves variables from the environment +UseCanonicalName On|Off|DNS On svdCConfigures how the server determines its own name and port -User unix-userid #-1 sMThe userid under which the server will answer +User unix-userid #-1 sMThe userid under which the server will answer requests -UserDir directory-filename public_html svBLocation of the user-specific directories -VirtualDocumentRoot interpolated-directory|none none svEDynamically configure the location of the document root +UserDir directory-filename public_html svBLocation of the user-specific directories +VirtualDocumentRoot interpolated-directory|none none svEDynamically configure the location of the document root for a given virtual host -VirtualDocumentRootIP interpolated-directory|none none svEDynamically configure the location of the document root +VirtualDocumentRootIP interpolated-directory|none none svEDynamically configure the location of the document root for a given virtual host -<VirtualHost +<VirtualHost addr[:port] [addr[:port]] - ...> ... </VirtualHost>sCContains directives that apply only to a specific + ...> ... </VirtualHost>sCContains directives that apply only to a specific hostname or IP address -VirtualScriptAlias interpolated-directory|none none svEDynamically configure the location of the CGI directory for +VirtualScriptAlias interpolated-directory|none none svEDynamically configure the location of the CGI directory for a given virtual host -VirtualScriptAliasIP interpolated-directory|none none svEDynamically configure the location of the cgi directory for +VirtualScriptAliasIP interpolated-directory|none none svEDynamically configure the location of the cgi directory for a given virtual host -Win32DisableAcceptExsMUse accept() rather than AcceptEx() to accept network connections -XBitHack on|off|full off svdhBParse SSI directives in files with the execute bit +Win32DisableAcceptExsMUse accept() rather than AcceptEx() to accept network connections +XBitHack on|off|full off svdhBParse SSI directives in files with the execute bit set
    -- 2.47.2