# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1615405269 0
# Node ID 468e6e14e5cc0474ab4cc53347780b2fd589bab2
# Parent  893cd7724c8c58d89e1addcf23cffa911d247488
Documented the PROXY protocol support in mail.

diff -r 893cd7724c8c -r 468e6e14e5cc xml/en/docs/mail/ngx_mail_auth_http_module.xml
--- a/xml/en/docs/mail/ngx_mail_auth_http_module.xml	Tue Mar 09 18:44:56 2021 +0000
+++ b/xml/en/docs/mail/ngx_mail_auth_http_module.xml	Wed Mar 10 19:41:09 2021 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_auth_http_module"
         link="/en/docs/mail/ngx_mail_auth_http_module.html"
         lang="en"
-        rev="9">
+        rev="10">
 
 <section id="directives" name="Directives">
 
@@ -240,6 +240,17 @@
 </example>
 </para>
 
+<para id="proxy_protocol">
+When the
+<link doc="ngx_mail_core_module.xml" id="proxy_protocol">PROXY protocol</link>
+is used,
+its details are passed in the following request headers:
+<header>Proxy-Protocol-Addr</header>,
+<header>Proxy-Protocol-Port</header>,
+<header>Proxy-Protocol-Server-Addr</header>, and
+<header>Proxy-Protocol-Server-Port</header> (1.19.8).
+</para>
+
 </section>
 
 </module>
diff -r 893cd7724c8c -r 468e6e14e5cc xml/en/docs/mail/ngx_mail_core_module.xml
--- a/xml/en/docs/mail/ngx_mail_core_module.xml	Tue Mar 09 18:44:56 2021 +0000
+++ b/xml/en/docs/mail/ngx_mail_core_module.xml	Wed Mar 10 19:41:09 2021 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_core_module"
         link="/en/docs/mail/ngx_mail_core_module.html"
         lang="en"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -78,6 +78,7 @@
 <syntax>
     <value>address</value>:<value>port</value>
     [<literal>ssl</literal>]
+    [<literal>proxy_protocol</literal>]
     [<literal>backlog</literal>=<value>number</value>]
     [<literal>rcvbuf</literal>=<value>size</value>]
     [<literal>sndbuf</literal>=<value>size</value>]
@@ -121,6 +122,15 @@
 connections accepted on this port should work in SSL mode.
 </para>
 
+<para id="proxy_protocol">
+The <literal>proxy_protocol</literal> parameter (1.19.8)
+allows specifying that all connections accepted on this port should use the
+<link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">PROXY
+protocol</link>.
+Obtained information is passed to the
+<link doc="ngx_mail_auth_http_module.xml" id="proxy_protocol">authentication server</link>.
+</para>
+
 <para>
 The <literal>listen</literal> directive
 can have several additional parameters specific to socket-related system calls.
diff -r 893cd7724c8c -r 468e6e14e5cc xml/ru/docs/mail/ngx_mail_auth_http_module.xml
--- a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Tue Mar 09 18:44:56 2021 +0000
+++ b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Wed Mar 10 19:41:09 2021 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_auth_http_module"
         link="/ru/docs/mail/ngx_mail_auth_http_module.html"
         lang="ru"
-        rev="9">
+        rev="10">
 
 <section id="directives" name="Директивы">
 
@@ -238,6 +238,16 @@
 </example>
 </para>
 
+<para id="proxy_protocol">
+При использовании
+<link doc="ngx_mail_core_module.xml" id="proxy_protocol">протокола PROXY</link>,
+информация о нём передаётся в следующих заголовках запроса:
+<header>Proxy-Protocol-Addr</header>,
+<header>Proxy-Protocol-Port</header>,
+<header>Proxy-Protocol-Server-Addr</header> и
+<header>Proxy-Protocol-Server-Port</header> (1.19.8).
+</para>
+
 </section>
 
 </module>
diff -r 893cd7724c8c -r 468e6e14e5cc xml/ru/docs/mail/ngx_mail_core_module.xml
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml	Tue Mar 09 18:44:56 2021 +0000
+++ b/xml/ru/docs/mail/ngx_mail_core_module.xml	Wed Mar 10 19:41:09 2021 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_core_module"
         link="/ru/docs/mail/ngx_mail_core_module.html"
         lang="ru"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -78,6 +78,7 @@
 <syntax>
     <value>адрес</value>:<value>порт</value>
     [<literal>ssl</literal>]
+    [<literal>proxy_protocol</literal>]
     [<literal>backlog</literal>=<value>число</value>]
     [<literal>rcvbuf</literal>=<value>размер</value>]
     [<literal>sndbuf</literal>=<value>размер</value>]
@@ -120,6 +121,16 @@
 принимаемые на данном порту, должны работать в режиме SSL.
 </para>
 
+<para id="proxy_protocol">
+Параметр <literal>proxy_protocol</literal> (1.19.8)
+указывает на то, что все соединения, принимаемые на данном порту,
+должны использовать
+<link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол
+PROXY</link>.
+Полученная информация передаётся
+<link doc="ngx_mail_auth_http_module.xml" id="proxy_protocol">серверу аутентификации</link>.
+</para>
+
 <para>
 В директиве <literal>listen</literal> можно также указать несколько
 дополнительных параметров, специфичных для связанных с сокетами