-DNSDIST(1)\r
+DNSDIST(1)
==========
powerdns.documentation@powerdns.com
NAME
----
-dnsdist - tool to balance DNS queries over downstream servers\r
+dnsdist - tool to balance DNS queries over downstream servers
SYNOPSIS
--------
-'dnsdist' [--help] [--verbose] [--local address] downstream-address downstream-address\r
-\r
+'dnsdist' [--help] [--verbose] [--local address] downstream-address downstream-address
+
DESCRIPTION
-----------
-dnsdist receives DNS queries and relays them to one or more downstream\r
-servers. It subsequently sends back responses to the original requestor.\r
-\r
-dnsdist operates over TCP and UDP, and strives to deliver very high\r
-performance over both.\r
-\r
-Currently, queries are sent to the downstream server with the least\r
-outstanding queries. This effectively implies load balancing, making sure\r
-that slower servers get less queries.\r
-\r
-If a reply has not come in after a few seconds, it is removed from the\r
-queue, but in the short term, timeouts do cause a server to get less\r
-traffic.\r
-\r
-IPv4 and IPv6 operation can be mixed and matched, in other words, queries\r
-coming in over IPv6 could be forwarded to IPv4 and vice versa.\r
-\r
-SCOPE\r
------\r
-dnsdist does not 'think' about DNS, and does not perform any kind of\r
-caching, nor is it aware of the quality of the answers it is relaying.\r
-\r
-dnsdist assumes that each query leads to exactly one response, which is true\r
-for all DNS except for AXFR, which is therefore not supported.\r
-\r
-The goal for dnsdist is to remain simple. If more powerful loadbalancing is\r
-required, dedicated hardware or software is recommended. Linux Virtual\r
-Server for example is often mentioned.\r
-\r
+dnsdist receives DNS queries and relays them to one or more downstream
+servers. It subsequently sends back responses to the original requestor.
+
+dnsdist operates over TCP and UDP, and strives to deliver very high
+performance over both.
+
+Currently, queries are sent to the downstream server with the least
+outstanding queries. This effectively implies load balancing, making sure
+that slower servers get less queries.
+
+If a reply has not come in after a few seconds, it is removed from the
+queue, but in the short term, timeouts do cause a server to get less
+traffic.
+
+IPv4 and IPv6 operation can be mixed and matched, in other words, queries
+coming in over IPv6 could be forwarded to IPv4 and vice versa.
+
+SCOPE
+-----
+dnsdist does not 'think' about DNS, and does not perform any kind of
+caching, nor is it aware of the quality of the answers it is relaying.
+
+dnsdist assumes that each query leads to exactly one response, which is true
+for all DNS except for AXFR, which is therefore not supported.
+
+The goal for dnsdist is to remain simple. If more powerful loadbalancing is
+required, dedicated hardware or software is recommended. Linux Virtual
+Server for example is often mentioned.
+
OPTIONS
-------
--verbose::
Be wordy on what the program is doing
-\r
---local::\r
- Supply as many addresses to listen on as required. Specify IPv4 as\r
- 0.0.0.0:53 and IPv6 as [::]:53.\r
-\r
---daemon::\r
- Daemonize and run in the background\r
-\r
---help::\r
- Provide a helpful message\r
-\r
-Finally, supply as many downstream addresses as required. Remote port defaults to 53.\r
-\r
+
+--local::
+ Supply as many addresses to listen on as required. Specify IPv4 as
+ 0.0.0.0:53 and IPv6 as [::]:53.
+
+--daemon::
+ Daemonize and run in the background
+
+--help::
+ Provide a helpful message
+
+Finally, supply as many downstream addresses as required. Remote port defaults to 53.
+
BUGS
----
-Right now, the TCP support has some rather arbitrary limits. \r
-\r
+Right now, the TCP support has some rather arbitrary limits.
+
AUTHOR
------
Written by PowerDNS.COM BV, powerdns.documentation@powerdns.com
projects / pdns / commitdiff