NAME

dnstable_lookup - lookup individual records in a dnstable data file or set of data files

SYNOPSIS

dnstable_lookup [-R] [-j] [-J] [-u] [-O #] rrset <OWNER> [<RRTYPE> [<BAILIWICK>]]

dnstable_lookup [-R] [-j] [-J] [-u] [-O #] rdata ip <ADDRESS | RANGE | PREFIX>

dnstable_lookup [-R] [-j] [-J] [-u] [-O #] rdata raw <HEX STRING> [<RRTYPE>]

dnstable_lookup [-R] [-j] [-J] [-u] [-O #] rdata name <RDATA NAME> [<RRTYPE>]

dnstable_lookup [-j] [-J] [-u] [-O #] time_range

dnstable_lookup [-j] [-J] [-u] [-O #] version [<ETYPE>]

DESCRIPTION

Looks up records in a dnstable data file or fileset. Results are printed to stdout in an ad-hoc text format or in JSON format if -j or -J are given.

dnstable_lookup rrset returns RRsets matching the specified owner name (wildcards permitted). A resource record type and bailiwick domain name can optionally be specified.

dnstable_lookup rdata ip returns A or AAAA type Resource Records matching the specified IP address, IP prefix, or IP range.

dnstable_lookup rdata raw returns Resource Records whose record data matches the specified data value, expressed as a hexadecimal string.

dnstable_lookup rdata name returns Resource Records whose record data matches the specified domain name.

dnstable_lookup time_range returns an entry containing the time range for data within the data file or fileset.

dnstable_lookup version returns version entries. The optional ETYPE parameter can be used to request a specific type’s version. ETYPE may be one of rrset, rrset_name, rdata, or rdata_name

OPTIONS

-R, --raw

When using a JSON format for output, add a hex representation of the raw rdata and the rrtype.

-j

Use JSON format for output, with timestamps in epoch time (seconds since epoch). Default is dig presentation format. One JSON-formatted entry per line will be printed.

-J

Use JSON format for output, with timestamps in human time (RFC3339 format). Default is dig presentation format. One JSON-formatted entry per line will be printed.

-u

Output unaggregated results; default is aggregated results.

-O #

Offset (e.g. skip) the first # results.

ENVIRONMENT VARIABLES

Exactly one of the following environment variables must be set in order to specify the dnstable data file(s) to query.

DNSTABLE_FNAME

Path to a single dnstable data file.

DNSTABLE_SETFILE

Path to a "set file", a text file containing a newline separated list of dnstable data files on the filesystem. Results from all of the data files will be merged.

EXAMPLES

$ export DNSTABLE_FNAME=/path/to/dns.mtbl

$ dnstable_lookup rrset www.example.com

$ dnstable_lookup rrset example.com ns com

$ dnstable_lookup rdata ip 192.0.2.1

$ dnstable_lookup rdata ip 198.51.100.0/24

$ dnstable_lookup rdata ip 203.0.113.1-203.0.113.100

$ dnstable_lookup -j rdata ip 2001:db8::/32

$ dnstable_lookup -R -j rdata ip 2001:db8::/32

$ dnstable_lookup -u rdata ip 2001:db8::/32

$ dnstable_lookup -O 10 rdata ip 2001:db8::/32

$ dnstable_lookup rdata raw c00505f1

$ dnstable_lookup rdata name BLACKHOLE-1.IANA.ORG