Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dnsviz-query(1)		    General Commands Manual	       dnsviz-query(1)

NAME
       dnsviz-query - assess a DNS query

SYNOPSIS
       dnsviz  query  [	@server	] [ -b address ] [ -c class ] [	-q name	] [ -t
       type ] [	-x addr	] [ -4 ] [ -6 ]	[ name ] [ type	] [ class ]  [	query-
       opt... ]

       dnsviz query [ -h ]

       dnsviz query [ global-queryopt... ] [ query... ]

DESCRIPTION
       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)
       but uses	dnsviz-probe(1)	and dnsviz-print(1) to issue queries  and  as-
       sess  the  results.  It is meant	to be a	shortcut for quickly assessing
       DNS queries and diagnosing problems  by	invoking  dnsviz-probe(1)  and
       dnsviz-print(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 dnsviz-
       probe(1),  dnsviz-grok(1),  dnsviz-print(1),  and  dnsviz-graph(1)  di-
       rectly.

       By  default  diagnostic	queries	 are sent to recursive servers.	 If no
       servers are specified with "@",	then  the  first  server  in  /etc/re-
       solv.conf  is  selected.	  Note that unlike dig(1) dnsviz-query(1) only
       tries one server.

       If +trace is used, the behavior changes,	 and  the  root	 authoritative
       servers	are  first queried and referrals are followed downwards	to the
       name(s) in question.

       To simplify usage a default root	trusted	key if none  is	 specified  on
       the command line	with +trusted-key.

OPTIONS
       -x address
	      Specify  and  IPv4 or IPv6 address for a reverse DNS (i.e., PTR)
	      lookup.

       -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	inter-
	      face for queries.

       -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).

       -4     Use IPv4 only.  If this is specified, then queries over IPv6 are
	      not attempted, unless -6 is also specified.

       -6     Use IPv6 only.  If this is specified, then queries over IPv4 are
	      not attempted, unless -4 is also specified.

QUERY OPTIONS
       +[no]trace
	      Query authoritative servers, beginning at	the DNS	root, and fol-
	      low referrals downwards.	The default is to  query  a  recursive
	      server instead.

       +trusted-key=filename
	      Specify  a  file that contains trusted keys for processing diag-
	      nostic queries.

	      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 zones.

EXIT CODES
       The exit	codes are:

       0      Program terminated normally.

       1      Program execution	was interrupted, or an unknown error ocurred.

SEE ALSO
       dnsviz(1), dnsviz-probe(1),  dnsviz-grok(1),  dnsviz-graph(1),  dnsviz-
       print(1)

0.6.5				  18 Nov 2016		       dnsviz-query(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | QUERY OPTIONS | EXIT CODES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dnsviz-query&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help