man.mdig.html revision 1e9517ea2156b990be21f44676d3370318eacf17
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - Copyright (C) 2000-2015 Internet Systems Consortium, Inc. ("ISC")
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - This Source Code Form is subject to the terms of the Mozilla Public
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - License, v. 2.0. If a copy of the MPL was not distributed with this
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - 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">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="prev" href="man.dig.html" title="dig">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="next" href="man.host.html" title="host">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<table width="100%" summary="Navigation header">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<tr><th colspan="3" align="center"><span class="application">mdig</span></th></tr>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a accesskey="p" href="man.dig.html">Prev</a>�</td>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<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>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<p><span class="application">mdig</span> — DNS pipelined lookup utility</p>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<div class="cmdsynopsis"><p><code class="command">mdig</code> {@server} [<code class="option">-f <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-h</code>] [<code class="option">-v</code>] [<code class="option">-4</code>] [<code class="option">-6</code>] [<code class="option">-b <em class="replaceable"><code>address</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port#</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-i</code>] [<code class="option">-x <em class="replaceable"><code>addr</code></em></code>] [plusopt...]</p></div>
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews<div class="cmdsynopsis"><p><code class="command">mdig</code> {-h}</p></div>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<div class="cmdsynopsis"><p><code class="command">mdig</code> [@server] {global-opt...} {
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein {local-opt...}
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id-1.14.3.7"></a><h2>DESCRIPTION</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span class="command"><strong>mdig</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 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,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="command"><strong>dig</strong></span> options, and are divided into "anywhere
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User options" which can occur anywhere, "global options" which must
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein occur before the query name (or they are ignored with a warning),
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User and "local options" which apply to the next query on the command
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The {@server} option is a mandatory global
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein option. It is the name or IP address of the name server to query.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User (Unlike <span class="command"><strong>dig</strong></span>, this value is not retrieved from
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <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
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User notation, or a hostname. When the supplied
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <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
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the name server.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span class="command"><strong>mdig</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein provides a number of query options which affect
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the way in which lookups are made and the results displayed. Some of
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User these set or reset flag bits in the query header, some determine which
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein sections of the answer get printed, and others determine the timeout
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User and retry strategies.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Each query option is identified by a keyword preceded by a plus
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User sign (<code class="literal">+</code>). Some keywords set or reset an
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User option. These may be preceded by the string <code class="literal">no</code>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to negate the meaning of that keyword. Other keywords assign
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein values to options like the timeout interval. They have the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User form <code class="option">+keyword=value</code>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id-1.14.3.8"></a><h2>ANYWHERE OPTIONS</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-f</code> option makes <span class="command"><strong>mdig</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 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
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User contains a number of queries, one per line. Each entry in the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 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
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User print the detailed help with the full list of options and exit.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-v</code> causes <span class="command"><strong>mdig</strong></span> to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User print the version number and exit.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id-1.14.3.9"></a><h2>GLOBAL OPTIONS</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-4</code> option forces <span class="command"><strong>mdig</strong></span> to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User only use IPv4 query transport.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-6</code> option forces <span class="command"><strong>mdig</strong></span> to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User only use IPv6 query transport.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-b</code> option sets the source IP address of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein query to <em class="parameter"><code>address</code></em>. This must be a valid
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein address on one of the host's network interfaces or "0.0.0.0" or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein "::". An optional port may be specified by appending
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein "#<port>"
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 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.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The global query options are:
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<div class="variablelist"><dl class="variablelist">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term"><code class="option">+[no]additional</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Display [do not display] the additional section of a
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User reply. The default is to display it.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term"><code class="option">+[no]all</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Set or clear all display flags.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<dt><span class="term"><code class="option">+[no]answer</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Display [do not display] the answer section of a
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User reply. The default is to display it.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term"><code class="option">+[no]authority</code></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 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>
e.g. "[ key id = value ]".
IPv6 addresses to IP6.INT.
under the IP6.ARPA domain. To use the older RFC1886 method
<dt><span class="term"><code class="option">+[no]cookie[<span class="optional">=####</span>]</code></span></dt>
accepted. Setting a named flag (e.g. DO) will silently be