dnsviz-query - assess a DNS query
] [ -b address
] [ -c class
] [ -q name
] [ -t type
] [ -x addr
] [ -4
] [ -6
] [ name
] [ class
] [ queryopt...
query [ -h ]
query [ global-queryopt... ] [ query... ]
Issue queries for the names and types specified on the command line to DNS
servers, process the output, and present it to the user. dnsviz-query
adopts a subset of the command-line options used by ISC's dig(1)
to issue queries and
assess the results. It is meant to be a shortcut for quickly assessing DNS
queries and diagnosing problems by invoking dnsviz-probe(1)
with their most commonly used options and with a usage
familiar similar to (but not equal to) dig(1)
. For a more detailed
analysis, revealing the nature of errors, the user should use
By default diagnostic queries are sent to recursive servers. If no servers are
specified with "@", then the first server in /etc/resolv.conf is
selected. Note that unlike dig(1) dnsviz-query(1)
only tries one
is used, the behavior changes, and the root authoritative
servers are first queried and referrals are followed downwards to the name(s)
To simplify usage a default root trusted key if none is specified on the command
line with +trusted-key
- -x address
- Specify and IPv4 or IPv6 address for a reverse DNS (i.e.,
- -b address
- Specify a source IPv4 or IPv6 address for queries, rather
than detecting it. This option can be used more than once to supply both
an IPv4 and an IPv6 address.
The use of this option is sometimes necessary when using a dual-homed
machine, and it is desirable to use the non-default interface for
- -q name
- Specify a query name.
- -t type
- Specify a query type.
- -c class
- Specify a query class (currently, only IN is supported; all
other classes are ignored).
- Use IPv4 only. If this is specified, then queries over IPv6
are not attempted, unless -6 is also specified.
- Use IPv6 only. If this is specified, then queries over IPv4
are not attempted, unless -4 is also specified.
- Query authoritative servers, beginning at the DNS root, and
follow referrals downwards. The default is to query a recursive server
- Specify a file that contains trusted keys for processing
The format of this file is master zone file format and should contain DNSKEY
records that correspond to one more trusted keys for one or more DNS
The exit codes are:
- Program terminated normally.
dnsviz(1), dnsviz-probe(1), dnsviz-grok(1),
- Program execution was interrupted, or an unknown error