Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 2452:4487310de7e7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added IDs to resolver parameters, minor language fixes in resolver.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Oct 2019 19:19:25 +0300
parents a26a42699207
children 3896055c397e
comparison
equal deleted inserted replaced
2451:721f78cff4ef 2452:4487310de7e7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_core_module" 10 <module name="Module ngx_http_core_module"
11 link="/en/docs/http/ngx_http_core_module.html" 11 link="/en/docs/http/ngx_http_core_module.html"
12 lang="en" 12 lang="en"
13 rev="86"> 13 rev="87">
14 14
15 <section id="directives" name="Directives"> 15 <section id="directives" name="Directives">
16 16
17 <directive name="absolute_redirect"> 17 <directive name="absolute_redirect">
18 <syntax><literal>on</literal> | <literal>off</literal></syntax> 18 <syntax><literal>on</literal> | <literal>off</literal></syntax>
2126 Configures name servers used to resolve names of upstream servers 2126 Configures name servers used to resolve names of upstream servers
2127 into addresses, for example: 2127 into addresses, for example:
2128 <example> 2128 <example>
2129 resolver 127.0.0.1 [::1]:5353; 2129 resolver 127.0.0.1 [::1]:5353;
2130 </example> 2130 </example>
2131 An address can be specified as a domain name or IP address, 2131 The address can be specified as a domain name or IP address,
2132 and an optional port (1.3.1, 1.2.2). 2132 with an optional port (1.3.1, 1.2.2).
2133 If port is not specified, the port 53 is used. 2133 If port is not specified, the port 53 is used.
2134 Name servers are queried in a round-robin fashion. 2134 Name servers are queried in a round-robin fashion.
2135 <note> 2135 <note>
2136 Before version 1.1.7, only a single name server could be configured. 2136 Before version 1.1.7, only a single name server could be configured.
2137 Specifying name servers using IPv6 addresses is supported 2137 Specifying name servers using IPv6 addresses is supported
2138 starting from versions 1.3.1 and 1.2.2. 2138 starting from versions 1.3.1 and 1.2.2.
2139 </note> 2139 </note>
2140 </para>
2141
2142 <para id="resolver_ipv6">
2140 By default, nginx will look up both IPv4 and IPv6 addresses while resolving. 2143 By default, nginx will look up both IPv4 and IPv6 addresses while resolving.
2141 If looking up of IPv6 addresses is not desired, 2144 If looking up of IPv6 addresses is not desired,
2142 the <literal>ipv6=off</literal> parameter can be specified. 2145 the <literal>ipv6=off</literal> parameter can be specified.
2143 <note> 2146 <note>
2144 Resolving of names into IPv6 addresses is supported 2147 Resolving of names into IPv6 addresses is supported
2145 starting from version 1.5.8. 2148 starting from version 1.5.8.
2146 </note> 2149 </note>
2150 </para>
2151
2152 <para id="resolver_valid">
2147 By default, nginx caches answers using the TTL value of a response. 2153 By default, nginx caches answers using the TTL value of a response.
2148 An optional <literal>valid</literal> parameter allows overriding it: 2154 An optional <literal>valid</literal> parameter allows overriding it:
2149 <example> 2155 <example>
2150 resolver 127.0.0.1 [::1]:5353 valid=30s; 2156 resolver 127.0.0.1 [::1]:5353 valid=30s;
2151 </example> 2157 </example>