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  -  KDIG (1)

NAME

kdig - Advanced DNS lookup utility \$1 \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2]

CONTENTS

Synopsis
Description
     Parameters
     Options
Notes
Examples
Files
See Also
Author
Copyright

SYNOPSIS

kdig [common-settings] [query [settings]]...

kdig -h

DESCRIPTION

This utility sends one or more DNS queries to a nameserver. Each query can have individual settings, or it can be specified globally via common-settings, which must precede query specification.

    Parameters

query name | -q name | -x address | -G tapfile
common-settings, settings
  [class] [type] [@server]... [options]
name Is a domain name that is to be looked up.
server Is a domain name or an IPv4 or IPv6 address of the nameserver to send a query to. An additional port can be specified using address:port ([address]:port for IPv6 address), address@port, or address#port notation. If no server is specified, the servers from /etc/resolv.conf are used.

If no arguments are provided, kdig sends NS query for the root zone.

    Options

-4 Use the IPv4 protocol only.
-6 Use the IPv6 protocol only.
-b address
  Set the source IP address of the query to address. The address must be a valid address for local interface or :: or 0.0.0.0. An optional port can be specified in the same format as the server value.
-c class Set the query class (e.g. CH, CLASS4). An explicit variant of class specification. The default class is IN.
-d Enable debug messages.
-h, --help Print the program help.
-k keyfile
  Use the TSIG key stored in a file keyfile to authenticate the request. The file must contain the key in the same format as accepted by the -y option.
-p port Set the nameserver port number or service name to send a query to. The default port is 53.
-q name Set the query name. An explicit variant of name specification.
-t type Set the query type (e.g. NS, IXFR=12345, TYPE65535, NOTIFY). An explicit variant of type specification. The default type is A. IXFR type requires SOA serial parameter. NOTIFY type without SOA serial parameter causes pure NOTIFY message without any SOA hint.
-V, --version
  Print the program version.
-x address
  Send a reverse (PTR) query for IPv4 or IPv6 address. The correct name, class and type is set automatically.
-y [alg:]name:key
  Use the TSIG key named name to authenticate the request. The alg part specifies the algorithm (the default is hmac-md5) and key specifies the shared secret encoded in Base64.
-E tapfile
  Export a dnstap trace of the query and response messages received to the file tapfile.
-G tapfile
  Generate message output from a previously saved dnstap file tapfile.
+[no]multiline
  Wrap long records to more lines and improve human readability.
+[no]short
  Show record data only.
+[no]aaflag
  Set the AA flag.
+[no]tcflag
  Set the TC flag.
+[no]rdflag
  Set the RD flag.
+[no]recurse
  Same as +[no]rdflag
+[no]raflag
  Set the RA flag.
+[no]zflag
  Set the zero flag bit.
+[no]adflag
  Set the AD flag.
+[no]cdflag
  Set the CD flag.
+[no]dnssec
  Set the DO flag.
+[no]all
  Show all packet sections.
+[no]qr
  Show the query packet.
+[no]header
  Show the packet header.
+[no]opt
  Show the EDNS pseudosection.
+[no]question
  Show the question section.
+[no]answer
  Show the answer section.
+[no]authority
  Show the authority section.
+[no]additional
  Show the additional section.
+[no]tsig
  Show the TSIG pseudosection.
+[no]stats
  Show trailing packet statistics.
+[no]class
  Show the DNS class.
+[no]ttl
  Show the TTL value.
+[no]tcp
  Use the TCP protocol (default is UDP for standard query and TCP for AXFR/IXFR).
+[no]ignore
  Don\(aqt use TCP automatically if a truncated reply is received.
+[no]nsid
  Request the nameserver identifier (NSID).
+[no]edns=N
  Use EDNS version (default is 0).
+noidn Disable the IDN transformation to ASCII and vice versa. IDNA2003 support depends on libidn availability during project building!
+generic
  Use the generic representation format when printing resource record types and data.
+client=SUBN
  Set the EDNS client subnet SUBN=IP/prefix.
+time=T
  Set the wait-for-reply interval in seconds (default is 5 seconds). This timeout applies to each query attempt.
+retry=N
  Set the number (>=0) of UDP retries (default is 2). This doesn\(aqt apply to AXFR/IXFR.
+bufsize=B
  Set the EDNS buffer size in bytes (default is 512 bytes).

NOTES

Options -k and -y can not be used simultaneously.

Missing features with regard to ISC dig: Options -f and -m and query options: +split=W, +tries=T, +ndots=D, +domain=somename, +trusted-key=####, +[no]fail, +[no]vc, +[no]search, +[no]showsearch, +[no]defname, +[no]aaonly, +[no]cmd, +[no]identify, +[no]comments, +[no]rrcomments, +[no]onesoa, +[no]besteffort, +[no]sigchase, +[no]topdown, +[no]nssearch, and +[no]trace.

Per-user file configuration via ~/.digrc.

EXAMPLES

1. Get A records for example.com:


$ kdig example.com A


2. Perform AXFR for zone example.com from the server 192.0.2.1:


$ kdig example.com -t AXFR @192.0.2.1


3. Get A records for example.com from 192.0.2.1 and reverse lookup for address 2001:DB8::1 from 192.0.2.2. Both using the TCP protocol:


$ kdig +tcp example.com -t A @192.0.2.1 -x 2001:DB8::1 @192.0.2.2


FILES

/etc/resolv.conf

SEE ALSO

khost(1), knsupdate(1).

AUTHOR

CZ.NIC Labs <http://www.knot-dns.cz>

COPYRIGHT

Copyright 2010–2016, CZ.NIC, z.s.p.o.
Search for    or go to Top of page |  Section 1 |  Main Index


2.1.1 KDIG (1) 2016-02-10

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