man.dig.html revision 0226754d9e537fd56b690d5890cfe215a6c59f89
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2000-2003 Internet Software Consortium.
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and/or distribute this software for any
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - purpose with or without fee is hereby granted, provided that the above
8c225507766814e78e168b17a24b8a47ca7f8c37Tinderbox User - copyright notice and this permission notice appear in all copies.
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User - PERFORMANCE OF THIS SOFTWARE.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<link rel="prev" href="Bv9ARM.ch13.html" title="Manual pages">
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<link rel="next" href="man.host.html" title="host">
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<table width="100%" summary="Navigation header">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<tr><th colspan="3" align="center">dig</th></tr>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<a accesskey="p" href="Bv9ARM.ch13.html">Prev</a>�</td>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<th width="60%" align="center">Manual pages</th>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<td width="20%" align="right">�<a accesskey="n" href="man.host.html">Next</a>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="man.dig"></a><div class="titlepage"></div>
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User<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">-v</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>
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User<div class="cmdsynopsis"><p><code class="command">dig</code> [<code class="option">-h</code>]</p></div>
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User<div class="cmdsynopsis"><p><code class="command">dig</code> [global-queryopt...] [query...]</p></div>
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User<a name="id-1.14.2.7"></a><h2>DESCRIPTION</h2>
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User<p><span class="command"><strong>dig</strong></span>
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User (domain information groper) is a flexible tool
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User for interrogating DNS name servers. It performs DNS lookups and
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User displays the answers that are returned from the name server(s) that
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User were queried. Most DNS administrators use <span class="command"><strong>dig</strong></span> to
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User troubleshoot DNS problems because of its flexibility, ease of use and
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User clarity of output. Other lookup tools tend to have less functionality
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User than <span class="command"><strong>dig</strong></span>.
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User Although <span class="command"><strong>dig</strong></span> is normally used with
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User arguments, it also has a batch mode of operation for reading lookup
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User requests from a file. A brief summary of its command-line arguments
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User and options is printed when the <code class="option">-h</code> option is given.
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User Unlike earlier versions, the BIND 9 implementation of
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User <span class="command"><strong>dig</strong></span> allows multiple lookups to be issued
33c9436ef1a43d3c0fc3d9be9b4b0509daa83223Tinderbox User command line.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Unless it is told to query a specific name server,
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User <span class="command"><strong>dig</strong></span> will try each of the servers listed in
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User <code class="filename">/etc/resolv.conf</code>. If no usable server addresses
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User are found, <span class="command"><strong>dig</strong></span> will send the query to the local
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User When no command line arguments or options are given,
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User <span class="command"><strong>dig</strong></span> will perform an NS query for "." (the root).
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User It is possible to set per-user defaults for <span class="command"><strong>dig</strong></span> via
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User <code class="filename">${HOME}/.digrc</code>. This file is read and
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User any options in it
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User are applied before the command line arguments.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User The IN and CH class names overlap with the IN and CH top level
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User domain names. Either use the <code class="option">-t</code> and
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User <code class="option">-c</code> options to specify the type and class,
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User use the <code class="option">-q</code> the specify the domain name, or
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User use "IN." and "CH." when looking up these top level domains.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id-1.14.2.8"></a><h2>SIMPLE USAGE</h2>
a1ff871f78b7d907d6fc3a382beea2a640fe8423Tinderbox User A typical invocation of <span class="command"><strong>dig</strong></span> looks like:
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User<pre class="programlisting"> dig @server name type </pre>
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User<div class="variablelist"><dl class="variablelist">
363b21045b718d06d414784c96193dc9a233e8c5Tinderbox User<dt><span class="term"><code class="constant">server</code></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt is the name or IP address of the name server to query. This
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User can be an IPv4 address in dotted-decimal notation or an IPv6
550d3276d0490c4918f089ccb1528a3eb0951b0aTinderbox User address in colon-delimited notation. When the supplied
550d3276d0490c4918f089ccb1528a3eb0951b0aTinderbox User <em class="parameter"><code>server</code></em> argument is a hostname,
550d3276d0490c4918f089ccb1528a3eb0951b0aTinderbox User <span class="command"><strong>dig</strong></span> resolves that name before querying
550d3276d0490c4918f089ccb1528a3eb0951b0aTinderbox User that name server.
550d3276d0490c4918f089ccb1528a3eb0951b0aTinderbox User If no <em class="parameter"><code>server</code></em> argument is
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User provided, <span class="command"><strong>dig</strong></span> consults
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <code class="filename">/etc/resolv.conf</code>; if an
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User address is found there, it queries the name server at
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User that address. If either of the <code class="option">-4</code> or
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User <code class="option">-6</code> options are in use, then
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User only addresses for the corresponding transport
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User will be tried. If no usable addresses are found,
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User <span class="command"><strong>dig</strong></span> will send the query to the
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User local host. The reply from the name server that
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User responds is displayed.
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User<dt><span class="term"><code class="constant">name</code></span></dt>
51da15c88648a9e47d0cddff4b2b782665e99401Tinderbox User is the name of the resource record that is to be looked up.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term"><code class="constant">type</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User indicates what type of query is required —
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt ANY, A, MX, SIG, etc.
d253648fe3331622cebea02d60aaecca3082d78dTinderbox User <em class="parameter"><code>type</code></em> can be any valid query
d253648fe3331622cebea02d60aaecca3082d78dTinderbox User <em class="parameter"><code>type</code></em> argument is supplied,
d253648fe3331622cebea02d60aaecca3082d78dTinderbox User <span class="command"><strong>dig</strong></span> will perform a lookup for an
d253648fe3331622cebea02d60aaecca3082d78dTinderbox User<div class="variablelist"><dl class="variablelist">
d253648fe3331622cebea02d60aaecca3082d78dTinderbox User Use IPv4 only.
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User Use IPv6 only.
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User<dt><span class="term">-b <em class="replaceable"><code>address[<span class="optional">#port</span>]</code></em></span></dt>
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User Set the source IP address of the query.
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User The <em class="parameter"><code>address</code></em> must be a valid address on
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User one of the host's network interfaces, or "0.0.0.0" or "::". An
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User optional port may be specified by appending "#<port>"
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User Set the query class. The
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User default <em class="parameter"><code>class</code></em> is IN; other classes
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User are HS for Hesiod records or CH for Chaosnet records.
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User<dt><span class="term">-f <em class="replaceable"><code>file</code></em></span></dt>
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User Batch mode: <span class="command"><strong>dig</strong></span> reads a list of lookup
3ca1a32241189d1e02e59f6b56399eb9b40f2aafTinderbox User requests to process from the
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User given <em class="parameter"><code>file</code></em>. Each line in the file
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User should be organized in the same way they would be
dfae459e8c4f794f8a239e74aa9d5e11cce6ea5bTinderbox User presented as queries to
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User <span class="command"><strong>dig</strong></span> using the command-line interface.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Do reverse IPv6 lookups using the obsolete RFC1886 IP6.INT
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User domain, which is no longer in use. Obsolete bit string
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User label queries (RFC2874) are not attempted.
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User<dt><span class="term">-k <em class="replaceable"><code>keyfile</code></em></span></dt>
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User Sign queries using TSIG using a key read from the given file.
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User Key files can be generated using
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User <span class="citerefentry"><span class="refentrytitle">tsig-keygen</span>(8)</span>.
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User When using TSIG authentication with <span class="command"><strong>dig</strong></span>,
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User the name server that is queried needs to know the key and
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User algorithm that is being used. In BIND, this is done by
f14ce68ee54a5a4587fbde4ffacb117946df2d73Tinderbox User providing appropriate <span class="command"><strong>key</strong></span>
0d6a6642b2be93cffa651c54a9b8810dd2d31392Tinderbox User and <span class="command"><strong>server</strong></span> statements in
0d6a6642b2be93cffa651c54a9b8810dd2d31392Tinderbox User Enable memory usage debugging.
0d6a6642b2be93cffa651c54a9b8810dd2d31392Tinderbox User<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User Send the query to a non-standard port on the server,
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User instead of the default port 53. This option would be used
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User to test a name server that has been configured to listen
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User for queries on a non-standard port number.
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User<dt><span class="term">-q <em class="replaceable"><code>name</code></em></span></dt>
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User The domain name to query. This is useful to distinguish
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User the <em class="parameter"><code>name</code></em> from other arguments.
164ade1482251e1da962b42e5bf0d3aa02a11e03Tinderbox User<dt><span class="term">-t <em class="replaceable"><code>type</code></em></span></dt>
164ade1482251e1da962b42e5bf0d3aa02a11e03Tinderbox User The resource record type to query. It can be any valid query type
164ade1482251e1da962b42e5bf0d3aa02a11e03Tinderbox User supported in BIND 9. The default query type is "A", unless the
164ade1482251e1da962b42e5bf0d3aa02a11e03Tinderbox User <code class="option">-x</code> option is supplied to indicate a reverse lookup.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User A zone transfer can be requested by specifying a type of AXFR. When
abe69df9a7de5cda07a2b8e19e8b7c981bcd7a9dTinderbox User an incremental zone transfer (IXFR) is required, set the
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User <em class="parameter"><code>type</code></em> to <code class="literal">ixfr=N</code>.
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User The incremental zone transfer will contain the changes
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User made to the zone since the serial number in the zone's SOA
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Print the version number and exit.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-x <em class="replaceable"><code>addr</code></em></span></dt>
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User Simplified reverse lookups, for mapping addresses to
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User names. The <em class="parameter"><code>addr</code></em> is an IPv4 address
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User in dotted-decimal notation, or a colon-delimited IPv6
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User address. When the <code class="option">-x</code> is used, there is no
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User need to provide
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User the <em class="parameter"><code>name</code></em>, <em class="parameter"><code>class</code></em>
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User and <em class="parameter"><code>type</code></em>
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User arguments. <span class="command"><strong>dig</strong></span> automatically performs a
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User lookup for a name like
a0fb6a0980359165a4459723f52d5d7b5725f9c6Tinderbox User <code class="literal">94.2.0.192.in-addr.arpa</code> and sets the
8c7245514646663b25d8b186186ebede41903fa3Tinderbox User query type and class to PTR and IN respectively. IPv6
8c7245514646663b25d8b186186ebede41903fa3Tinderbox User addresses are looked up using nibble format under the
8c7245514646663b25d8b186186ebede41903fa3Tinderbox User IP6.ARPA domain (but see also the <code class="option">-i</code>
8c7245514646663b25d8b186186ebede41903fa3Tinderbox User<dt><span class="term">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]keyname:secret</code></em></span></dt>
8c7245514646663b25d8b186186ebede41903fa3Tinderbox User Sign queries using TSIG with the given authentication key.
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User <em class="parameter"><code>keyname</code></em> is the name of the key, and
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User <em class="parameter"><code>secret</code></em> is the base64 encoded shared secret.
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User <em class="parameter"><code>hmac</code></em> is the name of the key algorithm;
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User valid choices are <code class="literal">hmac-md5</code>,
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User <code class="literal">hmac-sha1</code>, <code class="literal">hmac-sha224</code>,
421ba11f3f07cbcb12c288ef7f4e7bad13fcc28fTinderbox User <code class="literal">hmac-sha256</code>, <code class="literal">hmac-sha384</code>, or
99b30e26a6beb9092557cc9e5370b517309bff6eTinderbox User <code class="literal">hmac-sha512</code>. If <em class="parameter"><code>hmac</code></em>
ffe29868b4bbc64953fc5d0de51f988c20158967Tinderbox User is not specified, the default is <code class="literal">hmac-md5</code>.
3b15473cedf41d48904f5b07bdc5e87afff6b58cTinderbox User NOTE: You should use the <code class="option">-k</code> option and
3b15473cedf41d48904f5b07bdc5e87afff6b58cTinderbox User avoid the <code class="option">-y</code> option, because
3b15473cedf41d48904f5b07bdc5e87afff6b58cTinderbox User with <code class="option">-y</code> the shared secret is supplied as
3b15473cedf41d48904f5b07bdc5e87afff6b58cTinderbox User a command line argument in clear text. This may be visible
ffe29868b4bbc64953fc5d0de51f988c20158967Tinderbox User in the output from
99b30e26a6beb9092557cc9e5370b517309bff6eTinderbox User <span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span>
99b30e26a6beb9092557cc9e5370b517309bff6eTinderbox User or in a history file maintained by the user's shell.
99b30e26a6beb9092557cc9e5370b517309bff6eTinderbox User<a name="id-1.14.2.10"></a><h2>QUERY OPTIONS</h2>
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User<p><span class="command"><strong>dig</strong></span>
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User provides a number of query options which affect
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User the way in which lookups are made and the results displayed. Some of
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User these set or reset flag bits in the query header, some determine which
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User sections of the answer get printed, and others determine the timeout
c48fdfda7a8ae8973aadfeb88cbeaab013024a6cTinderbox User and retry strategies.
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User Each query option is identified by a keyword preceded by a plus sign
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User (<code class="literal">+</code>). Some keywords set or reset an
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User option. These may be preceded
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User by the string <code class="literal">no</code> to negate the meaning of
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User that keyword. Other
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User keywords assign values to options like the timeout interval. They
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User have the form <code class="option">+keyword=value</code>.
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User Keywords may be abbreviated, provided the abbreviation is
9efd8fc7e811d3c0c160adeb5552c2df7e49df67Tinderbox User unambiguous; for example, <code class="literal">+cd</code> is equivalent
ffe29868b4bbc64953fc5d0de51f988c20158967Tinderbox User The query options are:
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<div class="variablelist"><dl class="variablelist">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term"><code class="option">+[no]aaflag</code></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt A synonym for <em class="parameter"><code>+[no]aaonly</code></em>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term"><code class="option">+[no]aaonly</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Sets the "aa" flag in the query.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term"><code class="option">+[no]additional</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Display [do not display] the additional section of a
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt reply. The default is to display it.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term"><code class="option">+[no]adflag</code></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Set [do not set] the AD (authentic data) bit in the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User query. This requests the server to return whether
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt all of the answer and authority sections have all
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User been validated as secure according to the security
1c57c3f79db0bf0358bbe6d7b5ad650c0c852f4bTinderbox User policy of the server. AD=1 indicates that all records
<dt><span class="term"><code class="option">+[no]cookie[<span class="optional">=####</span>]</code></span></dt>
e.g. "[ key id = value ]".
accepted. Setting a named flag (e.g. DO) will silently be