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
	      Specify  a  file that contains trusted keys for processing diag-
	      nostic queries.  The default is to not use any trusted keys.

	      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.

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

       -c     Make  JSON  output minimal instead of "pretty" (i.e., remove 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 ocurred.

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

0.6.5				  18 Nov 2016			dnsviz-grok(1)


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

home | help