SYNOPSIS
dnswalk [ -adilrfFm ] domain.
DESCRIPTION
dnswalk is a DNS debugger. It performs zone transfers of specified
domains, and checks the database in numerous ways for internal consis-
tency, as well as for correctness according to accepted practices with
the Domain Name System.
The domain name specified on the command line MUST end with a '.'. You
can specify a forward domain, such as dnswalk podunk.edu. or a reverse
domain, such as dnswalk 3.2.1.in-addr.arpa.
OPTIONS
-r Recursively descend sub-domains of the specified domain. Use
with care.
-a Turn on warning of duplicate A records. (see below)
-d Print debugging and 'status' information to stderr. (Use only
if redirecting stdout) See DIAGNOSTICS section.
-m Perform checks only if the zone has been modified since the pre-
vious run.
-F perform "fascist" checking. When checking an A record, compare
the PTR name for each IP address with the forward name and
report mismatches. (see below) I recommend you try this option
at least once to see what sorts of errors pop up - you might be
surprised!.
-i Suppress check for invalid characters in a domain name. (see
below)
-l Perform "lame delegation" checking. For every NS record, check
to see that the listed host is indeed returning authoritative
answers for this domain.
ERRORS The following the list of error messages that dnswalk will
return if it sees a potential problem with the database. Dupli-
cate messages will be suppressed automatically for each zone.
Error messages are prefixed by a keyword indiciating the message
type: "WARN" (possible data problem), "FAIL" (failure to access
data), or "BAD" (invalid data). dnswalk exits with a return
code equal to the number of "BAD" errors.
X PTR Y: unknown host
X is a PTR record to Y, but Y is not a valid host (no A record).
These are often left over from when someone deleted a host from
the DNS and forgot to delete the PTR record.
X PTR Y: A record not found
X is a PTR record to Y, but the IP address associated with the
PTR record is not listed as an address for Y. There should be
an A record for every valid IP address for a host. Many Inter-
net services will not talk to you if you have mismatched PTR
records.
X PTR Y: CNAME (to Z)
X is a PTR record to Y, but Y is a CNAME to Z. PTR records MUST
point to the canonical name of a host, not an alias.
don't have PTR records.
warning: X has only one authoritative nameserver
Zones must have at least one authoritative nameserver, in case
one is down or unreachable. Make sure the parent and child
domains list all authoritative nameservers for a zone.
Cannot check X: no available nameservers!
The X zone was delegated with NS records but all the name-
servers for the zone are either unavailable or say that they
have no data for the zone (are lame). Verify that the X zone
isn't a typo, and if so make sure that all the listed name-
servers are configured to answer with data for the zone.
X: invalid character(s) in name
Allowable characters in a domain name are the ASCII letters a
through Z the digits 0 through 9, and the "-" character. A "."
may be used only as a domain separator. (checking can be sup-
pressed with -i )
X: domain occurred twice, forgot trailing '.'?
A sanity check which looks for "dom.ain.dom.ain." in a name.
This is often caused by forgetting to put a trailing '.' on the
end of a name.
(with -a switch)
X: possible duplicate A record (glue of Z?)
A duplicate A records is listed for X. NOTE: this is most often
caused by the practice of always putting A records for all sec-
ondaries after NS glue records. While this is not an error, it
is usually redundant and makes changing IP addresses later more
difficult, since they occur more than one time in the file (and
in multiple files). You may get spurious errors, mostly because
of a quirk in BIND releases before 4.9.x that reports cached
glue A records in a zone transfer even though they don't exist
in the original zone file.
(with -F switch)
X A Y: points to Z
X has Y for an IP address, but the PTR record associated with Y
returns "Z" as the name associated with that host. This is not
necessarily an error (for example if you have an A record for
your domain name), but can be useful to check for A records
which point to the wrong host, or PTR records that point to the
wrong host.
Cannot find address for nameserver X
This error is generated if the address for a delegated name-
server X cannot be resolved. This could be a lame delegation
(due to a typo in delegation), or a temporary DNS error.
(with -l switch)
X NS Y: lame NS delegation
Y is a listed nameserver for zone X, but Y is not returning
authoritative data for zone X. This is usually the result of a
lack of communication on the part of the respective hostmasters.
Lame delegations are not fatal problems except in severe cases,
they just tend to create significant increases in DNS traffic.
NS records for the parent and child domains should be consis-
tent, and each server listed in the NS record MUST be able to
checked, and a single letter corresponding to the resource record
checked, and any errors.
a A record
c CNAME record
p PTR record
m MX record
s SOA record
! An error occurred
. A previous error in the zone was repeated, but suppressed.
BUGS
dnswalk will make the directory tree before it has a chance to find out
that you gave it a bogus domain name.
When checking lots of hosts and lots of options, it is very slow. Run-
ning dnswalk on a machine with a local nameserver helps considerably.
Perl's gethostby{name,addr}() routine doesn't seem to consistently
return an error whenever it is unable to resolve an address. Argh.
This will mean lots of "no PTR record" and "host unknown" errors if a
server is unavailable, or for some reason the lookup fails. You may
get strange error messages if your perl was compiled without support
for herror().
AUTHOR
David Barr <barr@cis.ohio-state.edu>
DNSWALK(1)
Man(1) output converted with
man2html