changeset 2453:1b0cc44de0fd

Documented the "ipv6=" parameter for resolver in mail.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Oct 2019 19:21:03 +0300
parents 4487310de7e7
children 253641e268a8
files xml/en/docs/mail/ngx_mail_core_module.xml xml/ru/docs/mail/ngx_mail_core_module.xml
diffstat 2 files changed, 25 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/mail/ngx_mail_core_module.xml
+++ b/xml/en/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_core_module"
         link="/en/docs/mail/ngx_mail_core_module.html"
         lang="en"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -285,6 +285,7 @@ parameters <literal>--without-mail_imap_
 <syntax>
     <value>address</value> ...
     [<literal>valid</literal>=<value>time</value>]
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
     [<literal>status_zone</literal>=<value>zone</value>]</syntax>
 <syntax><literal>off</literal></syntax>
 <default>off</default>
@@ -313,6 +314,16 @@ starting from versions 1.3.1 and 1.2.2.
 </note>
 </para>
 
+<para id="resolver_ipv6">
+By default, nginx will look up both IPv4 and IPv6 addresses while resolving.
+If looking up of IPv6 addresses is not desired,
+the <literal>ipv6=off</literal> parameter can be specified.
+<note>
+Resolving of names into IPv6 addresses is supported
+starting from version 1.5.8.
+</note>
+</para>
+
 <para id="resolver_valid">
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows overriding it:
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_core_module"
         link="/ru/docs/mail/ngx_mail_core_module.html"
         lang="ru"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -287,6 +287,7 @@ FreeBSD 9.0-STABLE)
 <syntax>
     <value>адрес</value> ...
     [<literal>valid</literal>=<value>time</value>]
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
     [<literal>status_zone</literal>=<value>зона</value>]</syntax>
 <syntax><literal>off</literal></syntax>
 <default>off</default>
@@ -315,6 +316,17 @@ resolver 127.0.0.1 [::1]:5353;
 </note>
 </para>
 
+<para id="resolver_ipv6">
+По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
+при преобразовании имён в адреса.
+Если поиск IPv6-адресов нежелателен,
+можно указать параметр <literal>ipv6=off</literal>.
+<note>
+Преобразование имён в IPv6-адреса поддерживается
+начиная с версии 1.5.8.
+</note>
+</para>
+
 <para id="resolver_valid">
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это