Return-Path: 
 <cvs-return-15983-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 47270 invoked by uid 500); 19 May 2003 01:59:10 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
list-post: <mailto:cvs@httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 47259 invoked by uid 500); 19 May 2003 01:59:10 -0000
Delivered-To: apmail-httpd-2.0-cvs@apache.org
Date: 19 May 2003 01:59:09 -0000
Message-ID: <20030519015909.3291.qmail@icarus.apache.org>
From: nd@apache.org
To: httpd-2.0-cvs@apache.org
Subject: cvs commit: httpd-2.0/docs/manual/mod core.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

nd          2003/05/18 18:59:09

  Modified:    docs/manual/mod core.xml
  Log:
  Document the LimitInternalRecursion directive.
  
  Reviewed by: Jeff Trawick
  
  Revision  Changes    Path
  1.61      +35 -0     httpd-2.0/docs/manual/mod/core.xml
  
  Index: core.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/core.xml,v
  retrieving revision 1.60
  retrieving revision 1.61
  diff -u -r1.60 -r1.61
  --- core.xml	8 May 2003 18:13:06 -0000	1.60
  +++ core.xml	19 May 2003 01:59:09 -0000	1.61
  @@ -1463,6 +1463,41 @@
   </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
   from the client</description>