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

FreeBSD Manual Pages


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

       dnsviz-grok - assess diagnostic DNS queries

       dnsviz grok [ options ] [ domain_name...	]

       Process	the  results  of  diagnostic DNS queries previously performed,
       e.g., using dnsviz-probe(1), to assess the health of the	associated DNS
       deployments  for	 one  or  more domain names specified.	The results of
       this processing are serialized into JSON	format	for  further  program-
       matic diagnostics or alerts.

       The  source  of	the  diagnostic	query input is either a	file specified
       with -r or standard input.

       Domain names to be processed may	be passed either as command-line argu-
       ments, in a file	(using the -f option), or simply implied using the di-
       agnostic	query input.  The latter is the	preferred methodology (and the
       simplest) and is	useful,	except in cases	where the input	contains diag-
       nostic queries for multiple domain names, only a	subset of which	are to
       be processed.

       If -f is	not used and no	domain names are supplied on the command line,
       then the	domain names to	be processed are extracted from	the diagnostic
       query input.  If	the -f option is used, then names may not be specified
       on the command line.

       The domain names	passed as input	are fully-qualified domain names, such
       as,,,, or	Because	 it  is	 implied  that
       specified  domain  names	are fully qualified, no	trailing dot is	neces-

       -f     filename Read names from a file (one name	per line), instead  of
	      from command line.

	      If  this	option is used,	then names may not be specified	on the
	      command line.

       -r     filename Read diagnostic query input from	 the  specified	 file,
	      instead of from standard input.

       -t filename
	      Use  trusted  keys from the specified file when processing diag-
	      nostic queries.  This overrides the default  behavior  of	 using
	      the installed keys for the root zone.

	      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.

	      This option may be used multiple times on	the command line.

       -C     Enforce DNS cookies strictly. Require a server to	return a "BAD-
	      COOKIE" response when a query contains a COOKIE option  with  no
	      server cookie or with an invalid server cookie.

       -o filename
	      Write  the  output  to the specified file	instead	of to standard
	      output, which is the default.

       -c     Format JSON output minimally instead of "pretty" (i.e., with in-
	      dentation	and newlines).

       -l level
	      Display  only  information  at  the  specified  log  priority or
	      higher.  Valid values (in	increasing  order  of  priority)  are:
	      "error",	"warning",  "info",  and "debug".  The default is "de-

       -h     Display the usage	and exit.

       The exit	codes are:

       0      Program terminated normally.

       1      Incorrect	usage.

       2      Required package dependencies were not found.

       3      There was	an error processing the	input or saving	the output.

       4      Program execution	was interrupted, or an unknown error occurred.

       dnsviz(1), dnsviz-probe(1), dnsviz-graph(1),  dnsviz-print(1),  dnsviz-

0.8.2				  12 Mar 2019			dnsviz-grok(1)


Want to link to this manual page? Use this URL:

home | help