httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wr...@apache.org
Subject svn commit: r290508 - in /httpd/httpd/branches/2.0.x/docs/manual/mod: core.html.en core.xml directives.html.en quickreference.html.en
Date Tue, 20 Sep 2005 18:19:03 GMT
Author: wrowe
Date: Tue Sep 20 11:18:57 2005
New Revision: 290508

URL: http://svn.apache.org/viewcvs?rev=290508&view=rev
Log:

  TraceEnable docs, backported

Modified:
    httpd/httpd/branches/2.0.x/docs/manual/mod/core.html.en
    httpd/httpd/branches/2.0.x/docs/manual/mod/core.xml
    httpd/httpd/branches/2.0.x/docs/manual/mod/directives.html.en
    httpd/httpd/branches/2.0.x/docs/manual/mod/quickreference.html.en

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/core.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.0.x/docs/manual/mod/core.html.en?rev=290508&r1=290507&r2=290508&view=diff
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/core.html.en (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/core.html.en Tue Sep 20 11:18:57 2005
@@ -92,6 +92,7 @@
 <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>
@@ -3022,6 +3023,32 @@
     necessary in most situations. It is not set any lower by
     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>

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.0.x/docs/manual/mod/core.xml?rev=290508&r1=290507&r2=290508&view=diff
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/core.xml (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/core.xml Tue Sep 20 11:18:57 2005
@@ -2980,6 +2980,32 @@
 </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
 port</description>

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/directives.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.0.x/docs/manual/mod/directives.html.en?rev=290508&r1=290507&r2=290508&view=diff
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/directives.html.en (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/directives.html.en Tue Sep 20 11:18:57 2005
@@ -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>

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/quickreference.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.0.x/docs/manual/mod/quickreference.html.en?rev=290508&r1=290507&r2=290508&view=diff
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/quickreference.html.en (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/quickreference.html.en Tue Sep 20 11:18:57
2005
@@ -678,29 +678,30 @@
 <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">



Mime
View raw message