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