man.dig.html revision 297be3708069ef31814d6d75c0d71a50a78feb03
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek - Copyright (C) 2004-2008 Internet Systems Consortium, Inc. ("ISC")
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek - Copyright (C) 2000-2003 Internet Software Consortium.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek - Permission to use, copy, modify, and distribute this software for any
2cb6f28b3a12bb714bf14494d31eb6b6fff64b8bJakub Hrozek - purpose with or without fee is hereby granted, provided that the above
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek - copyright notice and this permission notice appear in all copies.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
ad805face83ba7d67b1cf2067a1982c7e63d1060Jakub Hrozek - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
ad805face83ba7d67b1cf2067a1982c7e63d1060Jakub Hrozek - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
a7797068c4deb6ce2bdbcda27c45ff1bbb4a8e78Jakub Hrozek - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
a7797068c4deb6ce2bdbcda27c45ff1bbb4a8e78Jakub Hrozek - PERFORMANCE OF THIS SOFTWARE.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<!-- $Id: man.dig.html,v 1.62 2008/01/03 01:12:37 marka Exp $ -->
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<link rel="prev" href="Bv9ARM.ch10.html" title="Manual pages">
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<link rel="next" href="man.host.html" title="host">
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<table width="100%" summary="Navigation header">
261cdde02b40aa8dabb3d69e43586a5a220647e9Jakub Hrozek<tr><th colspan="3" align="center">dig</th></tr>
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<a accesskey="p" href="Bv9ARM.ch10.html">Prev</a>�</td>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<th width="60%" align="center">Manual pages</th>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<td width="20%" align="right">�<a accesskey="n" href="man.host.html">Next</a>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<a name="man.dig"></a><div class="titlepage"></div>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<div class="cmdsynopsis"><p><code class="command">dig</code> [@server] [<code class="option">-b <em class="replaceable"><code>address</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-k <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port#</code></em></code>] [<code class="option">-q <em class="replaceable"><code>name</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-x <em class="replaceable"><code>addr</code></em></code>] [<code class="option">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]name:key</code></em></code>] [<code class="option">-4</code>] [<code class="option">-6</code>] [name] [type] [class] [queryopt...]</p></div>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<div class="cmdsynopsis"><p><code class="command">dig</code> [<code class="option">-h</code>]</p></div>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<div class="cmdsynopsis"><p><code class="command">dig</code> [global-queryopt...] [query...]</p></div>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<p><span><strong class="command">dig</strong></span>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek (domain information groper) is a flexible tool
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek for interrogating DNS name servers. It performs DNS lookups and
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek displays the answers that are returned from the name server(s) that
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek were queried. Most DNS administrators use <span><strong class="command">dig</strong></span> to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek troubleshoot DNS problems because of its flexibility, ease of use and
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek clarity of output. Other lookup tools tend to have less functionality
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek than <span><strong class="command">dig</strong></span>.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Although <span><strong class="command">dig</strong></span> is normally used with
f10ebaa51ecdcbbd10f171d19fe8e680e5bc74aaJakub Hrozek command-line
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek arguments, it also has a batch mode of operation for reading lookup
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek requests from a file. A brief summary of its command-line arguments
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek and options is printed when the <code class="option">-h</code> option is given.
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek Unlike earlier versions, the BIND 9 implementation of
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek <span><strong class="command">dig</strong></span> allows multiple lookups to be issued
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek command line.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek Unless it is told to query a specific name server,
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span><strong class="command">dig</strong></span> will try each of the servers listed
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="filename">/etc/resolv.conf</code>.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek When no command line arguments or options are given, will perform an
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek NS query for "." (the root).
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek It is possible to set per-user defaults for <span><strong class="command">dig</strong></span> via
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="filename">${HOME}/.digrc</code>. This file is read and
f10ebaa51ecdcbbd10f171d19fe8e680e5bc74aaJakub Hrozek any options in it
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek are applied before the command line arguments.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek The IN and CH class names overlap with the IN and CH top level
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek domains names. Either use the <code class="option">-t</code> and
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">-c</code> options to specify the type and class or
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek use the <code class="option">-q</code> the specify the domain name or
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek use "IN." and "CH." when looking up these top level domains.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek A typical invocation of <span><strong class="command">dig</strong></span> looks like:
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<pre class="programlisting"> dig @server name type </pre>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="constant">server</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek is the name or IP address of the name server to query. This can
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek address in dotted-decimal notation or an IPv6
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek address in colon-delimited notation. When the supplied
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>server</code></em> argument is a
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span><strong class="command">dig</strong></span> resolves that name before
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek querying that name
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek server. If no <em class="parameter"><code>server</code></em>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek argument is provided,
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span><strong class="command">dig</strong></span> consults <code class="filename">/etc/resolv.conf</code>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek and queries the name servers listed there. The reply from the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek server that responds is displayed.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="constant">name</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek is the name of the resource record that is to be looked up.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="constant">type</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek indicates what type of query is required —
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek ANY, A, MX, SIG, etc.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>type</code></em> can be any valid query
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek <em class="parameter"><code>type</code></em> argument is supplied,
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek <span><strong class="command">dig</strong></span> will perform a lookup for an
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek The <code class="option">-b</code> option sets the source IP address of the query
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek to <em class="parameter"><code>address</code></em>. This must be a valid
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek one of the host's network interfaces or "0.0.0.0" or "::". An optional
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek may be specified by appending "#<port>"
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The default query class (IN for internet) is overridden by the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">-c</code> option. <em class="parameter"><code>class</code></em> is
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek class, such as HS for Hesiod records or CH for Chaosnet records.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The <code class="option">-f</code> option makes <span><strong class="command">dig </strong></span>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek in batch mode by reading a list of lookup requests to process from the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek file <em class="parameter"><code>filename</code></em>. The file contains a
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek queries, one per line. Each entry in the file should be organized in
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek the same way they would be presented as queries to
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek <span><strong class="command">dig</strong></span> using the command-line interface.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek If a non-standard port number is to be queried, the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">-p</code> option is used. <em class="parameter"><code>port#</code></em> is
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek the port number that <span><strong class="command">dig</strong></span> will send its
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek instead of the standard DNS port number 53. This option would be used
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek to test a name server that has been configured to listen for queries
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek on a non-standard port number.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The <code class="option">-4</code> option forces <span><strong class="command">dig</strong></span>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek use IPv4 query transport. The <code class="option">-6</code> option forces
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span><strong class="command">dig</strong></span> to only use IPv6 query transport.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The <code class="option">-t</code> option sets the query type to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>type</code></em>. It can be any valid query type
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek supported in BIND 9. The default query type is "A", unless the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">-x</code> option is supplied to indicate a reverse lookup.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek A zone transfer can be requested by specifying a type of AXFR. When
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek an incremental zone transfer (IXFR) is required,
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>type</code></em> is set to <code class="literal">ixfr=N</code>.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The incremental zone transfer will contain the changes made to the zone
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek since the serial number in the zone's SOA record was
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The <code class="option">-q</code> option sets the query name to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>name</code></em>. This useful do distinguish the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>name</code></em> from other arguments.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Reverse lookups — mapping addresses to names — are simplified by the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">-x</code> option. <em class="parameter"><code>addr</code></em> is
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek address in dotted-decimal notation, or a colon-delimited IPv6 address.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek When this option is used, there is no need to provide the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>name</code></em>, <em class="parameter"><code>class</code></em> and
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>type</code></em> arguments. <span><strong class="command">dig</strong></span>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek automatically performs a lookup for a name like
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <code class="literal">11.12.13.10.in-addr.arpa</code> and sets the
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek query type and
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek class to PTR and IN respectively. By default, IPv6 addresses are
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek looked up using nibble format under the IP6.ARPA domain.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek To use the older RFC1886 method using the IP6.INT domain
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek specify the <code class="option">-i</code> option. Bit string labels (RFC2874)
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek are now experimental and are not attempted.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek To sign the DNS queries sent by <span><strong class="command">dig</strong></span> and
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek responses using transaction signatures (TSIG), specify a TSIG key file
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek using the <code class="option">-k</code> option. You can also specify the TSIG
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek key itself on the command line using the <code class="option">-y</code> option;
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>hmac</code></em> is the type of the TSIG, default HMAC-MD5,
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>name</code></em> is the name of the TSIG key and
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>key</code></em> is the actual key. The key is a
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek encoded string, typically generated by
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Caution should be taken when using the <code class="option">-y</code> option on
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek multi-user systems as the key can be visible in the output from
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek or in the shell's history file. When
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek using TSIG authentication with <span><strong class="command">dig</strong></span>, the name
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek server that is queried needs to know the key and algorithm that is
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek being used. In BIND, this is done by providing appropriate
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <span><strong class="command">key</strong></span> and <span><strong class="command">server</strong></span> statements in
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<p><span><strong class="command">dig</strong></span>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek provides a number of query options which affect
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek the way in which lookups are made and the results displayed. Some of
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek these set or reset flag bits in the query header, some determine which
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek sections of the answer get printed, and others determine the timeout
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek and retry strategies.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Each query option is identified by a keyword preceded by a plus sign
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek (<code class="literal">+</code>). Some keywords set or reset an
a7797068c4deb6ce2bdbcda27c45ff1bbb4a8e78Jakub Hrozek option. These may be preceded
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek by the string <code class="literal">no</code> to negate the meaning of
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek that keyword. Other
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek keywords assign values to options like the timeout interval. They
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek have the form <code class="option">+keyword=value</code>.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek The query options are:
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]tcp</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Use [do not use] TCP when querying name servers. The default
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek behavior is to use UDP unless an AXFR or IXFR query is
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek requested, in
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek which case a TCP connection is used.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]vc</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Use [do not use] TCP when querying name servers. This alternate
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek syntax to <em class="parameter"><code>+[no]tcp</code></em> is
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek provided for backwards
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek compatibility. The "vc" stands for "virtual circuit".
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]ignore</code></span></dt>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek Ignore truncation in UDP responses instead of retrying with TCP.
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek default, TCP retries are performed.
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek<dt><span class="term"><code class="option">+domain=somename</code></span></dt>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek Set the search list to contain the single domain
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>somename</code></em>, as if specified in
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek <span><strong class="command">domain</strong></span> directive in
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek <code class="filename">/etc/resolv.conf</code>, and enable
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek processing as if the <em class="parameter"><code>+search</code></em>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek option were given.
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek<dt><span class="term"><code class="option">+[no]search</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Use [do not use] the search list defined by the searchlist or
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek directive in <code class="filename">resolv.conf</code> (if
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek The search list is not used by default.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+[no]showsearch</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Perform [do not perform] a search showing intermediate
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]defname</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Deprecated, treated as a synonym for <em class="parameter"><code>+[no]search</code></em>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]aaonly</code></span></dt>
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek Sets the "aa" flag in the query.
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek<dt><span class="term"><code class="option">+[no]aaflag</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek A synonym for <em class="parameter"><code>+[no]aaonly</code></em>.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+[no]adflag</code></span></dt>
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek Set [do not set] the AD (authentic data) bit in the query. The
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek currently has a standard meaning only in responses, not in
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek but the ability to set the bit in the query is provided for
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek completeness.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+[no]cdflag</code></span></dt>
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek Set [do not set] the CD (checking disabled) bit in the query.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek requests the server to not perform DNSSEC validation of
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]cl</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Display [do not display] the CLASS when printing the record.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]ttlid</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Display [do not display] the TTL when printing the record.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]recurse</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Toggle the setting of the RD (recursion desired) bit in the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek This bit is set by default, which means <span><strong class="command">dig</strong></span>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek normally sends recursive queries. Recursion is automatically
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek when the <em class="parameter"><code>+nssearch</code></em> or
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek <em class="parameter"><code>+trace</code></em> query options are
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+[no]nssearch</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek When this option is set, <span><strong class="command">dig</strong></span>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek attempts to find the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek authoritative name servers for the zone containing the name
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek looked up and display the SOA record that each name server has
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]trace</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Toggle tracing of the delegation path from the root name servers
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek the name being looked up. Tracing is disabled by default. When
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek tracing is enabled, <span><strong class="command">dig</strong></span> makes
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek iterative queries to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek resolve the name being looked up. It will follow referrals from
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek root servers, showing the answer from each server that was used
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek resolve the lookup.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]cmd</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Toggles the printing of the initial comment in the output
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek the version of <span><strong class="command">dig</strong></span> and the query
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek options that have
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek been applied. This comment is printed by default.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]short</code></span></dt>
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek Provide a terse answer. The default is to print the answer in a
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek verbose form.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]identify</code></span></dt>
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek Show [or do not show] the IP address and port number that
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek supplied the
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek answer when the <em class="parameter"><code>+short</code></em> option
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek is enabled. If
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek short form answers are requested, the default is not to show the
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek source address and port number of the server that provided the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]comments</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Toggle the display of comment lines in the output. The default
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek print comments.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]stats</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek This query option toggles the printing of statistics: when the
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek was made, the size of the reply and so on. The default
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek to print the query statistics.
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek<dt><span class="term"><code class="option">+[no]qr</code></span></dt>
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek Print [do not print] the query as it is sent.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek By default, the query is not printed.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]question</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Print [do not print] the question section of a query when an
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek returned. The default is to print the question section as a
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]answer</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Display [do not display] the answer section of a reply. The
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek is to display it.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]authority</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Display [do not display] the authority section of a reply. The
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek default is to display it.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]additional</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Display [do not display] the additional section of a reply.
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek The default is to display it.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]all</code></span></dt>
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek Set or clear all display flags.
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek<dt><span class="term"><code class="option">+time=T</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Sets the timeout for a query to
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek <em class="parameter"><code>T</code></em> seconds. The default
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek timeout is 5 seconds.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek An attempt to set <em class="parameter"><code>T</code></em> to less
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek than 1 will result
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek in a query timeout of 1 second being applied.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+tries=T</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Sets the number of times to try UDP queries to server to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>T</code></em> instead of the default, 3.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>T</code></em> is less than or equal to
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek zero, the number of
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek tries is silently rounded up to 1.
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<dt><span class="term"><code class="option">+retry=T</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Sets the number of times to retry UDP queries to server to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <em class="parameter"><code>T</code></em> instead of the default, 2.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek <em class="parameter"><code>+tries</code></em>, this does not include
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+ndots=D</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Set the number of dots that have to appear in
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek <em class="parameter"><code>name</code></em> to <em class="parameter"><code>D</code></em> for it to be
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek considered absolute. The default value is that defined using
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek ndots statement in <code class="filename">/etc/resolv.conf</code>, or 1 if no
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek ndots statement is present. Names with fewer dots are
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek interpreted as
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek relative names and will be searched for in the domains listed in
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek <code class="option">search</code> or <code class="option">domain</code> directive in
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek <code class="filename">/etc/resolv.conf</code>.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+bufsize=B</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Set the UDP message buffer size advertised using EDNS0 to
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek <em class="parameter"><code>B</code></em> bytes. The maximum and minimum sizes
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek of this buffer are 65535 and 0 respectively. Values outside
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek this range are rounded up or down appropriately.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Values other than zero will cause a EDNS query to be sent.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+edns=#</code></span></dt>
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek Specify the EDNS version to query with. Valid values
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek are 0 to 255. Setting the EDNS version will cause a
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek EDNS query to be sent. <code class="option">+noedns</code> clears the
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek remembered EDNS version.
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek<dt><span class="term"><code class="option">+[no]multiline</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Print records like the SOA records in a verbose multi-line
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek format with human-readable comments. The default is to print
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek each record on a single line, to facilitate machine parsing
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek of the <span><strong class="command">dig</strong></span> output.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]fail</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Do not try the next server if you receive a SERVFAIL. The
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek to not try the next server which is the reverse of normal stub
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]besteffort</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Attempt to display the contents of messages which are malformed.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The default is to not display malformed answers.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]dnssec</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Requests DNSSEC records be sent by setting the DNSSEC OK bit
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek in the OPT record in the additional section of the query.
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<dt><span class="term"><code class="option">+[no]sigchase</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Chase DNSSEC signature chains. Requires dig be compiled with
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek -DDIG_SIGCHASE.
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<dt><span class="term"><code class="option">+trusted-key=####</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Specifies a file containing trusted keys to be used with
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="option">+sigchase</code>. Each DNSKEY record must be
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek on its own line.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek If not specified <span><strong class="command">dig</strong></span> will look for
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek <code class="filename">/etc/trusted-key.key</code> then
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <code class="filename">trusted-key.key</code> in the current directory.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Requires dig be compiled with -DDIG_SIGCHASE.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<dt><span class="term"><code class="option">+[no]topdown</code></span></dt>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek When chasing DNSSEC signature chains perform a top-down
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek Requires dig be compiled with -DDIG_SIGCHASE.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<a name="id2651281"></a><h2>MULTIPLE QUERIES</h2>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The BIND 9 implementation of <span><strong class="command">dig </strong></span>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek specifying multiple queries on the command line (in addition to
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek supporting the <code class="option">-f</code> batch file option). Each of those
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek queries can be supplied with its own set of flags, options and query
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek In this case, each <em class="parameter"><code>query</code></em> argument
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek represent an
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek individual query in the command-line syntax described above. Each
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek consists of any of the standard options and flags, the name to be
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek looked up, an optional query type and class and any query options that
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek should be applied to that query.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek A global set of query options, which should be applied to all queries,
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek can also be supplied. These global query options must precede the
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek first tuple of name, class, type, options, flags, and query options
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek supplied on the command line. Any global query options (except
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek the <code class="option">+[no]cmd</code> option) can be
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek overridden by a query-specific set of query options. For example:
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozekdig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek shows how <span><strong class="command">dig</strong></span> could be used from the
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek command line
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek to make three lookups: an ANY query for <code class="literal">www.isc.org</code>, a
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek reverse lookup of 127.0.0.1 and a query for the NS records of
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek A global query option of <em class="parameter"><code>+qr</code></em> is
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek that <span><strong class="command">dig</strong></span> shows the initial query it made
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek lookup. The final query has a local query option of
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek <em class="parameter"><code>+noqr</code></em> which means that <span><strong class="command">dig</strong></span>
36b56482ca1e53d832accef0354124fd79711172Jakub Hrozek will not print the initial query when it looks up the NS records for
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek If <span><strong class="command">dig</strong></span> has been built with IDN (internationalized
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek domain name) support, it can accept and display non-ASCII domain names.
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek <span><strong class="command">dig</strong></span> appropriately converts character encoding of
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek domain name before sending a request to DNS server or displaying a
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek reply from the server.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek If you'd like to turn off the IDN support for some reason, defines
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek the <code class="envar">IDN_DISABLE</code> environment variable.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek The IDN support is disabled if the variable is set when
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span><strong class="command">dig</strong></span> runs.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<p><code class="filename">/etc/resolv.conf</code>
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<p><span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>,
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek <span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>,
9a839b29816c8906d4a6b074cf76df790cac9209Jakub Hrozek There are probably too many query options.
6463ed1dcdd45416468b3fa178bd856b5a9ed2c3Jakub Hrozek<table width="100%" summary="Navigation footer">
5ee3fba0bd812242a1ffe189f5ddf2689e6e6811Jakub Hrozek<a accesskey="p" href="Bv9ARM.ch10.html">Prev</a>�</td>
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
5ee3fba0bd812242a1ffe189f5ddf2689e6e6811Jakub Hrozek<td width="40%" align="right">�<a accesskey="n" href="man.host.html">Next</a>
b47fd11a259c50e63cd674c7cba0da3f2549cae0Jakub Hrozek<td width="40%" align="left" valign="top">Manual pages�</td>
5ee3fba0bd812242a1ffe189f5ddf2689e6e6811Jakub Hrozek<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
5ee3fba0bd812242a1ffe189f5ddf2689e6e6811Jakub Hrozek<td width="40%" align="right" valign="top">�host</td>