Commit c1f4bdb1 authored by Andre Malo's avatar Andre Malo
Browse files

fix TraceEnable docs 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@290544 13f79535-47bb-0310-9956-ffa450edef68
parent b6de6c3d

docs/manual/mod/core.xml

+14 −12
Changes for docs/manual/mod/core.xml: 14 added lines, 12 removed lines.
Original line number Diff line number Diff line
@@ -2981,27 +2981,29 @@ certain events before failing a request</description> 


<directivesynopsis>

<name>TraceEnable</name>

<description>Name of the distributed configuration file</description>

<description>Determines the behaviour on <code>TRACE</code>

requests</description>

<syntax>TraceEnable <var>[on|off|extended]</var></syntax>

<default>TraceEnable on</default>

<contextlist><context>server config</context>

</contextlist>

<contextlist><context>server config</context></contextlist>

<compatibility>Version 2.0.55 and later</compatibility>



<usage>

    <p>This directive overrides the behavior of TRACE for both

    the core server and mod_proxy.  The default <code>TraceEnable 

    on</code> permits TRACE requests per RFC 2616, which disallows

    any request body to accompany the request.  <code>TraceEnable

    off</code> causes the core server and mod_proxy to return

    a 405 FORBIDDEN error to the client.</p>

    <p>This directive overrides the behavior of <code>TRACE</code> for both

    the core server and <module>mod_proxy</module>.  The default

    <code>TraceEnable on</code> permits <code>TRACE</code> requests per

    RFC 2616, which disallows any request body to accompany the request.

    <code>TraceEnable off</code> causes the core server and

    <module>mod_proxy</module> to return a <code>405</code> (Method not

    allowed) error to the client.</p>



    <p>Finally, for testing and diagnostic purposes only, request

    bodies may be allowed using the non-compliant <code>TraceEnable 

    extended</code> 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.</p>

    <code>Transfer-Encoding: chunked</code> is used).  The core will

    reflect the full headers and all chunk headers with the response

    body.  As a proxy server, the request body is not restricted to 64k.</p>

</usage>

</directivesynopsis>