changeset 1031:f7f23f5928ef

Documented "resolver ipv6=" parameter.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 13 Dec 2013 21:02:08 +0400
parents 8bbfe30a36c1
children 8ca2aeddf4fe
files xml/en/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_core_module.xml
diffstat 2 files changed, 23 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- 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="25">
+        rev="26">
 
 <section id="directives" name="Directives">
 
@@ -1956,8 +1956,9 @@ closed normally.
 
 <directive name="resolver">
 <syntax>
-<value>address</value> ...
-[<literal>valid</literal>=<value>time</value>]</syntax>
+    <value>address</value> ...
+    [<literal>valid</literal>=<value>time</value>]
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -1978,6 +1979,13 @@ Before version 1.1.7, only a single name
 Specifying name servers using IPv6 addresses is supported
 starting from versions 1.3.1 and 1.2.2.
 </note>
+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>
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows overriding it:
 <example>
--- 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="25">
+        rev="26">
 
 <section id="directives" name="Директивы">
 
@@ -1953,8 +1953,9 @@ open_file_cache_events   on;
 
 <directive name="resolver">
 <syntax>
-<value>адрес</value> ...
-[<literal>valid</literal>=<value>время</value>]</syntax>
+    <value>адрес</value> ...
+    [<literal>valid</literal>=<value>время</value>]
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -1975,6 +1976,14 @@ resolver 127.0.0.1 [::1]:5353;
 Задание DNS-серверов с помощью IPv6-адресов поддерживается
 начиная с версий 1.3.1 и 1.2.2.
 </note>
+По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
+при преобразовании имён в адреса.
+Если поиск IPv6-адресов нежелателен,
+можно указать параметр <literal>ipv6=off</literal>.
+<note>
+Преобразование имён в IPv6-адреса поддерживается
+начиная с версии 1.5.8.
+</note>
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это
 переопределить: