Commit ddcad55a authored by William A. Rowe Jr's avatar William A. Rowe Jr
Browse files 

  TraceEnable docs, backported


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

docs/manual/mod/core.html.en

+27 −0
Changes for docs/manual/mod/core.html.en: 27 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -92,6 +92,7 @@ available</td></tr> 
<li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>

</ul>
@@ -3023,6 +3024,32 @@ certain events before failing a request</td></tr> 
    default because there may still be odd places in the code where

    the timer is not reset when a packet is sent. </p>



</div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name of the distributed configuration file</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>

<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TraceEnable on</code></td></tr>

<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>

<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>

<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>

</table>

    <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>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>



</div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>

docs/manual/mod/core.xml

+26 −0
Changes for docs/manual/mod/core.xml: 26 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -2979,6 +2979,32 @@ certain events before failing a request</description> 
</usage>

</directivesynopsis>



<directivesynopsis>

<name>TraceEnable</name>

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

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

<default>TraceEnable on</default>

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

</contextlist>



<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>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>

</usage>

</directivesynopsis>



<directivesynopsis>

<name>UseCanonicalName</name>

<description>Configures how the server determines its own name and

docs/manual/mod/directives.html.en

+1 −0
Changes for docs/manual/mod/directives.html.en: 1 added line, 0 removed lines.
Original line number Diff line number Diff line
@@ -383,6 +383,7 @@ 
<li><a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>

<li><a href="mpm_netware.html#threadstacksize">ThreadStackSize</a></li>

<li><a href="core.html#timeout">TimeOut</a></li>

<li><a href="core.html#traceenable">TraceEnable</a></li>

<li><a href="mod_log_config.html#transferlog">TransferLog</a></li>

<li><a href="mod_mime.html#typesconfig">TypesConfig</a></li>

<li><a href="mod_env.html#unsetenv" id="U" name="U">UnsetEnv</a></li>

docs/manual/mod/quickreference.html.en

+16 −15
Changes for docs/manual/mod/quickreference.html.en: 16 added lines, 15 removed lines.
Original line number Diff line number Diff line
@@ -678,29 +678,30 @@ per child process</td></tr> 
<tr class="odd"><td><a href="mpm_netware.html#threadstacksize">ThreadStackSize <var>number</var></a></td><td> 65536 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Determine the stack size for each thread</td></tr>

<tr><td><a href="core.html#timeout">TimeOut <var>seconds</var></a></td><td> 300 </td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Amount of time the server will wait for

certain events before failing a request</td></tr>

<tr class="odd"><td><a href="mod_log_config.html#transferlog">TransferLog <var>file</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Specify location of a log file</td></tr>

<tr><td><a href="mod_mime.html#typesconfig">TypesConfig <var>file-path</var></a></td><td> conf/mime.types </td><td>s</td><td>B</td></tr><tr><td class="descr" colspan="4">The location of the <code>mime.types</code> file</td></tr>

<tr class="odd"><td><a href="mod_env.html#unsetenv" id="U" name="U">UnsetEnv <var>env-variable</var> [<var>env-variable</var>]

...</a></td><td></td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Removes variables from the environment</td></tr>

<tr><td><a href="core.html#usecanonicalname">UseCanonicalName On|Off|DNS</a></td><td> On </td><td>svd</td><td>C</td></tr><tr><td class="descr" colspan="4">Configures how the server determines its own name and

<tr class="odd"><td><a href="core.html#traceenable">TraceEnable <var>[on|off|extended]</var></a></td><td> on </td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Name of the distributed configuration file</td></tr>

<tr><td><a href="mod_log_config.html#transferlog">TransferLog <var>file</var>|<var>pipe</var></a></td><td></td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">Specify location of a log file</td></tr>

<tr class="odd"><td><a href="mod_mime.html#typesconfig">TypesConfig <var>file-path</var></a></td><td> conf/mime.types </td><td>s</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">The location of the <code>mime.types</code> file</td></tr>

<tr><td><a href="mod_env.html#unsetenv" id="U" name="U">UnsetEnv <var>env-variable</var> [<var>env-variable</var>]

...</a></td><td></td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Removes variables from the environment</td></tr>

<tr class="odd"><td><a href="core.html#usecanonicalname">UseCanonicalName On|Off|DNS</a></td><td> On </td><td>svd</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Configures how the server determines its own name and

port</td></tr>

<tr class="odd"><td><a href="mpm_common.html#user">User <var>unix-userid</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">The userid under which the server will answer

<tr><td><a href="mpm_common.html#user">User <var>unix-userid</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">The userid under which the server will answer

requests</td></tr>

<tr><td><a href="mod_userdir.html#userdir">UserDir <em>directory-filename</em></a></td><td> public_html </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">Location of the user-specific directories</td></tr>

<tr class="odd"><td><a href="mod_vhost_alias.html#virtualdocumentroot" id="V" name="V">VirtualDocumentRoot <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the document root

<tr class="odd"><td><a href="mod_userdir.html#userdir">UserDir <em>directory-filename</em></a></td><td> public_html </td><td>sv</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Location of the user-specific directories</td></tr>

<tr><td><a href="mod_vhost_alias.html#virtualdocumentroot" id="V" name="V">VirtualDocumentRoot <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the document root

for a given virtual host</td></tr>

<tr><td><a href="mod_vhost_alias.html#virtualdocumentrootip">VirtualDocumentRootIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the document root

<tr class="odd"><td><a href="mod_vhost_alias.html#virtualdocumentrootip">VirtualDocumentRootIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the document root

for a given virtual host</td></tr>

<tr class="odd"><td><a href="core.html#virtualhost">&lt;VirtualHost

<tr><td><a href="core.html#virtualhost">&lt;VirtualHost

    <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]

    ...&gt; ... &lt;/VirtualHost&gt;</a></td><td></td><td>s</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Contains directives that apply only to a specific

    ...&gt; ... &lt;/VirtualHost&gt;</a></td><td></td><td>s</td><td>C</td></tr><tr><td class="descr" colspan="4">Contains directives that apply only to a specific

hostname or IP address</td></tr>

<tr><td><a href="mod_vhost_alias.html#virtualscriptalias">VirtualScriptAlias <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the CGI directory for

<tr class="odd"><td><a href="mod_vhost_alias.html#virtualscriptalias">VirtualScriptAlias <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the CGI directory for

a given virtual host</td></tr>

<tr class="odd"><td><a href="mod_vhost_alias.html#virtualscriptaliasip">VirtualScriptAliasIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dynamically configure the location of the cgi directory for

<tr><td><a href="mod_vhost_alias.html#virtualscriptaliasip">VirtualScriptAliasIP <em>interpolated-directory</em>|none</a></td><td> none </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Dynamically configure the location of the cgi directory for

a given virtual host</td></tr>

<tr><td><a href="mpm_winnt.html#win32disableacceptex" id="W" name="W">Win32DisableAcceptEx</a></td><td></td><td>s</td><td>M</td></tr><tr><td class="descr" colspan="4">Use accept() rather than AcceptEx() to accept network connections</td></tr>

<tr class="odd"><td><a href="mod_include.html#xbithack" id="X" name="X">XBitHack on|off|full</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Parse SSI directives in files with the execute bit

<tr class="odd"><td><a href="mpm_winnt.html#win32disableacceptex" id="W" name="W">Win32DisableAcceptEx</a></td><td></td><td>s</td><td>M</td></tr><tr class="odd"><td class="descr" colspan="4">Use accept() rather than AcceptEx() to accept network connections</td></tr>

<tr><td><a href="mod_include.html#xbithack" id="X" name="X">XBitHack on|off|full</a></td><td> off </td><td>svdh</td><td>B</td></tr><tr><td class="descr" colspan="4">Parse SSI directives in files with the execute bit

set</td></tr>

</table></div>

<div class="bottomlang">