coredns/middleware/loadbalance/README.md

# loadbalance

*loadbalance* acts as a round-robin DNS loadbalancer by randomizing the order of A and AAAA records
 in the answer. See [Wikipedia](https://en.wikipedia.org/wiki/Round-robin_DNS) about the pros and
 cons on this setup.

It will take care to sort any CNAMEs before any address records, because some stub resolver
implementations (like glibc) are particular about that.

## Syntax

~~~
loadbalance [POLICY]
~~~

* **POLICY** is how to balance, the default is "round_robin"

## Examples

~~~
loadbalance round_robin
~~~
Add roundrobin middleware This middleware allows you to round robin a/aaaa records in a reply and maybe more in the future (i.e.) sort a packet? 2016-03-23 15:57:48 +00:00			`# loadbalance`

docs: rewrite using manpage style (#327) This still needs cleanup, but this is a first pass the cleans some cruft and documents our style (in middleware.md) and makes all the docs match that style. 2016-10-10 20:13:22 +01:00			`loadbalance acts as a round-robin DNS loadbalancer by randomizing the order of A and AAAA records`
			`in the answer. See [Wikipedia](https://en.wikipedia.org/wiki/Round-robin_DNS) about the pros and`
			`cons on this setup.`
Add roundrobin middleware This middleware allows you to round robin a/aaaa records in a reply and maybe more in the future (i.e.) sort a packet? 2016-03-23 15:57:48 +00:00
Doc updates Remove miek.nl in favor of example.org and other smaller cleanups. 2016-08-22 07:47:03 +01:00			`It will take care to sort any CNAMEs before any address records, because some stub resolver`
Update README.md Grammatical fixes. 2016-08-22 14:25:19 -07:00			`implementations (like glibc) are particular about that.`
Add test for CNAME ordering Add a test for SkyDNS': https://github.com/skynetservices/skydns/issues/217 Put the CNAME in front for both answer and extra sections. Note that the etcd middleware seems to already to the correct thing though. 2016-03-26 09:53:40 +00:00
Add roundrobin middleware This middleware allows you to round robin a/aaaa records in a reply and maybe more in the future (i.e.) sort a packet? 2016-03-23 15:57:48 +00:00			`## Syntax`

			`~~~`
docs: rewrite using manpage style (#327) This still needs cleanup, but this is a first pass the cleans some cruft and documents our style (in middleware.md) and makes all the docs match that style. 2016-10-10 20:13:22 +01:00			`loadbalance [POLICY]`
Add roundrobin middleware This middleware allows you to round robin a/aaaa records in a reply and maybe more in the future (i.e.) sort a packet? 2016-03-23 15:57:48 +00:00			`~~~`

docs: rewrite using manpage style (#327) This still needs cleanup, but this is a first pass the cleans some cruft and documents our style (in middleware.md) and makes all the docs match that style. 2016-10-10 20:13:22 +01:00			`* POLICY is how to balance, the default is "round_robin"`
Add roundrobin middleware This middleware allows you to round robin a/aaaa records in a reply and maybe more in the future (i.e.) sort a packet? 2016-03-23 15:57:48 +00:00
			`## Examples`

			`~~~`
			`loadbalance round_robin`
			`~~~`