wtdnsinfo - WtDNS status information
wtdnsinfo [<query> | <dig> [parameters]]
The wtdnsinfo utility shows information and statistics from the currently running WtDNSd, and can be used to call dig for queries to the WtDNSd control sockets.
Since wtdnsd writes the information on how to query it for information to a file that is only readable by the user that started wtdnsd (typically root), wtdnsdinfo must be run by the same user.
Call dig with server and port set for the WtDNSd control socket. The rest of the wtdnsinfo commandline is forwarded to dig.
Query the daemon for resource record
Query the daemon for any resource records for domain name
The information from wtdnsd includes the following:
Name and version of wtdnsd.
Compile date and time of wtdnsd*.
Name of the host wtdnsd in running on.
Date and time at wich the current instance of wtdnsd was started.
How long the current instance of wtdnsd has been running.
The IP addresses and ports on wich wtdnsd is listening, excluding control sockets.
The statistics are shown in tables wich includes counters of connections and messages, and average sizes for messages. (Traffic on control sockets are not included.)
The counters include the following rows:
Incoming connection counters (each incoming UDP packet counts as one connection).
Incomming DNS messages (these should be queries).
Outgoing DNS messages (responses to icoming messages).
Resource record types queried for in incoming DNS queries.
Resource record types included in DNS response messages.
The counters include the following columns:
Total count.
Count of messages/connections using UDP.
Count of messages/connections using TCP.
Count of messages/connections over IPv4.
Count of messages/connections over IPv6.
Count of messages with an EDNS OPT pseudo record.
Count of messages with a DNSSEC Ok flag.
Count of not-found responses (including NXDOMAIN).
Count of responses that were truncated because they were to big.
Count of messages that were seen as invalid or broken.
Count of messages announcing errors.
The average sizes include the following rows:
Average size of incoming DNS messages (these should be queries), excluding network overhead.
Average size of outgoing DNS messages (responses to incoming messages), excluding network overhead.
Average announced maximum size.
The average sizes include the following columns:
Average size of DNS messages.
Average size of messages over UDP.
Average size of messages over TCP.
Average size for messages with an EDNS OPT pseudo record.
The following global options are recognized in the configuration file.
This file contains the information needed for wtdnsinfo to connect to wtdnsd.
The global configuration file.
wtdnsinfo requires that wtdnsd has been started with the -cs option. # SEE ALSO
wtdns(8), wtdns.ini(8), wtdnsadd(8), wtdnssign(8), wtdnshash(8), wtdns-deepen(8), wtdns-flatten(8), wtdnsd(8), wtdns-fromlog(8), wtdns-maintain(8), dig(1)