man.mdig.html revision 8dcec3cf256105c620d02d5c84c9ccbfe495ca8d
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek - Copyright (C) 2000-2016 Internet Systems Consortium, Inc. ("ISC")
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek - This Source Code Form is subject to the terms of the Mozilla Public
2cb6f28b3a12bb714bf14494d31eb6b6fff64b8bJakub Hrozek - License, v. 2.0. If a copy of the MPL was not distributed with this
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek - file, You can obtain one at http://mozilla.org/MPL/2.0/.
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
ad805face83ba7d67b1cf2067a1982c7e63d1060Jakub Hrozek<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
a7797068c4deb6ce2bdbcda27c45ff1bbb4a8e78Jakub Hrozek<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<link rel="prev" href="man.dig.html" title="dig">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<link rel="next" href="man.host.html" title="host">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek<table width="100%" summary="Navigation header">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<tr><th colspan="3" align="center"><span class="application">mdig</span></th></tr>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<a accesskey="p" href="man.dig.html">Prev</a>�</td>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<th width="60%" align="center">Manual pages</th>
261cdde02b40aa8dabb3d69e43586a5a220647e9Jakub Hrozek<td width="20%" align="right">�<a accesskey="n" href="man.host.html">Next</a>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<a name="man.mdig"></a><div class="titlepage"></div>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek — DNS pipelined lookup utility
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-f <em class="replaceable"><code>filename</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-b <em class="replaceable"><code>address</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-p <em class="replaceable"><code>port#</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-t <em class="replaceable"><code>type</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [<code class="option">-x <em class="replaceable"><code>addr</code></em></code>]
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek [plusopt...]
261cdde02b40aa8dabb3d69e43586a5a220647e9Jakub Hrozek {global-opt...}
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek {local-opt...}
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <p><span class="command"><strong>mdig</strong></span>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek is a multiple/pipelined query version of <span class="command"><strong>dig</strong></span>:
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek instead of waiting for a response after sending each query,
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek it begins by sending all queries. Responses are displayed in
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the order in which they are received, not in the order the
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek corresponding queries were sent.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig</strong></span> options are a subset of the
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>dig</strong></span> options, and are divided into "anywhere
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek options" which can occur anywhere, "global options" which must
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek occur before the query name (or they are ignored with a warning),
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek and "local options" which apply to the next query on the command
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The {@server} option is a mandatory global
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek option. It is the name or IP address of the name server to query.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek (Unlike <span class="command"><strong>dig</strong></span>, this value is not retrieved from
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <code class="filename">/etc/resolv.conf</code>.) It can be an IPv4 address
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek in dotted-decimal notation, an IPv6 address in colon-delimited
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek notation, or a hostname. When the supplied
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <em class="parameter"><code>server</code></em> argument is a hostname,
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig</strong></span> resolves that name before querying
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the name server.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <p><span class="command"><strong>mdig</strong></span>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek provides a number of query options which affect
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the way in which lookups are made and the results displayed. Some of
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek these set or reset flag bits in the query header, some determine which
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek sections of the answer get printed, and others determine the timeout
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek and retry strategies.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Each query option is identified by a keyword preceded by a plus
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek sign (<code class="literal">+</code>). Some keywords set or reset an
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek option. These may be preceded by the string <code class="literal">no</code>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek to negate the meaning of that keyword. Other keywords assign
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek values to options like the timeout interval. They have the
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek form <code class="option">+keyword=value</code>.
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek<a name="id-1.14.3.8"></a><h2>ANYWHERE OPTIONS</h2>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-f</code> option makes <span class="command"><strong>mdig</strong></span>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek operate in batch mode by reading a list of lookup requests to
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek process from the file <em class="parameter"><code>filename</code></em>. The file
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek contains a number of queries, one per line. Each entry in the
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek file should be organized in the same way they would be presented
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek as queries to <span class="command"><strong>mdig</strong></span> using the command-line interface.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek The <code class="option">-h</code> causes <span class="command"><strong>mdig</strong></span> to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek print the detailed help with the full list of options and exit.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-v</code> causes <span class="command"><strong>mdig</strong></span> to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek print the version number and exit.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<a name="id-1.14.3.9"></a><h2>GLOBAL OPTIONS</h2>
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek The <code class="option">-4</code> option forces <span class="command"><strong>mdig</strong></span> to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek only use IPv4 query transport.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-6</code> option forces <span class="command"><strong>mdig</strong></span> to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek only use IPv6 query transport.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-b</code> option sets the source IP address of the
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek query to <em class="parameter"><code>address</code></em>. This must be a valid
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek address on one of the host's network interfaces or "0.0.0.0" or
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek "::". An optional port may be specified by appending
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek "#<port>"
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-m</code> option enables memory usage debugging.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-p</code> option is used when a non-standard port
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek number is to be queried.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <em class="parameter"><code>port#</code></em> is the port number
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek that <span class="command"><strong>mdig</strong></span> will send its queries instead of
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the standard DNS port number 53. This option would be used to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek test a name server that has been configured to listen for
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek queries on a non-standard port number.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The global query options are:
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<div class="variablelist"><dl class="variablelist">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]additional</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Display [do not display] the additional section of a
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek reply. The default is to display it.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]all</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Set or clear all display flags.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]answer</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Display [do not display] the answer section of a
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek reply. The default is to display it.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]authority</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Display [do not display] the authority section of a
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek reply. The default is to display it.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]besteffort</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Attempt to display the contents of messages which are
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek malformed. The default is to not display malformed
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]cl</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Display [do not display] the CLASS when printing the
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]comments</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Toggle the display of comment lines in the output.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek The default is to print comments.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]continue</code></span></dt>
a7797068c4deb6ce2bdbcda27c45ff1bbb4a8e78Jakub Hrozek Continue on errors (e.g. timeouts).
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]crypto</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Toggle the display of cryptographic fields in DNSSEC
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek records. The contents of these field are unnecessary
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek to debug most DNSSEC validation failures and removing
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek them makes it easier to see the common failures. The
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek default is to display the fields. When omitted they
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek are replaced by the string "[omitted]" or in the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek DNSKEY case the key id is displayed as the replacement,
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek e.g. "[ key id = value ]".
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+dscp[=value]</code></span></dt>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek Set the DSCP code point to be used when sending the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek query. Valid DSCP code points are in the range
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek [0..63]. By default no code point is explicitly set.
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek<dt><span class="term"><code class="option">+[no]multiline</code></span></dt>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek Print records like the SOA records in a verbose
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek multi-line format with human-readable comments. The
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek default is to print each record on a single line, to
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek facilitate machine parsing of the <span class="command"><strong>mdig</strong></span>
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek<dt><span class="term"><code class="option">+[no]question</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Print [do not print] the question section of a query
f45a20d6ba9e8d695ec3ab707f0cc082999aa4a3Jakub Hrozek when an answer is returned. The default is to print
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek the question section as a comment.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]rrcomments</code></span></dt>
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek Toggle the display of per-record comments in the
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek output (for example, human-readable key information
ad805face83ba7d67b1cf2067a1982c7e63d1060Jakub Hrozek about DNSKEY records). The default is not to print
ad805face83ba7d67b1cf2067a1982c7e63d1060Jakub Hrozek record comments unless multiline mode is active.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]short</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Provide a terse answer. The default is to print the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek answer in a verbose form.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+split=W</code></span></dt>
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek Split long hex- or base64-formatted fields in resource
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek records into chunks of <em class="parameter"><code>W</code></em>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek characters (where <em class="parameter"><code>W</code></em> is rounded
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek up to the nearest multiple of 4).
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek <em class="parameter"><code>+nosplit</code></em> or
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek <em class="parameter"><code>+split=0</code></em> causes fields not to
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek be split at all. The default is 56 characters, or
261cdde02b40aa8dabb3d69e43586a5a220647e9Jakub Hrozek 44 characters when multiline mode is active.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]tcp</code></span></dt>
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek Use [do not use] TCP when querying name servers. The
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek default behavior is to use UDP.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]ttlid</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Display [do not display] the TTL when printing the
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]ttlunits</code></span></dt>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek Display [do not display] the TTL in friendly human-readable
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek time units of "s", "m", "h", "d", and "w", representing
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek seconds, minutes, hours, days and weeks. Implies +ttlid.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek<dt><span class="term"><code class="option">+[no]vc</code></span></dt>
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek Use [do not use] TCP when querying name servers. This
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek alternate syntax to <em class="parameter"><code>+[no]tcp</code></em>
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek is provided for backwards compatibility. The "vc"
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek stands for "virtual circuit".
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<a name="id-1.14.3.10"></a><h2>LOCAL OPTIONS</h2>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-c</code> option sets the query class to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <em class="parameter"><code>class</code></em>. It can be any valid query class
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek which is supported in BIND 9. The default query class is "IN".
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-t</code> option sets the query type to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <em class="parameter"><code>type</code></em>. It can be any valid query type
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek which is supported in BIND 9. The default query type is "A",
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek unless the <code class="option">-x</code> option is supplied to indicate
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek a reverse lookup with the "PTR" query type.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek The <code class="option">-i</code> option sets the reverse domain for
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek IPv6 addresses to IP6.INT.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Reverse lookups — mapping addresses to names — are
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek simplified by the <code class="option">-x</code> option.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>addr</code></em> is an IPv4
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek address in dotted-decimal notation, or a colon-delimited IPv6 address.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig</strong></span> automatically performs a lookup for a
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek query name like <code class="literal">11.12.13.10.in-addr.arpa</code> and
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek sets the query type and class to PTR and IN respectively.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek By default, IPv6 addresses are looked up using nibble format
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek under the IP6.ARPA domain. To use the older RFC1886 method
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek using the IP6.INT domain specify the <code class="option">-i</code> option.
a23014d69b56cbdf48ad05229c334648b5309d8fJakub Hrozek The local query options are:
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<div class="variablelist"><dl class="variablelist">
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]aaflag</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek A synonym for <em class="parameter"><code>+[no]aaonly</code></em>.
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek<dt><span class="term"><code class="option">+[no]aaonly</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Sets the "aa" flag in the query.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]adflag</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Set [do not set] the AD (authentic data) bit in the
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek query. This requests the server to return whether
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek all of the answer and authority sections have all
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek been validated as secure according to the security
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek policy of the server. AD=1 indicates that all records
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek have been validated as secure and the answer is not
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek from a OPT-OUT range. AD=0 indicate that some part
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek of the answer was insecure or not validated. This
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek bit is set by default.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+bufsize=B</code></span></dt>
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek Set the UDP message buffer size advertised using EDNS0
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek to <em class="parameter"><code>B</code></em> bytes. The maximum and
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek minimum sizes of this buffer are 65535 and 0 respectively.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Values outside this range are rounded up or down
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek appropriately. Values other than zero will cause a
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek EDNS query to be sent.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]cdflag</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Set [do not set] the CD (checking disabled) bit in
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the query. This requests the server to not perform
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek DNSSEC validation of responses.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+[no]cookie[<span class="optional">=####</span>]</code></span></dt>
524ceecc11f3d458eb3c1cf1489c3ff6ccb22226Jakub Hrozek Send a COOKIE EDNS option, with optional value.
524ceecc11f3d458eb3c1cf1489c3ff6ccb22226Jakub Hrozek Replaying a COOKIE from a previous response will allow
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the server to identify a previous client. The default
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]dnssec</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Requests DNSSEC records be sent by setting the DNSSEC
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek OK bit (DO) in the OPT record in the additional section
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek of the query.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]edns[=#]</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Specify the EDNS version to query with. Valid values
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek are 0 to 255. Setting the EDNS version will cause
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek a EDNS query to be sent. <code class="option">+noedns</code>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek clears the remembered EDNS version. EDNS is set to
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek 0 by default.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]ednsflags[=#]</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Set the must-be-zero EDNS flags bits (Z bits) to the
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek specified value. Decimal, hex and octal encodings are
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek accepted. Setting a named flag (e.g. DO) will silently be
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek ignored. By default, no Z bits are set.
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek<dt><span class="term"><code class="option">+[no]ednsopt[=code[:value]]</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Specify EDNS option with code point <code class="option">code</code>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek and optionally payload of <code class="option">value</code> as a
0142e7e2558a887992b1c5d4dc3051178e377687Jakub Hrozek hexadecimal string. <code class="option">+noednsopt</code>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek clears the EDNS options to be sent.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]expire</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Send an EDNS Expire option.
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek<dt><span class="term"><code class="option">+[no]nsid</code></span></dt>
b20208b80e99abb79c00d5ec526caa9465859c52Jakub Hrozek Include an EDNS name server ID request when sending
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]recurse</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Toggle the setting of the RD (recursion desired) bit
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek in the query. This bit is set by default, which means
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig</strong></span> normally sends recursive
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+retry=T</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Sets the number of times to retry UDP queries to
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek server to <em class="parameter"><code>T</code></em> instead of the
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek default, 2. Unlike <em class="parameter"><code>+tries</code></em>,
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek this does not include the initial query.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]subnet=addr[/prefix-length]</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Send (don't send) an EDNS Client Subnet option with the
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek specified IP address or network prefix.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig +subnet=0.0.0.0/0</strong></span>, or simply
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="command"><strong>mdig +subnet=0</strong></span> for short, sends an EDNS
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek client-subnet option with an empty address and a source
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek prefix-length of zero, which signals a resolver that
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek the client's address information must
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek <span class="emphasis"><em>not</em></span> be used when resolving
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+timeout=T</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Sets the timeout for a query to
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek <em class="parameter"><code>T</code></em> seconds. The default
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek timeout is 5 seconds for UDP transport and 10 for TCP.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek An attempt to set <em class="parameter"><code>T</code></em> to less
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek than 1 will result
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek in a query timeout of 1 second being applied.
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<dt><span class="term"><code class="option">+tries=T</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Sets the number of times to try UDP queries to server
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek to <em class="parameter"><code>T</code></em> instead of the default,
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek 3. If <em class="parameter"><code>T</code></em> is less than or equal
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek to zero, the number of tries is silently rounded up
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+udptimeout=T</code></span></dt>
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek Sets the timeout between UDP query retries.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]unknownformat</code></span></dt>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek Print all RDATA in unknown RR type presentation format
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek (RFC 3597). The default is to print RDATA for known types
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek in the type's presentation format.
7a14e8f66c0e932fe2954d792614a3b61d444bd1Jakub Hrozek<dt><span class="term"><code class="option">+[no]zflag</code></span></dt>
481ec0e1eb0058195732cb320845b41f6f4d43ebJakub Hrozek Set [do not set] the last unassigned DNS header flag in a
531661c7bb54eb71853977a64cb30f80c20b963eJakub Hrozek DNS query. This flag is off by default.
524ceecc11f3d458eb3c1cf1489c3ff6ccb22226Jakub Hrozek<table width="100%" summary="Navigation footer">
e5c33e0bd03a2deb8e5011deeb3ae93f960910eeJakub Hrozek<a accesskey="p" href="man.dig.html">Prev</a>�</td>
e5c33e0bd03a2deb8e5011deeb3ae93f960910eeJakub Hrozek<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
e5c33e0bd03a2deb8e5011deeb3ae93f960910eeJakub Hrozek<td width="40%" align="right">�<a accesskey="n" href="man.host.html">Next</a>
d25fa6f2608d5fe0617ada47f9d426f45deb96ffJakub Hrozek<td width="40%" align="left" valign="top">dig�</td>
524ceecc11f3d458eb3c1cf1489c3ff6ccb22226Jakub Hrozek<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
e5c33e0bd03a2deb8e5011deeb3ae93f960910eeJakub Hrozek<td width="40%" align="right" valign="top">�host</td>
be5cc3c013ece0c957f2f8c28a217052227dfd07Jakub Hrozek<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.1rc2</p>