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