GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DNSVIZ-GROK (1)

NAME

dnsviz-grok - assess diagnostic DNS queries

CONTENTS

Synopsis
Description
Options
Exit Codes
See Also

SYNOPSIS

dnsviz grok [options] [domain_name...]

DESCRIPTION

Process the results of diagnostic DNS queries previously performed, e.g., using "dnsviz probe", 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 programmatic 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 arguments, in a file (using the -f option), or simply implied using the diagnostic query input. The latter is the preferred methodology (and the simplest) and is useful, except in cases where the input contains diagnostic 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 example.com, www.example.com, _443._tcp.example.com, 1.2.0.192.in-addr.arpa, or 8.b.d.0.1.0.0.2.ip6.arpa. Because it is implied that specified domain names are fully qualified, no trailing dot is necessary.

OPTIONS

-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 diagnostic 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.
-p Make JSON output "pretty" instead of minimal (i.e., using indentation 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 "debug".
-h Display the usage and exit.

EXIT CODES

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.

SEE ALSO

dnsviz(1), dnsviz-probe(1), dnsviz-graph(1), dnsviz-print(1), dnsviz-query(1)
Search for    or go to Top of page |  Section 1 |  Main Index


v0.5.0 DNSVIZ-GROK (1) 13 Dec 2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.