[nginx-site] Documented max_headers directive.

[Maxim Dounin]

details:   http://freenginx.org/hg/nginx-site/rev/3b5594157fab
branches:  
changeset: 3083:3b5594157fab
user:      Maxim Dounin <mdounin at mdounin.ru>
date:      Fri May 24 01:16:29 2024 +0300
description:
Documented max_headers directive.

diffstat:

 xml/en/docs/http/ngx_http_core_module.xml |  27 ++++++++++++++++++++++++++-
 xml/en/docs/http/server_names.xml         |   3 ++-
 xml/ru/docs/http/ngx_http_core_module.xml |  26 +++++++++++++++++++++++++-
 xml/ru/docs/http/server_names.xml         |   5 +++--
 4 files changed, 56 insertions(+), 5 deletions(-)

diffs (129 lines):

diff --git a/xml/en/docs/http/ngx_http_core_module.xml b/xml/en/docs/http/ngx_http_core_module.xml
--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="107">
+        rev="108">
 
 <section id="directives" name="Directives">
 
@@ -1778,6 +1778,31 @@ Enables or disables logging of subreques
 </directive>
 
 
+<directive name="max_headers">
+<syntax><value>number</value></syntax>
+<default>1000</default>
+<context>http</context>
+<context>server</context>
+<appeared-in>1.27.1</appeared-in>
+
+<para>
+Limits the maximum allowed number of client request header fields.
+If the limit is exceeded, the
+<http-status code="400" text="Bad Request"/>
+error is returned to the client.
+</para>
+
+<para>
+If the directive is specified on the <link id="server"/> level,
+the value from the default server can be used.
+Details are provided in the
+“<link doc="server_names.xml" id="virtual_server_selection">Virtual
+server selection</link>” section.
+</para>
+
+</directive>
+
+
 <directive name="max_ranges">
 <syntax><value>number</value></syntax>
 <default/>
diff --git a/xml/en/docs/http/server_names.xml b/xml/en/docs/http/server_names.xml
--- a/xml/en/docs/http/server_names.xml
+++ b/xml/en/docs/http/server_names.xml
@@ -8,7 +8,7 @@
 <article name="Server names"
          link="/en/docs/http/server_names.html"
          lang="en"
-         rev="4"
+         rev="5"
          author="Igor Sysoev"
          editor="Brian Mercer">
 
@@ -404,6 +404,7 @@ the server configuration chosen by SNI;
 in case of the
 <link doc="ngx_http_core_module.xml" id="ignore_invalid_headers"/>,
 <link doc="ngx_http_core_module.xml" id="large_client_header_buffers"/>,
+<link doc="ngx_http_core_module.xml" id="max_headers"/>,
 and
 <link doc="ngx_http_core_module.xml" id="underscores_in_headers"/> directives
 involved in processing request header fields,
diff --git a/xml/ru/docs/http/ngx_http_core_module.xml b/xml/ru/docs/http/ngx_http_core_module.xml
--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="107">
+        rev="108">
 
 <section id="directives" name="Директивы">
 
@@ -1774,6 +1774,30 @@ location = /user {
 </directive>
 
 
+<directive name="max_headers">
+<syntax><value>число</value></syntax>
+<default>1000</default>
+<context>http</context>
+<context>server</context>
+<appeared-in>1.27.1</appeared-in>
+
+<para>
+Ограничивает максимальное допустимое число полей заголовка запроса клиента.
+При превышении указанного ограничения клиенту возвращается ошибка
+<http-status code="400" text="Bad Request"/>.
+</para>
+
+<para>
+Если директива указана на уровне <link id="server"/>,
+то может использоваться значение из сервера по умолчанию.
+Подробнее см. в разделе
+“<link doc="server_names.xml" id="virtual_server_selection">Выбор
+виртуального сервера</link>”.
+</para>
+
+</directive>
+
+
 <directive name="max_ranges">
 <syntax><value>число</value></syntax>
 <default/>
diff --git a/xml/ru/docs/http/server_names.xml b/xml/ru/docs/http/server_names.xml
--- a/xml/ru/docs/http/server_names.xml
+++ b/xml/ru/docs/http/server_names.xml
@@ -8,7 +8,7 @@
 <article name="Имена сервера"
          link="/ru/docs/http/server_names.html"
          lang="ru"
-         rev="4"
+         rev="5"
          author="Игорь Сысоев"
          editor="Brian Mercer">
 
@@ -408,7 +408,8 @@ server {
 <listitem>
 в случае использования директив
 <link doc="ngx_http_core_module.xml" id="ignore_invalid_headers"/>,
-<link doc="ngx_http_core_module.xml" id="large_client_header_buffers"/>
+<link doc="ngx_http_core_module.xml" id="large_client_header_buffers"/>,
+<link doc="ngx_http_core_module.xml" id="max_headers"/>
 и
 <link doc="ngx_http_core_module.xml" id="underscores_in_headers"/>,
 которые участвуют в обработке полей заголовка запроса,