GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DNSDIST (1)

NAME

B]dnsdist] - tool to balance DNS queries over downstream servers

CONTENTS

Synopsis
Description
Scope
Options
Bugs
Resources
Authors

SYNOPSIS

dnsdist [I]OPTION]]... I]ADDRESS]...

DESCRIPTION

B]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.

B]dnsdist] is scriptable in Lua, see the dnsdist documentation for more information on this.

SCOPE

dnsdist does not [aq]think[aq] 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

-a,--acl I]NETMASK]
  Add I]NETMASK] to the ACL.
-C,--config I]FILE]
  Load configuration from I]FILE].
-c,--client
  Operate as a client, connect to dnsdist.
-d,--daemon
  Operate as a daemon.
-e,--execute I]CMD]
  Connect to dnsdist and execute I]CMD].
-h,--help Display a helpful message and exit.
-l,--local I]ADDRESS]
  Bind to I]ADDRESS], Supply as many addresses (using multiple B]--local] statements) to listen on as required. Specify IPv4 as 0.0.0.0:53 and IPv6 as [::]:53.
--supervised
  Run in foreground, but do not spawn a console. Use this switch to run dnsdist inside a supervisor (use with e.g. systemd and daemontools).
-p,--pidfile I]FILE]
  Write a pidfile to I]FILE], works only with B]--daemon].
-u,--uid I]UID]
  Change the process user to I]UID] after binding sockets. I]UID] can be a name or number.
-g,--gid I]GID]
  Change the process group to I]GID] after binding sockets. I]GID] Can be a name or number.
-V,--version
  Show the dnsdist version and exit.
ADDRESS
  Any number of downstream DNS servers, in the same syntax as used with B]--local]. If the port is not specified, 53 is used.

BUGS

Right now, the TCP support has some rather arbitrary limits.

RESOURCES

Website: http://dnsdist.org

AUTHORS

PowerDNS.com BV.
Search for    or go to Top of page |  Section 1 |  Main Index


DNSDIST (1) 2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.