Mercurial > hg > nginx-site
changeset 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 |
files | xml/en/docs/mail/ngx_mail_core_module.xml xml/ru/docs/mail/ngx_mail_core_module.xml |
diffstat | 2 files changed, 127 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- 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/>
--- 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/>