# HG changeset patch
# User Sergey Kandaurov <pluknet@nginx.com>
# Date 1391866961 -14400
# Node ID 0c5f8630fe40abbe055ecafa4a2d58e6586cc88b
# Parent  8d9578f8523b589a7fdd43fa6056f198d3608e2b
Documented the mail "resolver" directive.

diff -r 8d9578f8523b -r 0c5f8630fe40 xml/en/docs/mail/ngx_mail_core_module.xml
--- a/xml/en/docs/mail/ngx_mail_core_module.xml	Sat Feb 08 17:42:41 2014 +0400
+++ b/xml/en/docs/mail/ngx_mail_core_module.xml	Sat Feb 08 17:42:41 2014 +0400
@@ -183,6 +183,69 @@
 </directive>
 
 
+<directive name="resolver">
+<syntax>
+<value>address</value> ...
+[<literal>valid</literal>=<value>time</value>]</syntax>
+<syntax><literal>off</literal></syntax>
+<default>off</default>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Configures name servers used to find the client’s hostname
+to pass it to the
+<link doc="ngx_mail_auth_http_module.xml">authentication server</link>,
+and in the
+<link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link>
+command when proxying SMTP.
+For example:
+<example>
+resolver 127.0.0.1 [::1]:5353;
+</example>
+An address can be specified as a domain name or IP address,
+and an optional port (1.3.1, 1.2.2).
+If port is not specified, the port 53 is used.
+Name servers are queried in a round-robin fashion.
+<note>
+Before version 1.1.7, only a single name server could be configured.
+Specifying name servers using IPv6 addresses is supported
+starting from versions 1.3.1 and 1.2.2.
+</note>
+By default, nginx caches answers using the TTL value of a response.
+An optional <literal>valid</literal> parameter allows overriding it:
+<example>
+resolver 127.0.0.1 [::1]:5353 valid=30s;
+</example>
+<note>
+Before version 1.1.9, tuning of caching time was not possible,
+and nginx always cached answers for the duration of 5 minutes.
+</note>
+</para>
+
+<para>
+The special value <literal>off</literal> disables resolving.
+</para>
+
+</directive>
+
+
+<directive name="resolver_timeout">
+<syntax><value>time</value></syntax>
+<default>30s</default>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Sets a timeout for DNS operations, for example:
+<example>
+resolver_timeout 5s;
+</example>
+</para>
+
+</directive>
+
+
 <directive name="server">
 <syntax block="yes"/>
 <default/>
diff -r 8d9578f8523b -r 0c5f8630fe40 xml/ru/docs/mail/ngx_mail_core_module.xml
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml	Sat Feb 08 17:42:41 2014 +0400
+++ b/xml/ru/docs/mail/ngx_mail_core_module.xml	Sat Feb 08 17:42:41 2014 +0400
@@ -182,6 +182,70 @@
 </directive>
 
 
+<directive name="resolver">
+<syntax>
+<value>адрес</value> ...
+[<literal>valid</literal>=<value>время</value>]</syntax>
+<syntax><literal>off</literal></syntax>
+<default>off</default>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Задаёт серверы DNS, используемые для определения имени хоста клиента
+для передачи его на
+<link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link>
+и в команде
+<link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link>
+при проксировании SMTP.
+Например:
+<example>
+resolver 127.0.0.1 [::1]:5353;
+</example>
+Адрес может быть указан в виде доменного имени или IP-адреса,
+и необязательного порта (1.3.1, 1.2.2).
+Если порт не указан, используется порт 53.
+Серверы DNS опрашиваются циклически.
+<note>
+До версии 1.1.7 можно было задать лишь один DNS-сервер.
+Задание DNS-серверов с помощью IPv6-адресов поддерживается
+начиная с версий 1.3.1 и 1.2.2.
+</note>
+По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
+Необязательный параметр <literal>valid</literal> позволяет это
+переопределить:
+<example>
+resolver 127.0.0.1 [::1]:5353 valid=30s;
+</example>
+<note>
+До версии 1.1.9 настройка времени кэширования была невозможна
+и nginx всегда кэшировал ответы на срок в 5 минут.
+</note>
+</para>
+
+<para>
+Специальное значение <literal>off</literal> запрещает использование DNS.
+</para>
+
+</directive>
+
+
+<directive name="resolver_timeout">
+<syntax><value>время</value></syntax>
+<default>30s</default>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Задаёт таймаут для операций DNS, например:
+<example>
+resolver_timeout 5s;
+</example>
+</para>
+
+</directive>
+
+
 <directive name="server">
 <syntax block="yes"/>
 <default/>