contrib/bind9/bin/dig/dig.docbook

   1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   2                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
   3                [<!ENTITY mdash "&#8212;">]>
   4 <!--
   5  - Copyright (C) 2004-2007  Internet Systems Consortium, Inc. ("ISC")
   6  - Copyright (C) 2000-2003  Internet Software Consortium.
   7  -
   8  - Permission to use, copy, modify, and/or distribute this software for any
   9  - purpose with or without fee is hereby granted, provided that the above
  10  - copyright notice and this permission notice appear in all copies.
  11  -
  12  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  13  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  14  - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  15  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  16  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  17  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  18  - PERFORMANCE OF THIS SOFTWARE.
  19 -->
  20
  21 <!-- $Id: dig.docbook,v 1.17.18.21 2007/08/28 07:19:55 tbox Exp $ -->
  22 <refentry id="man.dig">
  23
  24   <refentryinfo>
  25     <date>Jun 30, 2000</date>
  26   </refentryinfo>
  27
  28   <refmeta>
  29     <refentrytitle>dig</refentrytitle>
  30     <manvolnum>1</manvolnum>
  31     <refmiscinfo>BIND9</refmiscinfo>
  32   </refmeta>
  33
  34   <refnamediv>
  35     <refname>dig</refname>
  36     <refpurpose>DNS lookup utility</refpurpose>
  37   </refnamediv>
  38
  39   <docinfo>
  40     <copyright>
  41       <year>2004</year>
  42       <year>2005</year>
  43       <year>2006</year>
  44       <year>2007</year>
  45       <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
  46     </copyright>
  47     <copyright>
  48       <year>2000</year>
  49       <year>2001</year>
  50       <year>2002</year>
  51       <year>2003</year>
  52       <holder>Internet Software Consortium.</holder>
  53     </copyright>
  54   </docinfo>
  55
  56   <refsynopsisdiv>
  57     <cmdsynopsis>
  58       <command>dig</command>
  59       <arg choice="opt">@server</arg>
  60       <arg><option>-b <replaceable class="parameter">address</replaceable></option></arg>
  61       <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
  62       <arg><option>-f <replaceable class="parameter">filename</replaceable></option></arg>
  63       <arg><option>-k <replaceable class="parameter">filename</replaceable></option></arg>
  64       <arg><option>-p <replaceable class="parameter">port#</replaceable></option></arg>
  65       <arg><option>-q <replaceable class="parameter">name</replaceable></option></arg>
  66       <arg><option>-t <replaceable class="parameter">type</replaceable></option></arg>
  67       <arg><option>-x <replaceable class="parameter">addr</replaceable></option></arg>
  68       <arg><option>-y <replaceable class="parameter"><optional>hmac:</optional>name:key</replaceable></option></arg>
  69       <arg><option>-4</option></arg>
  70       <arg><option>-6</option></arg>
  71       <arg choice="opt">name</arg>
  72       <arg choice="opt">type</arg>
  73       <arg choice="opt">class</arg>
  74       <arg choice="opt" rep="repeat">queryopt</arg>
  75     </cmdsynopsis>
  76
  77     <cmdsynopsis>
  78       <command>dig</command>
  79       <arg><option>-h</option></arg>
  80     </cmdsynopsis>
  81
  82     <cmdsynopsis>
  83       <command>dig</command>
  84       <arg choice="opt" rep="repeat">global-queryopt</arg>
  85       <arg choice="opt" rep="repeat">query</arg>
  86     </cmdsynopsis>
  87   </refsynopsisdiv>
  88
  89   <refsect1>
  90     <title>DESCRIPTION</title>
  91     <para><command>dig</command>
  92       (domain information groper) is a flexible tool
  93       for interrogating DNS name servers.  It performs DNS lookups and
  94       displays the answers that are returned from the name server(s) that
  95       were queried.  Most DNS administrators use <command>dig</command> to
  96       troubleshoot DNS problems because of its flexibility, ease of use and
  97       clarity of output.  Other lookup tools tend to have less functionality
  98       than <command>dig</command>.
  99     </para>
 100
 101     <para>
 102       Although <command>dig</command> is normally used with
 103       command-line
 104       arguments, it also has a batch mode of operation for reading lookup
 105       requests from a file.  A brief summary of its command-line arguments
 106       and options is printed when the <option>-h</option> option is given.
 107       Unlike earlier versions, the BIND 9 implementation of
 108       <command>dig</command> allows multiple lookups to be issued
 109       from the
 110       command line.
 111     </para>
 112
 113     <para>
 114       Unless it is told to query a specific name server,
 115       <command>dig</command> will try each of the servers listed
 116       in
 117       <filename>/etc/resolv.conf</filename>.
 118     </para>
 119
 120     <para>
 121       When no command line arguments or options are given, will perform an
 122       NS query for "." (the root).
 123     </para>
 124
 125     <para>
 126       It is possible to set per-user defaults for <command>dig</command> via
 127       <filename>${HOME}/.digrc</filename>.  This file is read and
 128       any options in it
 129       are applied before the command line arguments.
 130     </para>
 131
 132     <para>
 133       The IN and CH class names overlap with the IN and CH top level
 134       domains names.  Either use the <option>-t</option> and
 135       <option>-c</option> options to specify the type and class or
 136       use the <option>-q</option> the specify the domain name or
 137       use "IN." and "CH." when looking up these top level domains.
 138     </para>
 139
 140   </refsect1>
 141
 142   <refsect1>
 143     <title>SIMPLE USAGE</title>
 144
 145     <para>
 146       A typical invocation of <command>dig</command> looks like:
 147       <programlisting> dig @server name type </programlisting>
 148       where:
 149
 150       <variablelist>
 151
 152         <varlistentry>
 153           <term><constant>server</constant></term>
 154           <listitem>
 155             <para>
 156               is the name or IP address of the name server to query.  This can
 157               be an IPv4
 158               address in dotted-decimal notation or an IPv6
 159               address in colon-delimited notation.  When the supplied
 160               <parameter>server</parameter> argument is a
 161               hostname,
 162               <command>dig</command> resolves that name before
 163               querying that name
 164               server.  If no <parameter>server</parameter>
 165               argument is provided,
 166               <command>dig</command> consults <filename>/etc/resolv.conf</filename>
 167               and queries the name servers listed there.  The reply from the
 168               name
 169               server that responds is displayed.
 170             </para>
 171           </listitem>
 172         </varlistentry>
 173
 174         <varlistentry>
 175           <term><constant>name</constant></term>
 176           <listitem>
 177             <para>
 178               is the name of the resource record that is to be looked up.
 179             </para>
 180           </listitem>
 181         </varlistentry>
 182
 183         <varlistentry>
 184           <term><constant>type</constant></term>
 185           <listitem>
 186             <para>
 187               indicates what type of query is required &mdash;
 188               ANY, A, MX, SIG, etc.
 189               <parameter>type</parameter> can be any valid query
 190               type.  If no
 191               <parameter>type</parameter> argument is supplied,
 192               <command>dig</command> will perform a lookup for an
 193               A record.
 194             </para>
 195           </listitem>
 196         </varlistentry>
 197
 198       </variablelist>
 199     </para>
 200
 201   </refsect1>
 202
 203   <refsect1>
 204     <title>OPTIONS</title>
 205
 206     <para>
 207       The <option>-b</option> option sets the source IP address of the query
 208       to <parameter>address</parameter>.  This must be a valid
 209       address on
 210       one of the host's network interfaces or "0.0.0.0" or "::".  An optional
 211       port
 212       may be specified by appending "#&lt;port&gt;"
 213     </para>
 214
 215     <para>
 216       The default query class (IN for internet) is overridden by the
 217       <option>-c</option> option.  <parameter>class</parameter> is
 218       any valid
 219       class, such as HS for Hesiod records or CH for Chaosnet records.
 220     </para>
 221
 222     <para>
 223       The <option>-f</option> option makes <command>dig </command>
 224       operate
 225       in batch mode by reading a list of lookup requests to process from the
 226       file <parameter>filename</parameter>.  The file contains a
 227       number of
 228       queries, one per line.  Each entry in the file should be organized in
 229       the same way they would be presented as queries to
 230       <command>dig</command> using the command-line interface.
 231     </para>
 232
 233     <para>
 234       If a non-standard port number is to be queried, the
 235       <option>-p</option> option is used.  <parameter>port#</parameter> is
 236       the port number that <command>dig</command> will send its
 237       queries
 238       instead of the standard DNS port number 53.  This option would be used
 239       to test a name server that has been configured to listen for queries
 240       on a non-standard port number.
 241     </para>
 242
 243     <para>
 244       The <option>-4</option> option forces <command>dig</command>
 245       to only
 246       use IPv4 query transport.  The <option>-6</option> option forces
 247       <command>dig</command> to only use IPv6 query transport.
 248     </para>
 249
 250     <para>
 251       The <option>-t</option> option sets the query type to
 252       <parameter>type</parameter>.  It can be any valid query type
 253       which is
 254       supported in BIND 9.  The default query type is "A", unless the
 255       <option>-x</option> option is supplied to indicate a reverse lookup.
 256       A zone transfer can be requested by specifying a type of AXFR.  When
 257       an incremental zone transfer (IXFR) is required,
 258       <parameter>type</parameter> is set to <literal>ixfr=N</literal>.
 259       The incremental zone transfer will contain the changes made to the zone
 260       since the serial number in the zone's SOA record was
 261       <parameter>N</parameter>.
 262     </para>
 263
 264     <para>
 265       The <option>-q</option> option sets the query name to
 266       <parameter>name</parameter>.  This useful do distinguish the
 267       <parameter>name</parameter> from other arguments.
 268     </para>
 269
 270     <para>
 271       Reverse lookups &mdash; mapping addresses to names &mdash; are simplified by the
 272       <option>-x</option> option.  <parameter>addr</parameter> is
 273       an IPv4
 274       address in dotted-decimal notation, or a colon-delimited IPv6 address.
 275       When this option is used, there is no need to provide the
 276       <parameter>name</parameter>, <parameter>class</parameter> and
 277       <parameter>type</parameter> arguments.  <command>dig</command>
 278       automatically performs a lookup for a name like
 279       <literal>11.12.13.10.in-addr.arpa</literal> and sets the
 280       query type and
 281       class to PTR and IN respectively.  By default, IPv6 addresses are
 282       looked up using nibble format under the IP6.ARPA domain.
 283       To use the older RFC1886 method using the IP6.INT domain
 284       specify the <option>-i</option> option.  Bit string labels (RFC2874)
 285       are now experimental and are not attempted.
 286     </para>
 287
 288     <para>
 289       To sign the DNS queries sent by <command>dig</command> and
 290       their
 291       responses using transaction signatures (TSIG), specify a TSIG key file
 292       using the <option>-k</option> option.  You can also specify the TSIG
 293       key itself on the command line using the <option>-y</option> option;
 294       <parameter>hmac</parameter> is the type of the TSIG, default HMAC-MD5,
 295       <parameter>name</parameter> is the name of the TSIG key and
 296       <parameter>key</parameter> is the actual key.  The key is a
 297       base-64
 298       encoded string, typically generated by
 299       <citerefentry>
 300         <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
 301       </citerefentry>.
 302
 303       Caution should be taken when using the <option>-y</option> option on
 304       multi-user systems as the key can be visible in the output from
 305       <citerefentry>
 306         <refentrytitle>ps</refentrytitle><manvolnum>1</manvolnum>
 307       </citerefentry>
 308       or in the shell's history file.  When
 309       using TSIG authentication with <command>dig</command>, the name
 310       server that is queried needs to know the key and algorithm that is
 311       being used.  In BIND, this is done by providing appropriate
 312       <command>key</command> and <command>server</command> statements in
 313       <filename>named.conf</filename>.
 314     </para>
 315
 316   </refsect1>
 317
 318   <refsect1>
 319     <title>QUERY OPTIONS</title>
 320
 321     <para><command>dig</command>
 322       provides a number of query options which affect
 323       the way in which lookups are made and the results displayed.  Some of
 324       these set or reset flag bits in the query header, some determine which
 325       sections of the answer get printed, and others determine the timeout
 326       and retry strategies.
 327     </para>
 328
 329     <para>
 330       Each query option is identified by a keyword preceded by a plus sign
 331       (<literal>+</literal>).  Some keywords set or reset an
 332       option.  These may be preceded
 333       by the string <literal>no</literal> to negate the meaning of
 334       that keyword.  Other
 335       keywords assign values to options like the timeout interval.  They
 336       have the form <option>+keyword=value</option>.
 337       The query options are:
 338
 339       <variablelist>
 340
 341         <varlistentry>
 342           <term><option>+[no]tcp</option></term>
 343           <listitem>
 344             <para>
 345               Use [do not use] TCP when querying name servers.  The default
 346               behavior is to use UDP unless an AXFR or IXFR query is
 347               requested, in
 348               which case a TCP connection is used.
 349             </para>
 350           </listitem>
 351         </varlistentry>
 352
 353         <varlistentry>
 354           <term><option>+[no]vc</option></term>
 355           <listitem>
 356             <para>
 357               Use [do not use] TCP when querying name servers.  This alternate
 358               syntax to <parameter>+[no]tcp</parameter> is
 359               provided for backwards
 360               compatibility.  The "vc" stands for "virtual circuit".
 361             </para>
 362           </listitem>
 363         </varlistentry>
 364
 365         <varlistentry>
 366           <term><option>+[no]ignore</option></term>
 367           <listitem>
 368             <para>
 369               Ignore truncation in UDP responses instead of retrying with TCP.
 370                By
 371               default, TCP retries are performed.
 372             </para>
 373           </listitem>
 374         </varlistentry>
 375
 376         <varlistentry>
 377           <term><option>+domain=somename</option></term>
 378           <listitem>
 379             <para>
 380               Set the search list to contain the single domain
 381               <parameter>somename</parameter>, as if specified in
 382               a
 383               <command>domain</command> directive in
 384               <filename>/etc/resolv.conf</filename>, and enable
 385               search list
 386               processing as if the <parameter>+search</parameter>
 387               option were given.
 388             </para>
 389           </listitem>
 390         </varlistentry>
 391
 392         <varlistentry>
 393           <term><option>+[no]search</option></term>
 394           <listitem>
 395             <para>
 396               Use [do not use] the search list defined by the searchlist or
 397               domain
 398               directive in <filename>resolv.conf</filename> (if
 399               any).
 400               The search list is not used by default.
 401             </para>
 402           </listitem>
 403         </varlistentry>
 404
 405         <varlistentry>
 406           <term><option>+[no]showsearch</option></term>
 407           <listitem>
 408             <para>
 409               Perform [do not perform] a search showing intermediate
 410               results.
 411             </para>
 412           </listitem>
 413         </varlistentry>
 414
 415         <varlistentry>
 416           <term><option>+[no]defname</option></term>
 417           <listitem>
 418             <para>
 419               Deprecated, treated as a synonym for <parameter>+[no]search</parameter>
 420             </para>
 421           </listitem>
 422         </varlistentry>
 423
 424         <varlistentry>
 425           <term><option>+[no]aaonly</option></term>
 426           <listitem>
 427             <para>
 428               Sets the "aa" flag in the query.
 429             </para>
 430           </listitem>
 431         </varlistentry>
 432
 433         <varlistentry>
 434           <term><option>+[no]aaflag</option></term>
 435           <listitem>
 436             <para>
 437               A synonym for <parameter>+[no]aaonly</parameter>.
 438             </para>
 439           </listitem>
 440         </varlistentry>
 441
 442         <varlistentry>
 443           <term><option>+[no]adflag</option></term>
 444           <listitem>
 445             <para>
 446               Set [do not set] the AD (authentic data) bit in the query.  The
 447               AD bit
 448               currently has a standard meaning only in responses, not in
 449               queries,
 450               but the ability to set the bit in the query is provided for
 451               completeness.
 452             </para>
 453           </listitem>
 454         </varlistentry>
 455
 456         <varlistentry>
 457           <term><option>+[no]cdflag</option></term>
 458           <listitem>
 459             <para>
 460               Set [do not set] the CD (checking disabled) bit in the query.
 461               This
 462               requests the server to not perform DNSSEC validation of
 463               responses.
 464             </para>
 465           </listitem>
 466         </varlistentry>
 467
 468         <varlistentry>
 469           <term><option>+[no]cl</option></term>
 470           <listitem>
 471             <para>
 472               Display [do not display] the CLASS when printing the record.
 473             </para>
 474           </listitem>
 475         </varlistentry>
 476
 477         <varlistentry>
 478           <term><option>+[no]ttlid</option></term>
 479           <listitem>
 480             <para>
 481               Display [do not display] the TTL when printing the record.
 482             </para>
 483           </listitem>
 484         </varlistentry>
 485
 486         <varlistentry>
 487           <term><option>+[no]recurse</option></term>
 488           <listitem>
 489             <para>
 490               Toggle the setting of the RD (recursion desired) bit in the
 491               query.
 492               This bit is set by default, which means <command>dig</command>
 493               normally sends recursive queries.  Recursion is automatically
 494               disabled
 495               when the <parameter>+nssearch</parameter> or
 496               <parameter>+trace</parameter> query options are
 497               used.
 498             </para>
 499           </listitem>
 500         </varlistentry>
 501
 502         <varlistentry>
 503           <term><option>+[no]nssearch</option></term>
 504           <listitem>
 505             <para>
 506               When this option is set, <command>dig</command>
 507               attempts to find the
 508               authoritative name servers for the zone containing the name
 509               being
 510               looked up and display the SOA record that each name server has
 511               for the
 512               zone.
 513             </para>
 514           </listitem>
 515         </varlistentry>
 516
 517         <varlistentry>
 518           <term><option>+[no]trace</option></term>
 519           <listitem>
 520             <para>
 521               Toggle tracing of the delegation path from the root name servers
 522               for
 523               the name being looked up.  Tracing is disabled by default.  When
 524               tracing is enabled, <command>dig</command> makes
 525               iterative queries to
 526               resolve the name being looked up.  It will follow referrals from
 527               the
 528               root servers, showing the answer from each server that was used
 529               to
 530               resolve the lookup.
 531             </para>
 532           </listitem>
 533         </varlistentry>
 534
 535         <varlistentry>
 536           <term><option>+[no]cmd</option></term>
 537           <listitem>
 538             <para>
 539               Toggles the printing of the initial comment in the output
 540               identifying
 541               the version of <command>dig</command> and the query
 542               options that have
 543               been applied.  This comment is printed by default.
 544             </para>
 545           </listitem>
 546         </varlistentry>
 547
 548         <varlistentry>
 549           <term><option>+[no]short</option></term>
 550           <listitem>
 551             <para>
 552               Provide a terse answer.  The default is to print the answer in a
 553               verbose form.
 554             </para>
 555           </listitem>
 556         </varlistentry>
 557
 558         <varlistentry>
 559           <term><option>+[no]identify</option></term>
 560           <listitem>
 561             <para>
 562               Show [or do not show] the IP address and port number that
 563               supplied the
 564               answer when the <parameter>+short</parameter> option
 565               is enabled.  If
 566               short form answers are requested, the default is not to show the
 567               source address and port number of the server that provided the
 568               answer.
 569             </para>
 570           </listitem>
 571         </varlistentry>
 572
 573         <varlistentry>
 574           <term><option>+[no]comments</option></term>
 575           <listitem>
 576             <para>
 577               Toggle the display of comment lines in the output.  The default
 578               is to
 579               print comments.
 580             </para>
 581           </listitem>
 582         </varlistentry>
 583
 584         <varlistentry>
 585           <term><option>+[no]stats</option></term>
 586           <listitem>
 587             <para>
 588               This query option toggles the printing of statistics: when the
 589               query
 590               was made, the size of the reply and so on.  The default
 591               behavior is
 592               to print the query statistics.
 593             </para>
 594           </listitem>
 595         </varlistentry>
 596
 597         <varlistentry>
 598           <term><option>+[no]qr</option></term>
 599           <listitem>
 600             <para>
 601               Print [do not print] the query as it is sent.
 602               By default, the query is not printed.
 603             </para>
 604           </listitem>
 605         </varlistentry>
 606
 607         <varlistentry>
 608           <term><option>+[no]question</option></term>
 609           <listitem>
 610             <para>
 611               Print [do not print] the question section of a query when an
 612               answer is
 613               returned.  The default is to print the question section as a
 614               comment.
 615             </para>
 616           </listitem>
 617         </varlistentry>
 618
 619         <varlistentry>
 620           <term><option>+[no]answer</option></term>
 621           <listitem>
 622             <para>
 623               Display [do not display] the answer section of a reply.  The
 624               default
 625               is to display it.
 626             </para>
 627           </listitem>
 628         </varlistentry>
 629
 630         <varlistentry>
 631           <term><option>+[no]authority</option></term>
 632           <listitem>
 633             <para>
 634               Display [do not display] the authority section of a reply.  The
 635               default is to display it.
 636             </para>
 637           </listitem>
 638         </varlistentry>
 639
 640         <varlistentry>
 641           <term><option>+[no]additional</option></term>
 642           <listitem>
 643             <para>
 644               Display [do not display] the additional section of a reply.
 645               The default is to display it.
 646             </para>
 647           </listitem>
 648         </varlistentry>
 649
 650         <varlistentry>
 651           <term><option>+[no]all</option></term>
 652           <listitem>
 653             <para>
 654               Set or clear all display flags.
 655             </para>
 656           </listitem>
 657         </varlistentry>
 658
 659         <varlistentry>
 660           <term><option>+time=T</option></term>
 661           <listitem>
 662             <para>
 663
 664               Sets the timeout for a query to
 665               <parameter>T</parameter> seconds.  The default
 666               timeout is 5 seconds.
 667               An attempt to set <parameter>T</parameter> to less
 668               than 1 will result
 669               in a query timeout of 1 second being applied.
 670             </para>
 671           </listitem>
 672         </varlistentry>
 673
 674         <varlistentry>
 675           <term><option>+tries=T</option></term>
 676           <listitem>
 677             <para>
 678               Sets the number of times to try UDP queries to server to
 679               <parameter>T</parameter> instead of the default, 3.
 680               If
 681               <parameter>T</parameter> is less than or equal to
 682               zero, the number of
 683               tries is silently rounded up to 1.
 684             </para>
 685           </listitem>
 686         </varlistentry>
 687
 688         <varlistentry>
 689           <term><option>+retry=T</option></term>
 690           <listitem>
 691             <para>
 692               Sets the number of times to retry UDP queries to server to
 693               <parameter>T</parameter> instead of the default, 2.
 694               Unlike
 695               <parameter>+tries</parameter>, this does not include
 696               the initial
 697               query.
 698             </para>
 699           </listitem>
 700         </varlistentry>
 701
 702         <varlistentry>
 703           <term><option>+ndots=D</option></term>
 704           <listitem>
 705             <para>
 706               Set the number of dots that have to appear in
 707               <parameter>name</parameter> to <parameter>D</parameter> for it to be
 708               considered absolute.  The default value is that defined using
 709               the
 710               ndots statement in <filename>/etc/resolv.conf</filename>, or 1 if no
 711               ndots statement is present.  Names with fewer dots are
 712               interpreted as
 713               relative names and will be searched for in the domains listed in
 714               the
 715               <option>search</option> or <option>domain</option> directive in
 716               <filename>/etc/resolv.conf</filename>.
 717             </para>
 718           </listitem>
 719         </varlistentry>
 720
 721         <varlistentry>
 722           <term><option>+bufsize=B</option></term>
 723           <listitem>
 724             <para>
 725               Set the UDP message buffer size advertised using EDNS0 to
 726               <parameter>B</parameter> bytes.  The maximum and minimum sizes
 727               of this buffer are 65535 and 0 respectively.  Values outside
 728               this range are rounded up or down appropriately.
 729               Values other than zero will cause a EDNS query to be sent.
 730             </para>
 731           </listitem>
 732         </varlistentry>
 733
 734         <varlistentry>
 735           <term><option>+edns=#</option></term>
 736           <listitem>
 737             <para>
 738                Specify the EDNS version to query with.  Valid values
 739                are 0 to 255.  Setting the EDNS version will cause a
 740                EDNS query to be sent.  <option>+noedns</option> clears the
 741                remembered EDNS version.
 742             </para>
 743           </listitem>
 744         </varlistentry>
 745
 746         <varlistentry>
 747           <term><option>+[no]multiline</option></term>
 748           <listitem>
 749             <para>
 750               Print records like the SOA records in a verbose multi-line
 751               format with human-readable comments.  The default is to print
 752               each record on a single line, to facilitate machine parsing
 753               of the <command>dig</command> output.
 754             </para>
 755           </listitem>
 756         </varlistentry>
 757
 758         <varlistentry>
 759           <term><option>+[no]fail</option></term>
 760           <listitem>
 761             <para>
 762               Do not try the next server if you receive a SERVFAIL.  The
 763               default is
 764               to not try the next server which is the reverse of normal stub
 765               resolver
 766               behavior.
 767             </para>
 768           </listitem>
 769         </varlistentry>
 770
 771         <varlistentry>
 772           <term><option>+[no]besteffort</option></term>
 773           <listitem>
 774             <para>
 775               Attempt to display the contents of messages which are malformed.
 776               The default is to not display malformed answers.
 777             </para>
 778           </listitem>
 779         </varlistentry>
 780
 781         <varlistentry>
 782           <term><option>+[no]dnssec</option></term>
 783           <listitem>
 784             <para>
 785               Requests DNSSEC records be sent by setting the DNSSEC OK bit
 786               (DO)
 787               in the OPT record in the additional section of the query.
 788             </para>
 789           </listitem>
 790         </varlistentry>
 791
 792         <varlistentry>
 793           <term><option>+[no]sigchase</option></term>
 794           <listitem>
 795             <para>
 796               Chase DNSSEC signature chains.  Requires dig be compiled with
 797               -DDIG_SIGCHASE.
 798             </para>
 799           </listitem>
 800         </varlistentry>
 801
 802         <varlistentry>
 803           <term><option>+trusted-key=####</option></term>
 804           <listitem>
 805             <para>
 806               Specifies a file containing trusted keys to be used with
 807               <option>+sigchase</option>.  Each DNSKEY record must be
 808               on its own line.
 809             </para>
 810             <para>
 811               If not specified <command>dig</command> will look for
 812               <filename>/etc/trusted-key.key</filename> then
 813               <filename>trusted-key.key</filename> in the current directory.
 814             </para>
 815             <para>
 816               Requires dig be compiled with -DDIG_SIGCHASE.
 817             </para>
 818           </listitem>
 819         </varlistentry>
 820
 821         <varlistentry>
 822           <term><option>+[no]topdown</option></term>
 823           <listitem>
 824             <para>
 825               When chasing DNSSEC signature chains perform a top-down
 826               validation.
 827               Requires dig be compiled with -DDIG_SIGCHASE.
 828             </para>
 829           </listitem>
 830         </varlistentry>
 831
 832
 833
 834       </variablelist>
 835
 836     </para>
 837   </refsect1>
 838
 839   <refsect1>
 840     <title>MULTIPLE QUERIES</title>
 841
 842     <para>
 843       The BIND 9 implementation of <command>dig </command>
 844       supports
 845       specifying multiple queries on the command line (in addition to
 846       supporting the <option>-f</option> batch file option).  Each of those
 847       queries can be supplied with its own set of flags, options and query
 848       options.
 849     </para>
 850
 851     <para>
 852       In this case, each <parameter>query</parameter> argument
 853       represent an
 854       individual query in the command-line syntax described above.  Each
 855       consists of any of the standard options and flags, the name to be
 856       looked up, an optional query type and class and any query options that
 857       should be applied to that query.
 858     </para>
 859
 860     <para>
 861       A global set of query options, which should be applied to all queries,
 862       can also be supplied.  These global query options must precede the
 863       first tuple of name, class, type, options, flags, and query options
 864       supplied on the command line.  Any global query options (except
 865       the <option>+[no]cmd</option> option) can be
 866       overridden by a query-specific set of query options.  For example:
 867       <programlisting>
 868 dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
 869 </programlisting>
 870       shows how <command>dig</command> could be used from the
 871       command line
 872       to make three lookups: an ANY query for <literal>www.isc.org</literal>, a
 873       reverse lookup of 127.0.0.1 and a query for the NS records of
 874       <literal>isc.org</literal>.
 875
 876       A global query option of <parameter>+qr</parameter> is
 877       applied, so
 878       that <command>dig</command> shows the initial query it made
 879       for each
 880       lookup.  The final query has a local query option of
 881       <parameter>+noqr</parameter> which means that <command>dig</command>
 882       will not print the initial query when it looks up the NS records for
 883       <literal>isc.org</literal>.
 884     </para>
 885
 886   </refsect1>
 887
 888   <refsect1>
 889     <title>IDN SUPPORT</title>
 890     <para>
 891       If <command>dig</command> has been built with IDN (internationalized
 892       domain name) support, it can accept and display non-ASCII domain names.
 893       <command>dig</command> appropriately converts character encoding of
 894       domain name before sending a request to DNS server or displaying a
 895       reply from the server.
 896       If you'd like to turn off the IDN support for some reason, defines
 897       the <envar>IDN_DISABLE</envar> environment variable.
 898       The IDN support is disabled if the variable is set when
 899       <command>dig</command> runs.
 900     </para>
 901   </refsect1>
 902
 903   <refsect1>
 904     <title>FILES</title>
 905     <para><filename>/etc/resolv.conf</filename>
 906     </para>
 907     <para><filename>${HOME}/.digrc</filename>
 908     </para>
 909   </refsect1>
 910
 911   <refsect1>
 912     <title>SEE ALSO</title>
 913     <para><citerefentry>
 914         <refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
 915       </citerefentry>,
 916       <citerefentry>
 917         <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
 918       </citerefentry>,
 919       <citerefentry>
 920         <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
 921       </citerefentry>,
 922       <citetitle>RFC1035</citetitle>.
 923     </para>
 924   </refsect1>
 925
 926   <refsect1>
 927     <title>BUGS</title>
 928     <para>
 929       There are probably too many query options.
 930     </para>
 931   </refsect1>
 932 </refentry><!--
 933  - Local variables:
 934  - mode: sgml
 935  - End:
 936 -->