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