diff xml/ru/docs/mail/ngx_mail_core_module.xml @ 1068:0c5f8630fe40

Documented the mail "resolver" directive.
author Sergey Kandaurov <pluknet@nginx.com>
date Sat, 08 Feb 2014 17:42:41 +0400
parents 8d9578f8523b
children 71e6daffa4dc
line wrap: on
line diff
--- 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/>