1dnsviz-query(1)             General Commands Manual            dnsviz-query(1)
2
3
4

NAME

6       dnsviz-query - assess a DNS query
7

SYNOPSIS

9       dnsviz  query  [ @server ] [ -b address ] [ -c class ] [ -q name ] [ -t
10       type ] [ -x addr ] [ -4 ] [ -6 ] [ name ] [ type ] [ class ]  [  query‐
11       opt... ]
12
13       dnsviz query [ -h ]
14
15       dnsviz query [ global-queryopt... ] [ query... ]
16

DESCRIPTION

18       Issue  queries for the names and types specified on the command line to
19       DNS servers, process the output, and present it to the  user.   dnsviz-
20       query  adopts a subset of the command-line options used by ISC's dig(1)
21       but uses dnsviz-probe(1) and dnsviz-print(1) to issue queries  and  as‐
22       sess  the  results.  It is meant to be a shortcut for quickly assessing
23       DNS queries and diagnosing problems  by  invoking  dnsviz-probe(1)  and
24       dnsviz-print(1)  with their most commonly used options and with a usage
25       familiar similar to (but not equal to) dig(1).   For  a  more  detailed
26       analysis,  revealing  the nature of errors, the user should use dnsviz-
27       probe(1),  dnsviz-grok(1),  dnsviz-print(1),  and  dnsviz-graph(1)  di‐
28       rectly.
29
30       By  default  diagnostic  queries  are sent to recursive servers.  If no
31       servers are specified with "@",  then  the  first  server  in  /etc/re‐
32       solv.conf  is  selected.   Note that unlike dig(1) dnsviz-query(1) only
33       tries one server.
34
35       If +trace is used, the behavior changes,  and  the  root  authoritative
36       servers  are  first queried and referrals are followed downwards to the
37       name(s) in question.
38
39       To simplify usage a default root trusted key if none  is  specified  on
40       the command line with +trusted-key.
41
42

OPTIONS

44       -x address
45              Specify  and  IPv4 or IPv6 address for a reverse DNS (i.e., PTR)
46              lookup.
47
48       -b address
49              Specify a source IPv4 or IPv6 address for queries,  rather  than
50              detecting  it.  This option can be used more than once to supply
51              both an IPv4 and an IPv6 address.
52
53              The use of this option is sometimes necessary when using a dual-
54              homed machine, and it is desirable to use the non-default inter‐
55              face for queries.
56
57       -q name
58              Specify a query name.
59
60       -t type
61              Specify a query type.
62
63       -c class
64              Specify a query class (currently,  only  IN  is  supported;  all
65              other classes are ignored).
66
67       -4     Use IPv4 only.  If this is specified, then queries over IPv6 are
68              not attempted, unless -6 is also specified.
69
70       -6     Use IPv6 only.  If this is specified, then queries over IPv4 are
71              not attempted, unless -4 is also specified.
72
73

QUERY OPTIONS

75       +[no]trace
76              Query authoritative servers, beginning at the DNS root, and fol‐
77              low referrals downwards.  The default is to  query  a  recursive
78              server instead.
79
80       +trusted-key=filename
81              Specify  a  file that contains trusted keys for processing diag‐
82              nostic queries.
83
84              The format of this file is master zone file  format  and  should
85              contain  DNSKEY records that correspond to one more trusted keys
86              for one or more DNS zones.
87

EXIT CODES

89       The exit codes are:
90
91       0      Program terminated normally.
92
93       1      Program execution was interrupted, or an unknown error occurred.
94

SEE ALSO

96       dnsviz(1), dnsviz-probe(1),  dnsviz-grok(1),  dnsviz-graph(1),  dnsviz-
97       print(1)
98
99
100
1010.9.3                             11 Mar 2021                  dnsviz-query(1)