You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by nd...@apache.org on 2003/03/01 20:56:43 UTC
cvs commit: httpd-2.0/docs/manual/mod mod_rewrite.xml
nd 2003/03/01 11:56:43
Modified: docs/manual/mod mod_rewrite.xml
Log:
add documentation of RewriteOptions MaxRedirects
Revision Changes Path
1.13 +22 -10 httpd-2.0/docs/manual/mod/mod_rewrite.xml
Index: mod_rewrite.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_rewrite.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- mod_rewrite.xml 19 Jan 2003 03:35:01 -0000 1.12
+++ mod_rewrite.xml 1 Mar 2003 19:56:43 -0000 1.13
@@ -308,10 +308,13 @@
<directivesynopsis>
<name>RewriteOptions</name>
<description>Sets some special options for the rewrite engine</description>
-<syntax>RewriteOptions <em>Options</em></syntax>
+<syntax>RewriteOptions <var>Options</var></syntax>
+<default>RewriteOptions MaxRedirects=10</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
+<compatibility><code>MaxRedirects</code> is available in Apache 2.1 and
+later</compatibility>
<usage>
<p>The <directive>RewriteOptions</directive> directive sets some
@@ -319,15 +322,24 @@
configuration. The <em>Option</em> strings can be one of the
following:</p>
- <ul>
- <li>'<strong><code>inherit</code></strong>'<br />
- This forces the current configuration to inherit the
- configuration of the parent. In per-virtual-server context
- this means that the maps, conditions and rules of the main
- server are inherited. In per-directory context this means
- that conditions and rules of the parent directory's
- <code>.htaccess</code> configuration are inherited.</li>
- </ul>
+ <dl>
+ <dt><code>inherit</code></dt>
+ <dd>This forces the current configuration to inherit the
+ configuration of the parent. In per-virtual-server context
+ this means that the maps, conditions and rules of the main
+ server are inherited. In per-directory context this means
+ that conditions and rules of the parent directory's
+ <code>.htaccess</code> configuration are inherited.</dd>
+
+ <dt><code>MaxRedirects=<var>number</var></code></dt>
+ <dd>In order to prevent endless loops of internal redirects
+ issued by per-directory <directive module="mod_rewrite"
+ >RewriteRule</directive>s, <module>mod_rewrite</module> aborts
+ the request after reaching a maximum number of such redirects and
+ responds with an 500 Internal Server Error. If you really need
+ more internal redirects than 10 per request, you may increase
+ the default to the desired value.</dd>
+ </dl>
</usage>
</directivesynopsis>