From: André Malo <nd@apache.org>
Date: Mon, 19 May 2003 01:59:09 +0000 (+0000)
Subject: Document the LimitInternalRecursion directive.
X-Git-Tag: pre_ajp_proxy~1667
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=7b2bdb3146bccf5491b76a607c5ccd1972c0d1cd;p=thirdparty%2Fapache%2Fhttpd.git

Document the LimitInternalRecursion directive.

Reviewed by: Jeff Trawick


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@99913 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index fbae54fd9fc..85436b4adbd 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1462,6 +1462,41 @@ except the named ones</description>
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>LimitInternalRecursion</name>
+<description>Determine maximum number of internal redirects and nested
+subrequests</description>
+<syntax>LimitInternalRecursion <var>number</var> [<var>number</var>]</syntax>
+<default>LimitInternalRecursion 10</default>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+<compatibility>Available in Apache 2.1 and later</compatibility>
+
+<usage>
+    <p>An internal redirect happens, for example, when using the <directive
+    module="mod_actions">Action</directive> directive, which internally
+    redirects the original request to a CGI script. A subrequest is Apache's
+    mechanism to find out what would happen for some URI if it were requested.
+    For example, <module>mod_dir</module> uses subrequests to look for the
+    files listed in the <directive module="mod_dir">DirectoryIndex</directive>
+    directive.</p>
+
+    <p><directive>LimitInternalRecursion</directive> prevents the server
+    from crashing when entering an infinite loop of internal redirects or
+    subrequests. Such loops are usually caused by misconfigurations.</p>
+
+    <p>The directive stores two different limits, which are evaluated on
+    per-request basis. The first <var>number</var> is the maximum number of
+    internal redirects, that may follow each other. The second <var>number</var>
+    determines, how deep subrequests may be nested. If you specify only one
+    <var>number</var>, it will be assigned to both limits.</p>
+
+    <example><title>Example</title>
+      LimitInternalRecursion 5
+    </example>
+</usage>
+</directivesynopsis>
+
 <directivesynopsis>
 <name>LimitRequestBody</name>
 <description>Restricts the total size of the HTTP request body sent