dnsproxy - DNS proxy
dnsproxy [-dhV] [-c file]
The dnsproxy daemon waits for nameserver queries on a user specified
address, dispatches these queries to authoritative and recursive
nameservers and forwards the received answers back to the original
The options are as follows:
-c file Read configuration from file.
-d Detach from current terminal and run as background process.
-h Show usage.
-V Show version.
If a client from an internal IP address does a recursive lookup the query
is forwarded to a recursive DNS server. Authoritative queries and
queries coming from clients in foreign networks are forwarded to an
authoritative DNS server.
At startup dnsproxy reads a configuration file specified via the -c
option or at the default location of /etc/dnsproxy.conf.
The following keywords are recognized:
Address of the authoritative nameserver [required].
Address of the recursive nameserver [required].
Local address (defaults to 0.0.0.0).
Local port number (defaults to 53).
A path to chroot to before starting to answer queries.
A user to change to before starting to answer queries.
Time in seconds when authoritative queries time out (defaults to 10).
Time in seconds when recursive queries time out (defaults to 90).
Port number on authoritative nameserver (defaults to 53).
Port number on recursive nameserver (defaults to 53).
Period between output of statistics (defaults to 3600). Use 0 to disable
output of statistics completely.
Declare networks recognized as internal and thus eligible to do recursive
queries. One network in CIDR notation per keyword.
Every hour (by default) dnsproxy logs the collected statistics about its
usage to standard error (or syslog when running detached). Statistics
ActiveQr AuthorQr RecursQr AllQuery Answered
0 0 0 0 0
TimeoutQ DroppedQ DroppedA LateAnsw HashColl
0 0 0 0 0
and have the following meaning:
Number of currently active queries proxied to the servers.
Accumulated number of authoritative queries.
Accumulated number of recursive queries.
Accumulated number of all queries ever received.
Accumulated number of answered queries.
Accumulated number of queries that did not receive an answer in time.
Accumulated number of dropped queries (e.g. transmission errors).
Accumulated number of dropped answers.
Accumulated number of answers received after the timeout period.
Accumulated number of hash collisions in the query list.
This manual page describes dnsproxy version 1.16.
Armin Wolfermann <email@example.com>
The dnsproxy homepage is at http://www.wolfermann.org/dnsproxy.html.