changeset 185:05e7496801ec

Documented recent changes in the "resolver" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 16 Nov 2011 13:14:10 +0000
parents 4840aa7bab2c
children abc48ad4b7c4
files xml/en/docs/http/ngx_http_core_module.xml
diffstat 1 files changed, 13 insertions(+), 1 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
@@ -1670,7 +1670,10 @@ closed normally.
 
 
 <directive name="resolver">
-<syntax><argument>address</argument> ...</syntax>
+<syntax>
+<argument>address</argument> ...
+[<parameter>valid</parameter>=<argument>time</argument>]
+</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -1689,6 +1692,15 @@ Name servers are queried in a round-robi
 <note>
 Before version 1.1.7, only a single name server could be configured.
 </note>
+By default, nginx caches answers using the TTL value of a response.
+An optional <parameter>valid</parameter> parameter allows to override it:
+<example>
+resolver 127.0.0.1 192.0.2.1 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>
 
 </directive>