changeset 674:c48c0936b4df

Documented internal redirections limit.
author Vladimir Homutov <vl@nginx.com>
date Fri, 07 Sep 2012 13:00:26 +0000
parents f2d8603813b0
children 08140f6b7964
files xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/ngx_http_rewrite_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_rewrite_module.xml
diffstat 4 files changed, 33 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml	Thu Sep 06 06:41:24 2012 +0000
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Fri Sep 07 13:00:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Directives">
 
@@ -774,6 +774,14 @@
     internal;
 }
 </example>
+<note>
+There is a limit of 10 internal redirects per request to prevent
+request processing cycles that can occur in incorrect configurations.
+If this limit is reached, the error
+<http-status code="500" text="Internal Server Error"/> is returned.
+In such cases, the “rewrite or internal redirection cycle” message
+can be seen in the error log.
+</note>
 </para>
 
 </directive>
@@ -1835,6 +1843,8 @@
 Enables or disables doing several redirects using the
 <link id="error_page"/>
 directive.
+There is a <link doc="ngx_http_core_module.xml" id="internal">
+limit</link> on a number of such redirects.
 </para>
 
 </directive>
--- a/xml/en/docs/http/ngx_http_rewrite_module.xml	Thu Sep 06 06:41:24 2012 +0000
+++ b/xml/en/docs/http/ngx_http_rewrite_module.xml	Fri Sep 07 13:00:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_rewrite_module"
         link="/en/docs/http/ngx_http_rewrite_module.html"
         lang="en"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -38,8 +38,10 @@
 the directives of this module specified in the selected
 <link doc="ngx_http_core_module.xml" id="location"/> are processed,
 and if they changed a URI, a new location is searched for the new URI.
-This cycle may be repeated up to 10 times after which the error
-<http-status code="500" text="Internal Server Error"/> is returned.
+This cycle may be repeated up to
+<link doc="ngx_http_core_module.xml" id="internal">10 times</link>
+after which the error <http-status code="500" text="Internal Server Error"/>
+is returned.
 </listitem>
 
 </list>
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Thu Sep 06 06:41:24 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Fri Sep 07 13:00:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Директивы">
 
@@ -759,6 +759,15 @@
     internal;
 }
 </example>
+<note>
+Для предотвращения зацикливания, которое может возникнуть при
+использовании некорректных конфигураций, количество внутренних
+перенаправлений ограничено десятью.
+По достижении этого ограничения будет возвращена ошибка
+<http-status code="500" text="Internal Server Error"/>.
+В таком случае в лог-файле ошибок можно увидеть сообщение
+“rewrite or internal redirection cycle”.
+</note>
 </para>
 
 </directive>
@@ -1819,6 +1828,8 @@
 <para>
 Разрешает или запрещает делать несколько перенаправлений через директиву
 <link id="error_page"/>.
+Количество таких перенаправлений
+<link doc="ngx_http_core_module.xml" id="internal">ограничено</link>.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_rewrite_module.xml	Thu Sep 06 06:41:24 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_rewrite_module.xml	Fri Sep 07 13:00:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_rewrite_module"
         link="/ru/docs/http/ngx_http_rewrite_module.html"
         lang="ru"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -38,8 +38,10 @@
 выполняются директивы этого модуля, описанные в выбранном
 <link doc="ngx_http_core_module.xml" id="location"/>,
 и если они изменяли URI, то ищется новый location для уже нового URI.
-Этот цикл может повторяться до 10 раз, после чего возвращается
-ошибка <http-status code="500" text="Internal Server Error"/>.
+Этот цикл может повторяться до
+<link doc="ngx_http_core_module.xml" id="internal">10 раз</link>,
+после чего возвращается ошибка
+<http-status code="500" text="Internal Server Error"/>.
 </listitem>
 
 </list>