mdig.docbook revision ef1e2f790639e187d2286292f25593ad7c6c2391
ecff557eebd67a717ab6fd3323af27363ee3273dMark Andrews<!ENTITY mdash "—">]>
fbc50678e18eced2c1324bd968e77d4d7737d0caMark Andrews - Copyright (C) 2015, 2016 Internet Systems Consortium, Inc. ("ISC")
fbc50678e18eced2c1324bd968e77d4d7737d0caMark Andrews - This Source Code Form is subject to the terms of the Mozilla Public
fbc50678e18eced2c1324bd968e77d4d7737d0caMark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
c2afbab9dc8de73c85b32624a8364bc7532d1fa9Witold Krecicki - file, You can obtain one at http://mozilla.org/MPL/2.0/.
51ec0decc11beda6b903fbfa18c35edef09ad5feWitold Krecicki<!-- Converted by db4-upgrade version 1.0 -->
51ec0decc11beda6b903fbfa18c35edef09ad5feWitold Krecicki<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.mdig">
3d0b7d5cc3428dedf4486e949fbd536eef494b99Evan Hunt <refentryinfo>
3d0b7d5cc3428dedf4486e949fbd536eef494b99Evan Hunt <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
9268297baa1429d8851c36972d918dde66544746Mark Andrews </refentryinfo>
9268297baa1429d8851c36972d918dde66544746Mark Andrews <refentrytitle><application>mdig</application></refentrytitle>
d7ab0204e26098847232548f03833e185db0b99fMark Andrews <refnamediv>
aabcb1fde0ca255ff30f0a5c10cbd39f798cc5b7Mark Andrews <refname><application>mdig</application></refname>
aabcb1fde0ca255ff30f0a5c10cbd39f798cc5b7Mark Andrews <refpurpose>DNS pipelined lookup utility</refpurpose>
aabcb1fde0ca255ff30f0a5c10cbd39f798cc5b7Mark Andrews </refnamediv>
7a00d69909ace5dc11bcff9c1e07c311f92a7f8eWitold Krecicki <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
ac110848296c18b3a3bfaa89bdee2dd00755b36fMark Andrews <refsynopsisdiv>
ede52ba98d02bc1ac4483a77d403ff1d64a003ceMark Andrews <arg choice="opt" rep="norepeat"><option>-f <replaceable class="parameter">filename</replaceable></option></arg>
ede52ba98d02bc1ac4483a77d403ff1d64a003ceMark Andrews <arg choice="opt" rep="norepeat"><option>-h</option></arg>
a0f5a5e3c5c6dd29b18bc06fea0d02ae7fc24ac9Mark Andrews <arg choice="opt" rep="norepeat"><option>-v</option></arg>
a0f5a5e3c5c6dd29b18bc06fea0d02ae7fc24ac9Mark Andrews <arg choice="opt" rep="norepeat"><option>-4</option></arg>
0cbe448914be61d0f92b1e9d3adaeba87d25639dEvan Hunt <arg choice="opt" rep="norepeat"><option>-6</option></arg>
0cbe448914be61d0f92b1e9d3adaeba87d25639dEvan Hunt <arg choice="opt" rep="norepeat"><option>-b <replaceable class="parameter">address</replaceable></option></arg>
0cbe448914be61d0f92b1e9d3adaeba87d25639dEvan Hunt <arg choice="opt" rep="norepeat"><option>-p <replaceable class="parameter">port#</replaceable></option></arg>
0cbe448914be61d0f92b1e9d3adaeba87d25639dEvan Hunt <arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
0cbe448914be61d0f92b1e9d3adaeba87d25639dEvan Hunt <arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">type</replaceable></option></arg>
9dede25430218a1f683dfef36f04ac7cf5bbd9e8Mark Andrews <arg choice="opt" rep="norepeat"><option>-i</option></arg>
10f8dc8456ba073fdb2bfc5168d78de574debeeeMark Andrews <arg choice="opt" rep="norepeat"><option>-x <replaceable class="parameter">addr</replaceable></option></arg>
88699327de812fdd5beeb68b06ea45000fca2175Mark Andrews </cmdsynopsis>
7472cd350fe9245553e9da7f2df8e7e364d136abMukund Sivaraman </cmdsynopsis>
7472cd350fe9245553e9da7f2df8e7e364d136abMukund Sivaraman <arg choice="opt" rep="norepeat">@server</arg>
049a49c2956dd9cc9b82974e2bbe77c57fcc73dbMark Andrews <arg choice="req" rep="repeat">global-opt</arg>
e2047969decfc0c3fc1a946ccade993cab9c9315Mark Andrews </cmdsynopsis>
c3beecc1bcc6e1c15176a699b41ca77ef6533c25Mark Andrews </refsynopsisdiv>
c3beecc1bcc6e1c15176a699b41ca77ef6533c25Mark Andrews <refsection><info><title>DESCRIPTION</title></info>
da06956f4b1467608a7b00737d49622d6a27ba3fMark Andrews is a multiple/pipelined query version of <command>dig</command>:
53a70bef3508acb1517b8eb57f61a81280c11509Mark Andrews instead of waiting for a response after sending each query,
8090ceb932b52c70d72f655531150e0a1122052dMark Andrews it begins by sending all queries. Responses are displayed in
f89adb2c2a52b505501c3eaa2aec9fd4df6bd60aTinderbox User the order in which they are received, not in the order the
f89adb2c2a52b505501c3eaa2aec9fd4df6bd60aTinderbox User corresponding queries were sent.
28053af04c5121ec234c320e4c76273305816e7aEvan Hunt <command>mdig</command> options are a subset of the
28053af04c5121ec234c320e4c76273305816e7aEvan Hunt <command>dig</command> options, and are divided into "anywhere
28053af04c5121ec234c320e4c76273305816e7aEvan Hunt options" which can occur anywhere, "global options" which must
5ac427050fa0e303171133ce3855b284ab4cfbb7Mark Andrews occur before the query name (or they are ignored with a warning),
5ac427050fa0e303171133ce3855b284ab4cfbb7Mark Andrews and "local options" which apply to the next query on the command
19d80ce5844e00a021643759adcbe27c11b485a0Witold Krecicki The <arg choice="req" rep="norepeat">@server</arg> option is a mandatory global
19d80ce5844e00a021643759adcbe27c11b485a0Witold Krecicki option. It is the name or IP address of the name server to query.
19d80ce5844e00a021643759adcbe27c11b485a0Witold Krecicki (Unlike <command>dig</command>, this value is not retrieved from
19d80ce5844e00a021643759adcbe27c11b485a0Witold Krecicki <filename>/etc/resolv.conf</filename>.) It can be an IPv4 address
dc2a4887c40b1ee361cef51e188b386e19497e01Witold Krecicki in dotted-decimal notation, an IPv6 address in colon-delimited
dc2a4887c40b1ee361cef51e188b386e19497e01Witold Krecicki notation, or a hostname. When the supplied
08e36aa5a5c7697a839f83831fccf8fb3f792848Mark Andrews <parameter>server</parameter> argument is a hostname,
08e36aa5a5c7697a839f83831fccf8fb3f792848Mark Andrews <command>mdig</command> resolves that name before querying
370c6e0ac1ad6330e5ded66e5636c5c93d2ce3ffEvan Hunt the name server.
f1a2709aad7baa4161fdb6f63edf99b0150af252Evan Hunt provides a number of query options which affect
f1a2709aad7baa4161fdb6f63edf99b0150af252Evan Hunt the way in which lookups are made and the results displayed. Some of
f1a2709aad7baa4161fdb6f63edf99b0150af252Evan Hunt these set or reset flag bits in the query header, some determine which
f1a2709aad7baa4161fdb6f63edf99b0150af252Evan Hunt sections of the answer get printed, and others determine the timeout
402c63495c40b2289de8daee5a396fd392cea080Mark Andrews and retry strategies.
402c63495c40b2289de8daee5a396fd392cea080Mark Andrews Each query option is identified by a keyword preceded by a plus
402c63495c40b2289de8daee5a396fd392cea080Mark Andrews sign (<literal>+</literal>). Some keywords set or reset an
699f790c49d03a9ef3c3234a72d272bb469203e8Evan Hunt option. These may be preceded by the string <literal>no</literal>
699f790c49d03a9ef3c3234a72d272bb469203e8Evan Hunt to negate the meaning of that keyword. Other keywords assign
66074f152f2a42218e6d54f50d4fa3717940c299Evan Hunt values to options like the timeout interval. They have the
66074f152f2a42218e6d54f50d4fa3717940c299Evan Hunt </refsection>
66074f152f2a42218e6d54f50d4fa3717940c299Evan Hunt <refsection><info><title>ANYWHERE OPTIONS</title></info>
cd6eeeb827f65df4bfb3e7ed3454655650f7dba7Mark Andrews The <option>-f</option> option makes <command>mdig</command>
aa5506eda809dfd25b4e1ee6edb5285a77958d2cEvan Hunt operate in batch mode by reading a list of lookup requests to
aa5506eda809dfd25b4e1ee6edb5285a77958d2cEvan Hunt process from the file <parameter>filename</parameter>. The file
f6096b958c8b58c4709860d7c4dcdde5deeacb7aEvan Hunt contains a number of queries, one per line. Each entry in the
f6096b958c8b58c4709860d7c4dcdde5deeacb7aEvan Hunt file should be organized in the same way they would be presented
f6096b958c8b58c4709860d7c4dcdde5deeacb7aEvan Hunt as queries to <command>mdig</command> using the command-line interface.
aa5506eda809dfd25b4e1ee6edb5285a77958d2cEvan Hunt The <option>-h</option> causes <command>mdig</command> to
f6096b958c8b58c4709860d7c4dcdde5deeacb7aEvan Hunt print the detailed help with the full list of options and exit.
3cd204c4a46f21bf2a38f35e79af45ac595be943Evan Hunt The <option>-v</option> causes <command>mdig</command> to
3cd204c4a46f21bf2a38f35e79af45ac595be943Evan Hunt print the version number and exit.
8fcf2413e99597b6690b6a352aa12842f9be27e5Mark Andrews </refsection>
8fcf2413e99597b6690b6a352aa12842f9be27e5Mark Andrews <refsection><info><title>GLOBAL OPTIONS</title></info>
651be63a1111c50942533016b3a2a6403d74cd9eMark Andrews The <option>-4</option> option forces <command>mdig</command> to
651be63a1111c50942533016b3a2a6403d74cd9eMark Andrews only use IPv4 query transport.
448884248519a8edade1b51aa7d20140b12764a9Evan Hunt The <option>-6</option> option forces <command>mdig</command> to
448884248519a8edade1b51aa7d20140b12764a9Evan Hunt only use IPv6 query transport.
39225b4b510385f0cee915f0622574b76f5d6082Evan Hunt The <option>-b</option> option sets the source IP address of the
cf24cbd837617c5cb89f04ba97b262be21a925bfEvan Hunt query to <parameter>address</parameter>. This must be a valid
cf24cbd837617c5cb89f04ba97b262be21a925bfEvan Hunt address on one of the host's network interfaces or "0.0.0.0" or
cf24cbd837617c5cb89f04ba97b262be21a925bfEvan Hunt "::". An optional port may be specified by appending
ddf3342cca1a2dbd98c5443cbb9b184c428cdda5Evan Hunt "#<port>"
558278974eb4a1021943e6bbbc6c7d80dc3707fdMark Andrews The <option>-p</option> option is used when a non-standard port
132a57117978816eebf6f8c33b39bdcfcd62fd7aEvan Hunt number is to be queried.
132a57117978816eebf6f8c33b39bdcfcd62fd7aEvan Hunt that <command>mdig</command> will send its queries instead of
132a57117978816eebf6f8c33b39bdcfcd62fd7aEvan Hunt the standard DNS port number 53. This option would be used to
0993cd5f2227c1aa6a8554f4a9a847efabbcfcb8Mark Andrews test a name server that has been configured to listen for
0993cd5f2227c1aa6a8554f4a9a847efabbcfcb8Mark Andrews queries on a non-standard port number.
756c6433301f2f5dad3372af2bef56c0b28e99b7Mark Andrews The global query options are:
756c6433301f2f5dad3372af2bef56c0b28e99b7Mark Andrews <variablelist>
1add4a7939a550d50b156f72631ea374b6182149Mark Andrews <varlistentry>
7c525954642f8fb3698b555115edb09fe3bd3354Mark Andrews Display [do not display] the additional section of a
7c525954642f8fb3698b555115edb09fe3bd3354Mark Andrews reply. The default is to display it.
33a4294f442f7505c8e2453beb422b5928ec697cMark Andrews </varlistentry>
33a4294f442f7505c8e2453beb422b5928ec697cMark Andrews <varlistentry>
59328c76745ee6d2df047e3f072b118258b87cb6Mukund Sivaraman Set or clear all display flags.
ade0aa3cb0fafbbe9fffb29f9abba4ce85890c3fMark Andrews </varlistentry>
275265ab27815d2261ebf68b48201fb7bffdf426Mukund Sivaraman <varlistentry>
023ba1e6ef28d888ad0030fd72937fb4de2129bdEvan Hunt Display [do not display] the answer section of a
023ba1e6ef28d888ad0030fd72937fb4de2129bdEvan Hunt reply. The default is to display it.
44c86318ed432af96848269250930297eea2bba3Evan Hunt </varlistentry>
806e05d28a479291110a9fdb1788e675a56fc364Mark Andrews <varlistentry>
455c0848f80a8acda27aad1466c72987cafaa029Mark Andrews Display [do not display] the authority section of a
455c0848f80a8acda27aad1466c72987cafaa029Mark Andrews reply. The default is to display it.
f9da4a8e543cf895b6171773e75d343b2914a7e7Mark Andrews </varlistentry>
f9da4a8e543cf895b6171773e75d343b2914a7e7Mark Andrews <varlistentry>
293a9e997803ebcf4e6ade8c972465bf6330f534Mukund Sivaraman <term><option>+[no]besteffort</option></term>
293a9e997803ebcf4e6ade8c972465bf6330f534Mukund Sivaraman Attempt to display the contents of messages which are
5995fec51cc8bb7e53804e4936e60aa1537f3673Mukund Sivaraman malformed. The default is to not display malformed
a2b15b3305acd52179e6f3dc7d073b07fbc40b8eMark Andrews </varlistentry>
a2b15b3305acd52179e6f3dc7d073b07fbc40b8eMark Andrews <varlistentry>
79a55d4f4dcf3d6f617523228503d8584b72a3a3Mukund Sivaraman Display [do not display] the CLASS when printing the
0c29904b27c9ab3b85ecbde159b22ae1323bdbcdMukund Sivaraman </varlistentry>
f3ad877eb05befbc862b0233d985758c0caef29aEvan Hunt <varlistentry>
d88ba937124b2a4f8a074fc2aef9caf2022308b4Mark Andrews Toggle the display of comment lines in the output.
40401165e4646f1624175ac80bf9b51826ab67ecMark Andrews The default is to print comments.
ec450fde7cee684f37b0a59d770330c700419610Evan Hunt </varlistentry>
ec450fde7cee684f37b0a59d770330c700419610Evan Hunt <varlistentry>
d1dbf6b20fdcfa95acd75cdb96fcd57067a31144Mukund Sivaraman <term><option>+[no]continue</option></term>
3fe17d62e32017b643b852ede1b234271ee308e1Evan Hunt Continue on errors (e.g. timeouts).
f02c22d58ac88777655e0b407b22b07864d39184Evan Hunt </varlistentry>
f02c22d58ac88777655e0b407b22b07864d39184Evan Hunt <varlistentry>
df9a49ee07f7629ec6abd2e3bd0dee600d7e2ab4Evan Hunt Toggle the display of cryptographic fields in DNSSEC
df9a49ee07f7629ec6abd2e3bd0dee600d7e2ab4Evan Hunt records. The contents of these field are unnecessary
e073205a884d3762fdc678d4b8a61b627a4070abEvan Hunt to debug most DNSSEC validation failures and removing
e073205a884d3762fdc678d4b8a61b627a4070abEvan Hunt them makes it easier to see the common failures. The
e073205a884d3762fdc678d4b8a61b627a4070abEvan Hunt default is to display the fields. When omitted they
832ab79d1f8bc4edf638780b306888da30ac3a1eMark Andrews are replaced by the string "[omitted]" or in the
832ab79d1f8bc4edf638780b306888da30ac3a1eMark Andrews DNSKEY case the key id is displayed as the replacement,
832ab79d1f8bc4edf638780b306888da30ac3a1eMark Andrews e.g. "[ key id = value ]".
9d85a773829484832f762a9088a7dafd6794aa39Mark Andrews </varlistentry>
8ede7a974b126b3afe766c11ca621aee52c9889aEvan Hunt <varlistentry>
8ede7a974b126b3afe766c11ca621aee52c9889aEvan Hunt <term><option>+dscp[=value]</option></term> <listitem>
8ede7a974b126b3afe766c11ca621aee52c9889aEvan Hunt Set the DSCP code point to be used when sending the
8ede7a974b126b3afe766c11ca621aee52c9889aEvan Hunt query. Valid DSCP code points are in the range
8ede7a974b126b3afe766c11ca621aee52c9889aEvan Hunt [0..63]. By default no code point is explicitly set.
f8432e3f249dbec36394539ca1f3cb25bf33abfeMark Andrews </varlistentry>
630b2d0c5a04cfc8b08d4585b7a0d997c00d7341Evan Hunt <varlistentry>
630b2d0c5a04cfc8b08d4585b7a0d997c00d7341Evan Hunt Print records like the SOA records in a verbose
630b2d0c5a04cfc8b08d4585b7a0d997c00d7341Evan Hunt multi-line format with human-readable comments. The
1d383fd4b23fc7031e562bf5db02e3018c5d0b9eMark Andrews default is to print each record on a single line, to
1d383fd4b23fc7031e562bf5db02e3018c5d0b9eMark Andrews facilitate machine parsing of the <command>mdig</command>
40401165e4646f1624175ac80bf9b51826ab67ecMark Andrews </varlistentry>
9b789c54f8829b867c4a888c47bd2310a790415aEvan Hunt <varlistentry>
d40154cab71b0c774d80df2c0091e1f8edcaa7d4Evan Hunt Print [do not print] the question section of a query
d40154cab71b0c774d80df2c0091e1f8edcaa7d4Evan Hunt when an answer is returned. The default is to print
d40154cab71b0c774d80df2c0091e1f8edcaa7d4Evan Hunt the question section as a comment.
2879ee2c72638ea190728f931ce286760caa4521Evan Hunt </varlistentry>
6bd794171f2ba0ee93b99ccbf80378959f4e965bEvan Hunt <varlistentry>
73fbd4c9d3e65621eb32a8e01659532f131de690Mark Andrews Toggle the display of per-record comments in the
73fbd4c9d3e65621eb32a8e01659532f131de690Mark Andrews output (for example, human-readable key information
fc7bce5f350aa119d4c500fd5b35c47b14b539efMark Andrews about DNSKEY records). The default is not to print
fc7bce5f350aa119d4c500fd5b35c47b14b539efMark Andrews record comments unless multiline mode is active.
bb5d14d7243d71e03d262ff175b355b52873e195Evan Hunt </varlistentry>
bb5d14d7243d71e03d262ff175b355b52873e195Evan Hunt <varlistentry>
c8b968f4144a271213756cc33e8062b9efdd7441Evan Hunt Provide a terse answer. The default is to print the
c8b968f4144a271213756cc33e8062b9efdd7441Evan Hunt answer in a verbose form.
41494939b62d74fb159009f28428df23e5fc70e3Evan Hunt </varlistentry>
41494939b62d74fb159009f28428df23e5fc70e3Evan Hunt <varlistentry>
292eb9c4e4fc51aec911e72821735a123a8c252aMark Andrews Split long hex- or base64-formatted fields in resource
292eb9c4e4fc51aec911e72821735a123a8c252aMark Andrews records into chunks of <parameter>W</parameter>
292eb9c4e4fc51aec911e72821735a123a8c252aMark Andrews characters (where <parameter>W</parameter> is rounded
292eb9c4e4fc51aec911e72821735a123a8c252aMark Andrews up to the nearest multiple of 4).
1b3d21180244529f0099894fe9d29beb3f11efb3Mark Andrews <parameter>+split=0</parameter> causes fields not to
1b3d21180244529f0099894fe9d29beb3f11efb3Mark Andrews be split at all. The default is 56 characters, or
fbed5f0f44515f5b3ca499a3466c875507852970Evan Hunt 44 characters when multiline mode is active.
fbed5f0f44515f5b3ca499a3466c875507852970Evan Hunt </varlistentry>
4fa9eaf0734e892431e78179bdcc5251c9b6aa7dMark Andrews <varlistentry>
49762dffc45b6c02abe5d131cb7c49369cf13e09Mark Andrews Use [do not use] TCP when querying name servers. The
49762dffc45b6c02abe5d131cb7c49369cf13e09Mark Andrews default behavior is to use UDP.
ecc06cbc32c5a2b91a17e65c1820c9c66313d35cMukund Sivaraman </varlistentry>
ecc06cbc32c5a2b91a17e65c1820c9c66313d35cMukund Sivaraman <varlistentry>
505d311709be77b2bd6ebb2aead84771588f9c29Mark Andrews Display [do not display] the TTL when printing the
5d79b60fc5e4dad4f04da39570517d20a2425f8bMukund Sivaraman </varlistentry>
5d79b60fc5e4dad4f04da39570517d20a2425f8bMukund Sivaraman <varlistentry>
5d79b60fc5e4dad4f04da39570517d20a2425f8bMukund Sivaraman <term><option>+[no]ttlunits</option></term>
322e6b5be784d79d15fea9db9440dd821162c574Mark Andrews Display [do not display] the TTL in friendly human-readable
27bc16fcdc67f9afefefb54ae98dfdae3a5bc1f8Mukund Sivaraman time units of "s", "m", "h", "d", and "w", representing
27bc16fcdc67f9afefefb54ae98dfdae3a5bc1f8Mukund Sivaraman seconds, minutes, hours, days and weeks. Implies +ttlid.
5b13a593fe7d8055992bd12aeb399bdb06e2a533Mukund Sivaraman </varlistentry>
95bef099e9762c8078c0ba9749293b488727dc58Mark Andrews <varlistentry>
464c2c673b879071da66cab5a627baf35c5e0f90Evan Hunt Use [do not use] TCP when querying name servers. This
464c2c673b879071da66cab5a627baf35c5e0f90Evan Hunt alternate syntax to <parameter>+[no]tcp</parameter>
226dd20bbd6c6bdeadffa71361d9a0ec61308d69Evan Hunt is provided for backwards compatibility. The "vc"
226dd20bbd6c6bdeadffa71361d9a0ec61308d69Evan Hunt stands for "virtual circuit".
10d7ab44cc72170c527dde8cc9e049e046342769Mark Andrews </varlistentry>
4071efbec0e87b987aaf109f1ae8050aa8ecbcb8Evan Hunt </variablelist>
4071efbec0e87b987aaf109f1ae8050aa8ecbcb8Evan Hunt </refsection>
4071efbec0e87b987aaf109f1ae8050aa8ecbcb8Evan Hunt <refsection><info><title>LOCAL OPTIONS</title></info>
26177be2946c99a34096b7d8c202139dfc0e9760Mark Andrews The <option>-c</option> option sets the query class to
26177be2946c99a34096b7d8c202139dfc0e9760Mark Andrews <parameter>class</parameter>. It can be any valid query class
26177be2946c99a34096b7d8c202139dfc0e9760Mark Andrews which is supported in BIND 9. The default query class is "IN".
5b1c7ef35bb495820360182b5192689f33f1cc7dMark Andrews The <option>-t</option> option sets the query type to
5b1c7ef35bb495820360182b5192689f33f1cc7dMark Andrews <parameter>type</parameter>. It can be any valid query type
5b1c7ef35bb495820360182b5192689f33f1cc7dMark Andrews which is supported in BIND 9. The default query type is "A",
913d976eca8751851111c0b4357f650295d4aa3dMark Andrews unless the <option>-x</option> option is supplied to indicate
913d976eca8751851111c0b4357f650295d4aa3dMark Andrews a reverse lookup with the "PTR" query type.
7bc21557f3583bab18fd9a002d115aaa5faa5561Mukund Sivaraman The <option>-i</option> option sets the reverse domain for
7bc21557f3583bab18fd9a002d115aaa5faa5561Mukund Sivaraman IPv6 addresses to IP6.INT.
a727cdff50383b98a150922e16a470cc63225309Tinderbox User Reverse lookups — mapping addresses to names — are
c8821d124c532e0a65752b378f924d4259499fd3Mark Andrews address in dotted-decimal notation, or a colon-delimited IPv6 address.
c8821d124c532e0a65752b378f924d4259499fd3Mark Andrews <command>mdig</command> automatically performs a lookup for a
c8821d124c532e0a65752b378f924d4259499fd3Mark Andrews query name like <literal>11.12.13.10.in-addr.arpa</literal> and
63042d5b579ae3d43104133007e55c224c698904Evan Hunt sets the query type and class to PTR and IN respectively.
c8821d124c532e0a65752b378f924d4259499fd3Mark Andrews By default, IPv6 addresses are looked up using nibble format
58f7af60e79a5aaf58f6a8861c306d4c617fb1d1Mukund Sivaraman under the IP6.ARPA domain. To use the older RFC1886 method
58f7af60e79a5aaf58f6a8861c306d4c617fb1d1Mukund Sivaraman using the IP6.INT domain specify the <option>-i</option> option.
58f7af60e79a5aaf58f6a8861c306d4c617fb1d1Mukund Sivaraman The local query options are:
9b17fd447c684a84b2f5fbfb04ad6e890ae2078cMukund Sivaraman <variablelist>
9b17fd447c684a84b2f5fbfb04ad6e890ae2078cMukund Sivaraman <varlistentry>
b51391848127d0303bd385a555c76aef57d1b4ebEvan Hunt </varlistentry>
bfd4b9e11aa9e8c2b43022a6b7a896b26bd5d7a0Witold Krecicki <varlistentry>
29868ebbe3c7bc06f833e329ea190dc442331bf1Mark Andrews Sets the "aa" flag in the query.
2f450fcd295795fb1771432e098af3d6e52c8a0bMark Andrews </varlistentry>
e939674d53a127ddeeaf4b41fd72933f0b493308Mark Andrews <varlistentry>
6b8519147a5c24b4a5942042e83fd539d0d445ccEvan Hunt Set [do not set] the AD (authentic data) bit in the
6b8519147a5c24b4a5942042e83fd539d0d445ccEvan Hunt query. This requests the server to return whether
09f82f50798e170b172e6ba358ed123536243839Evan Hunt all of the answer and authority sections have all
09f82f50798e170b172e6ba358ed123536243839Evan Hunt been validated as secure according to the security
09f82f50798e170b172e6ba358ed123536243839Evan Hunt policy of the server. AD=1 indicates that all records
8475bed9de77920f884f1ae296f581efbd1e42f8Mark Andrews have been validated as secure and the answer is not
861aa4e9039e6f354545177c4c2323b485549602Mark Andrews from a OPT-OUT range. AD=0 indicate that some part
8475bed9de77920f884f1ae296f581efbd1e42f8Mark Andrews of the answer was insecure or not validated. This
35928b7e1af8ea4d01a2855ab833dfe59d2345faMukund Sivaraman bit is set by default.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt </varlistentry>
f06b6a9b14509a3b473f52dd797bc490f6f6511dMark Andrews <varlistentry>
aa9b64060fb6e946a920e957805f564d149e88e0Evan Hunt Set the UDP message buffer size advertised using EDNS0
412f873b9fafa0f8161a1203e7731d9d67052e49Mark Andrews to <parameter>B</parameter> bytes. The maximum and
412f873b9fafa0f8161a1203e7731d9d67052e49Mark Andrews minimum sizes of this buffer are 65535 and 0 respectively.
72ac929f2bfe186ab4fe2d9425685d6ef419f200Mark Andrews Values outside this range are rounded up or down
72ac929f2bfe186ab4fe2d9425685d6ef419f200Mark Andrews appropriately. Values other than zero will cause a
72ac929f2bfe186ab4fe2d9425685d6ef419f200Mark Andrews EDNS query to be sent.
0526268c2b2806ceb67032e0bfee708b6e70e004Mark Andrews </varlistentry>
0526268c2b2806ceb67032e0bfee708b6e70e004Mark Andrews <varlistentry>
9d8169cbf8390c9e2e9707026fd078e282811069Mark Andrews Set [do not set] the CD (checking disabled) bit in
f824c65d1fb6a2490b03228e63cc43dae6844f73Mark Andrews the query. This requests the server to not perform
90174e64f49bb7cba6a83fb665ebcb597aad7b57Evan Hunt DNSSEC validation of responses.
90174e64f49bb7cba6a83fb665ebcb597aad7b57Evan Hunt </varlistentry>
6588a2b404365cea59e71a3f639349272600f68dMark Andrews <varlistentry>
6588a2b404365cea59e71a3f639349272600f68dMark Andrews <term><option>+[no]cookie<optional>=####</optional></option></term>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Send a COOKIE EDNS option, with optional value.
35928b7e1af8ea4d01a2855ab833dfe59d2345faMukund Sivaraman Replaying a COOKIE from a previous response will allow
9260c1157d12ef716fe6227fd8af845ec7fd1eedMukund Sivaraman the server to identify a previous client. The default
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt Requests DNSSEC records be sent by setting the DNSSEC
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt OK bit (DO) in the OPT record in the additional section
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt of the query.
a239044323418956d7d48c14d61d19f721cc5ba5Witold Krecicki </varlistentry>
18749940aee8ee6cf8fc6a81f659819310d5aa78Mark Andrews <varlistentry>
ffdd3bc812a140fb0e3d5b6f0df0a4efbfe4b412Mark Andrews Specify the EDNS version to query with. Valid values
ffdd3bc812a140fb0e3d5b6f0df0a4efbfe4b412Mark Andrews are 0 to 255. Setting the EDNS version will cause
09f4e41912d08b5c1685f4d23bd19d32f63db935Mark Andrews a EDNS query to be sent. <option>+noedns</option>
09f4e41912d08b5c1685f4d23bd19d32f63db935Mark Andrews clears the remembered EDNS version. EDNS is set to
09f4e41912d08b5c1685f4d23bd19d32f63db935Mark Andrews 0 by default.
0dc485ffb6ca6e90979561db1705f6a89be8b8edMark Andrews </varlistentry>
24231afa05b4ceefe8f0aebcdabe9ccf002346f9Mark Andrews <varlistentry>
24231afa05b4ceefe8f0aebcdabe9ccf002346f9Mark Andrews <term><option>+[no]ednsflags[=#]</option></term>
8a0b6b3901b34530a850d78758fe4e5b6218d193Mark Andrews Set the must-be-zero EDNS flags bits (Z bits) to the
2a12984ce69f7f49dc3aeef1b216e0c7c93373acMark Andrews specified value. Decimal, hex and octal encodings are
2a12984ce69f7f49dc3aeef1b216e0c7c93373acMark Andrews accepted. Setting a named flag (e.g. DO) will silently be
40c619daeeb99015afa31b1a4a76d6c20b0a3fc6Evan Hunt ignored. By default, no Z bits are set.
87e7d08a8bae58ab8edacaa990a4234063c23793Mar Andrews </varlistentry>
87e7d08a8bae58ab8edacaa990a4234063c23793Mar Andrews <varlistentry>
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt <term><option>+[no]ednsopt[=code[:value]]</option></term>
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt Specify EDNS option with code point <option>code</option>
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt and optionally payload of <option>value</option> as a
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt clears the EDNS options to be sent.
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt </varlistentry>
a00f9e2f50675bd43cc6a9fe2669709162a2ccb4Evan Hunt <varlistentry>
e6d0a391f5f9b18f5bd497aefff269e474ee560cWitold Krecicki Send an EDNS Expire option.
98a7f8c7ae44bb98d5469cb3a4240c59abceba7fMark Andrews </varlistentry>
98a7f8c7ae44bb98d5469cb3a4240c59abceba7fMark Andrews <varlistentry>
3836539e8747c65b789037b8ca8cd47badbb991fJeremy C. Reed Include an EDNS name server ID request when sending
a21c415687a855f84fbf10db91671b1341e8b990Mark Andrews </varlistentry>
a21c415687a855f84fbf10db91671b1341e8b990Mark Andrews <varlistentry>
f6e45a5c54b7af4b1c303e8d3ff3b7d78622df9eMark Andrews Toggle the setting of the RD (recursion desired) bit
f6e45a5c54b7af4b1c303e8d3ff3b7d78622df9eMark Andrews in the query. This bit is set by default, which means
705d56b47a932cc277f980755e80ac4f46a18a64Mark Andrews <command>mdig</command> normally sends recursive
ff55c577ba8a95f763b8982b7ab5e4a980209a09Mark Andrews </varlistentry>
e0a30050c8516a3d54a4f8dcdd88435704a8a3edMark Andrews <varlistentry>
741b63c8695bab0582e3f9f308993ab53a60b377Mark Andrews Sets the number of times to retry UDP queries to
741b63c8695bab0582e3f9f308993ab53a60b377Mark Andrews server to <parameter>T</parameter> instead of the
741b63c8695bab0582e3f9f308993ab53a60b377Mark Andrews default, 2. Unlike <parameter>+tries</parameter>,
09177840c73c1edec0d085dd8d92f225ba371014Mark Andrews this does not include the initial query.
f43e5c8ed2e68b7064c909b1fece6d976799b8dbMark Andrews </varlistentry>
7b1f63dcd1a20a7c66b869e323efcdbdb0612a0dMark Andrews <varlistentry>
7b1f63dcd1a20a7c66b869e323efcdbdb0612a0dMark Andrews <term><option>+[no]subnet=addr[/prefix-length]</option></term>
fe51e068f0892ae9258d9fd0e14fe2a469ff8edfMark Andrews Send (don't send) an EDNS Client Subnet option with the
0f2ecf4b5c6721629162d4fd32826189d33a9b03Mark Andrews specified IP address or network prefix.
757e405d3c22e263dbd4aef75f7a188f891625b9Mark Andrews <command>mdig +subnet=0.0.0.0/0</command>, or simply
e8742e9598a72a429cf2ca05c6c1bc3de9b35283Tinderbox User <command>mdig +subnet=0</command> for short, sends an EDNS
d261093639c90f1b13418706ea9077d690a29eb0Evan Hunt client-subnet option with an empty address and a source
226339ed435db90da8e072ef46e2c27cf0dc687bEvan Hunt prefix-length of zero, which signals a resolver that
226339ed435db90da8e072ef46e2c27cf0dc687bEvan Hunt the client's address information must
295a711b72b075a77065b7a952860269b5ae5d1dMark Andrews </varlistentry>
757e405d3c22e263dbd4aef75f7a188f891625b9Mark Andrews <varlistentry>
4523c3b371e0e8aa6451aefcf2ba593c4d16ea31Evan Hunt Sets the timeout for a query to
a0ef8211d3bb5d4a7e56145e014c3da3466051c8Mark Andrews timeout is 5 seconds for UDP transport and 10 for TCP.
a0ef8211d3bb5d4a7e56145e014c3da3466051c8Mark Andrews An attempt to set <parameter>T</parameter> to less
a0ef8211d3bb5d4a7e56145e014c3da3466051c8Mark Andrews than 1 will result
3fa134363f99816b36e30822a098196810ae6f20Mark Andrews in a query timeout of 1 second being applied.
5a49f61ca968283d59c97e583fd6fb02ecaeb773Mark Andrews </varlistentry>
8b29fc0b7a13db404f1a13fcfad42c2e7cfbe25bMark Andrews <varlistentry>
075a3d60c23140f05db10d70126ff271ef6469c9Mark Andrews Sets the number of times to try UDP queries to server
075a3d60c23140f05db10d70126ff271ef6469c9Mark Andrews to <parameter>T</parameter> instead of the default,
4ca7391e640bd4f0abb31508019d3bd62819fa8eMark Andrews 3. If <parameter>T</parameter> is less than or equal
4ca7391e640bd4f0abb31508019d3bd62819fa8eMark Andrews to zero, the number of tries is silently rounded up
fbd9aaa58c32abaeab1bd3ca6943b18ce19ea023Mark Andrews </varlistentry>
fbd9aaa58c32abaeab1bd3ca6943b18ce19ea023Mark Andrews <varlistentry>
9b956d342e93ab60d5d9367785b26546f7e49391Mark Andrews Sets the timeout between UDP query retries.
5855fd79e375c74fc9df57ce0b4c4ef1b9fcdc3eMark Andrews </varlistentry>
5855fd79e375c74fc9df57ce0b4c4ef1b9fcdc3eMark Andrews <varlistentry>
c7e5ba1d17f2db135b2c1ab192c2746189394fa2Mark Andrews <term><option>+[no]unknownformat</option></term>
dc3912f3caac1104fef441fd18571b7a975708eaMark Andrews Print all RDATA in unknown RR type presentation format
7d0dfa63cf3228b56053815bdf25da7d0e6dc501Mark Andrews (RFC 3597). The default is to print RDATA for known types
7d0dfa63cf3228b56053815bdf25da7d0e6dc501Mark Andrews in the type's presentation format.
18ba804f3ab6a7fea10404bb6675a49b59a153c5Mark Andrews </varlistentry>
ec3dbae9eb0fdbda37c76c2b41e819c7982be1c4Mukund Sivaraman <varlistentry>
ec3dbae9eb0fdbda37c76c2b41e819c7982be1c4Mukund Sivaraman Set [do not set] the last unassigned DNS header flag in a
ec3dbae9eb0fdbda37c76c2b41e819c7982be1c4Mukund Sivaraman DNS query. This flag is off by default.
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman </varlistentry>
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman </variablelist>
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman </refsection>
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman <refsection><info><title>SEE ALSO</title></info>
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman <refentrytitle>dig</refentrytitle><manvolnum>1</manvolnum>
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman </citerefentry>,
bf350c9f1ab59ac03e34e8063b4ce58662daec2aMukund Sivaraman </refsection>