Reword `udp_answer_limit` for the better.

This commit is contained in:
Sean Chittenden 2016-03-29 23:48:22 -07:00
parent 49f8b147b8
commit 7603dcfd4b
1 changed files with 8 additions and 6 deletions

View File

@ -509,15 +509,17 @@ Consul will not enable TLS for the HTTP API unless the `https` port has been ass
* <a name="udp_answer_limit"></a><a * <a name="udp_answer_limit"></a><a
href="#udp_answer_limit">`udp_answer_limit`</a> - Limit the number of href="#udp_answer_limit">`udp_answer_limit`</a> - Limit the number of
resource records contained in the answer section of a UDP-based DNS resource records contained in the answer section of a UDP-based DNS
response. The default number of resource records returned is `3`. In response. When answering a question, Consul will use the complete list of
environments where matching hosts, shuffle the list randomly, and then limit the number of
answers to `udp_answer_limit` (default `3`). In environments where
[RFC 3484 Section 6](https://tools.ietf.org/html/rfc3484#section-6) Rule 9 [RFC 3484 Section 6](https://tools.ietf.org/html/rfc3484#section-6) Rule 9
is implemented and enforced (i.e. DNS answers are always sorted and is implemented and enforced (i.e. DNS answers are always sorted and
therefore never random), clients may need to set this value to `1` to therefore never random), clients may need to set this value to `1` to
preserve round-robin DNS (note: [https://tools.ietf.org/html/rfc3484](RFC preserve the expected randomized distribution behavior (note:
3484) has been obsoleted by [RFC 6724](https://tools.ietf.org/html/rfc6724) [https://tools.ietf.org/html/rfc3484](RFC 3484) has been obsoleted by
and as a result it should be increasingly uncommon to need to change this [RFC 6724](https://tools.ietf.org/html/rfc6724) and as a result it should
value with modern resolvers). be increasingly uncommon to need to change this value with modern
resolvers).
* <a name="domain"></a><a href="#domain">`domain`</a> Equivalent to the * <a name="domain"></a><a href="#domain">`domain`</a> Equivalent to the
[`-domain` command-line flag](#_domain). [`-domain` command-line flag](#_domain).