contrib/bind-9.2.4rc7/bin/dig/dig.html

   1 <!--
   2  - Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
   3  - Copyright (C) 2000, 2001, 2003  Internet Software Consortium.
   4  -
   5  - Permission to use, copy, modify, and distribute this software for any
   6  - purpose with or without fee is hereby granted, provided that the above
   7  - copyright notice and this permission notice appear in all copies.
   8  -
   9  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  - PERFORMANCE OF THIS SOFTWARE.
  16 -->
  17
  18 <!-- $Id: dig.html,v 1.6.2.5 2004/03/15 04:44:38 marka Exp $ -->
  19
  20 <HTML
  21 ><HEAD
  22 ><TITLE
  23 >dig</TITLE
  24 ><META
  25 NAME="GENERATOR"
  26 CONTENT="Modular DocBook HTML Stylesheet Version 1.73
  27 "></HEAD
  28 ><BODY
  29 CLASS="REFENTRY"
  30 BGCOLOR="#FFFFFF"
  31 TEXT="#000000"
  32 LINK="#0000FF"
  33 VLINK="#840084"
  34 ALINK="#0000FF"
  35 ><H1
  36 ><A
  37 NAME="AEN1"
  38 >dig</A
  39 ></H1
  40 ><DIV
  41 CLASS="REFNAMEDIV"
  42 ><A
  43 NAME="AEN8"
  44 ></A
  45 ><H2
  46 >Name</H2
  47 >dig&nbsp;--&nbsp;DNS lookup utility</DIV
  48 ><DIV
  49 CLASS="REFSYNOPSISDIV"
  50 ><A
  51 NAME="AEN11"
  52 ></A
  53 ><H2
  54 >Synopsis</H2
  55 ><P
  56 ><B
  57 CLASS="COMMAND"
  58 >dig</B
  59 >  [@server] [<TT
  60 CLASS="OPTION"
  61 >-b <TT
  62 CLASS="REPLACEABLE"
  63 ><I
  64 >address</I
  65 ></TT
  66 ></TT
  67 >] [<TT
  68 CLASS="OPTION"
  69 >-c <TT
  70 CLASS="REPLACEABLE"
  71 ><I
  72 >class</I
  73 ></TT
  74 ></TT
  75 >] [<TT
  76 CLASS="OPTION"
  77 >-f <TT
  78 CLASS="REPLACEABLE"
  79 ><I
  80 >filename</I
  81 ></TT
  82 ></TT
  83 >] [<TT
  84 CLASS="OPTION"
  85 >-k <TT
  86 CLASS="REPLACEABLE"
  87 ><I
  88 >filename</I
  89 ></TT
  90 ></TT
  91 >] [<TT
  92 CLASS="OPTION"
  93 >-p <TT
  94 CLASS="REPLACEABLE"
  95 ><I
  96 >port#</I
  97 ></TT
  98 ></TT
  99 >] [<TT
 100 CLASS="OPTION"
 101 >-t <TT
 102 CLASS="REPLACEABLE"
 103 ><I
 104 >type</I
 105 ></TT
 106 ></TT
 107 >] [<TT
 108 CLASS="OPTION"
 109 >-x <TT
 110 CLASS="REPLACEABLE"
 111 ><I
 112 >addr</I
 113 ></TT
 114 ></TT
 115 >] [<TT
 116 CLASS="OPTION"
 117 >-y <TT
 118 CLASS="REPLACEABLE"
 119 ><I
 120 >name:key</I
 121 ></TT
 122 ></TT
 123 >] [name] [type] [class] [queryopt...]</P
 124 ><P
 125 ><B
 126 CLASS="COMMAND"
 127 >dig</B
 128 >  [<TT
 129 CLASS="OPTION"
 130 >-h</TT
 131 >]</P
 132 ><P
 133 ><B
 134 CLASS="COMMAND"
 135 >dig</B
 136 >  [global-queryopt...] [query...]</P
 137 ></DIV
 138 ><DIV
 139 CLASS="REFSECT1"
 140 ><A
 141 NAME="AEN51"
 142 ></A
 143 ><H2
 144 >DESCRIPTION</H2
 145 ><P
 146 ><B
 147 CLASS="COMMAND"
 148 >dig</B
 149 > (domain information groper) is a flexible tool
 150 for interrogating DNS name servers.  It performs DNS lookups and
 151 displays the answers that are returned from the name server(s) that
 152 were queried.  Most DNS administrators use <B
 153 CLASS="COMMAND"
 154 >dig</B
 155 > to
 156 troubleshoot DNS problems because of its flexibility, ease of use and
 157 clarity of output.  Other lookup tools tend to have less functionality
 158 than <B
 159 CLASS="COMMAND"
 160 >dig</B
 161 >.</P
 162 ><P
 163 >Although <B
 164 CLASS="COMMAND"
 165 >dig</B
 166 > is normally used with command-line
 167 arguments, it also has a batch mode of operation for reading lookup
 168 requests from a file.  A brief summary of its command-line arguments
 169 and options is printed when the <TT
 170 CLASS="OPTION"
 171 >-h</TT
 172 > option is given.
 173 Unlike earlier versions, the BIND9 implementation of
 174 <B
 175 CLASS="COMMAND"
 176 >dig</B
 177 > allows multiple lookups to be issued from the
 178 command line.</P
 179 ><P
 180 >Unless it is told to query a specific name server,
 181 <B
 182 CLASS="COMMAND"
 183 >dig</B
 184 > will try each of the servers listed in
 185 <TT
 186 CLASS="FILENAME"
 187 >/etc/resolv.conf</TT
 188 >.</P
 189 ><P
 190 >When no command line arguments or options are given, will perform an
 191 NS query for "." (the root).</P
 192 ><P
 193 >It is possible to set per user defaults for <B
 194 CLASS="COMMAND"
 195 >dig</B
 196 > via
 197 <TT
 198 CLASS="FILENAME"
 199 >${HOME}/.digrc</TT
 200 >.  This file is read and any options in it
 201 are applied before the command line arguements.</P
 202 ></DIV
 203 ><DIV
 204 CLASS="REFSECT1"
 205 ><A
 206 NAME="AEN68"
 207 ></A
 208 ><H2
 209 >SIMPLE USAGE</H2
 210 ><P
 211 >A typical invocation of <B
 212 CLASS="COMMAND"
 213 >dig</B
 214 > looks like:
 215 <PRE
 216 CLASS="PROGRAMLISTING"
 217 > dig @server name type </PRE
 218 > where:
 219
 220 <P
 221 ></P
 222 ><DIV
 223 CLASS="VARIABLELIST"
 224 ><DL
 225 ><DT
 226 ><TT
 227 CLASS="CONSTANT"
 228 >server</TT
 229 ></DT
 230 ><DD
 231 ><P
 232 >is the name or IP address of the name server to query.  This can be an IPv4
 233 address in dotted-decimal notation or an IPv6
 234 address in colon-delimited notation.  When the supplied
 235 <TT
 236 CLASS="PARAMETER"
 237 ><I
 238 >server</I
 239 ></TT
 240 > argument is a hostname,
 241 <B
 242 CLASS="COMMAND"
 243 >dig</B
 244 > resolves that name before querying that name
 245 server.  If no <TT
 246 CLASS="PARAMETER"
 247 ><I
 248 >server</I
 249 ></TT
 250 > argument is provided,
 251 <B
 252 CLASS="COMMAND"
 253 >dig</B
 254 > consults <TT
 255 CLASS="FILENAME"
 256 >/etc/resolv.conf</TT
 257 >
 258 and queries the name servers listed there.  The reply from the name
 259 server that responds is displayed.</P
 260 ></DD
 261 ><DT
 262 ><TT
 263 CLASS="CONSTANT"
 264 >name</TT
 265 ></DT
 266 ><DD
 267 ><P
 268 >is the name of the resource record that is to be looked up.</P
 269 ></DD
 270 ><DT
 271 ><TT
 272 CLASS="CONSTANT"
 273 >type</TT
 274 ></DT
 275 ><DD
 276 ><P
 277 >indicates what type of query is required &mdash;
 278 ANY, A, MX, SIG, etc.
 279 <TT
 280 CLASS="PARAMETER"
 281 ><I
 282 >type</I
 283 ></TT
 284 > can be any valid query type.  If no
 285 <TT
 286 CLASS="PARAMETER"
 287 ><I
 288 >type</I
 289 ></TT
 290 > argument is supplied,
 291 <B
 292 CLASS="COMMAND"
 293 >dig</B
 294 > will perform a lookup for an A record.</P
 295 ></DD
 296 ></DL
 297 ></DIV
 298 ></P
 299 ></DIV
 300 ><DIV
 301 CLASS="REFSECT1"
 302 ><A
 303 NAME="AEN97"
 304 ></A
 305 ><H2
 306 >OPTIONS</H2
 307 ><P
 308 >The <TT
 309 CLASS="OPTION"
 310 >-b</TT
 311 > option sets the source IP address of the query
 312 to <TT
 313 CLASS="PARAMETER"
 314 ><I
 315 >address</I
 316 ></TT
 317 >.  This must be a valid address on
 318 one of the host's network interfaces.</P
 319 ><P
 320 >The default query class (IN for internet) is overridden by the
 321 <TT
 322 CLASS="OPTION"
 323 >-c</TT
 324 > option.  <TT
 325 CLASS="PARAMETER"
 326 ><I
 327 >class</I
 328 ></TT
 329 > is any valid
 330 class, such as HS for Hesiod records or CH for CHAOSNET records.</P
 331 ><P
 332 >The <TT
 333 CLASS="OPTION"
 334 >-f</TT
 335 > option makes <B
 336 CLASS="COMMAND"
 337 >dig </B
 338 > operate
 339 in batch mode by reading a list of lookup requests to process from the
 340 file <TT
 341 CLASS="PARAMETER"
 342 ><I
 343 >filename</I
 344 ></TT
 345 >.  The file contains a number of
 346 queries, one per line.  Each entry in the file should be organised in
 347 the same way they would be presented as queries to
 348 <B
 349 CLASS="COMMAND"
 350 >dig</B
 351 > using the command-line interface.</P
 352 ><P
 353 >If a non-standard port number is to be queried, the
 354 <TT
 355 CLASS="OPTION"
 356 >-p</TT
 357 > option is used.  <TT
 358 CLASS="PARAMETER"
 359 ><I
 360 >port#</I
 361 ></TT
 362 > is
 363 the port number that <B
 364 CLASS="COMMAND"
 365 >dig</B
 366 > will send its queries
 367 instead of the standard DNS port number 53.  This option would be used
 368 to test a name server that has been configured to listen for queries
 369 on a non-standard port number.</P
 370 ><P
 371 >The <TT
 372 CLASS="OPTION"
 373 >-t</TT
 374 > option sets the query type to
 375 <TT
 376 CLASS="PARAMETER"
 377 ><I
 378 >type</I
 379 ></TT
 380 >.  It can be any valid query type which is
 381 supported in BIND9.  The default query type "A", unless the
 382 <TT
 383 CLASS="OPTION"
 384 >-x</TT
 385 > option is supplied to indicate a reverse lookup.
 386 A zone transfer can be requested by specifying a type of AXFR.  When
 387 an incremental zone transfer (IXFR) is required,
 388 <TT
 389 CLASS="PARAMETER"
 390 ><I
 391 >type</I
 392 ></TT
 393 > is set to <TT
 394 CLASS="LITERAL"
 395 >ixfr=N</TT
 396 >.
 397 The incremental zone transfer will contain the changes made to the zone
 398 since the serial number in the zone's SOA record was
 399 <TT
 400 CLASS="PARAMETER"
 401 ><I
 402 >N</I
 403 ></TT
 404 >.</P
 405 ><P
 406 >Reverse lookups - mapping addresses to names - are simplified by the
 407 <TT
 408 CLASS="OPTION"
 409 >-x</TT
 410 > option.  <TT
 411 CLASS="PARAMETER"
 412 ><I
 413 >addr</I
 414 ></TT
 415 > is an IPv4
 416 address in dotted-decimal notation, or a colon-delimited IPv6 address.
 417 When this option is used, there is no need to provide the
 418 <TT
 419 CLASS="PARAMETER"
 420 ><I
 421 >name</I
 422 ></TT
 423 >, <TT
 424 CLASS="PARAMETER"
 425 ><I
 426 >class</I
 427 ></TT
 428 > and
 429 <TT
 430 CLASS="PARAMETER"
 431 ><I
 432 >type</I
 433 ></TT
 434 > arguments.  <B
 435 CLASS="COMMAND"
 436 >dig</B
 437 >
 438 automatically performs a lookup for a name like
 439 <TT
 440 CLASS="LITERAL"
 441 >11.12.13.10.in-addr.arpa</TT
 442 > and sets the query type and
 443 class to PTR and IN respectively.  By default, IPv6 addresses are
 444 looked up using the IP6.ARPA domain and binary labels as defined in
 445 RFC2874.  To use the older RFC1886 method using the IP6.INT domain and
 446 "nibble" labels, specify the <TT
 447 CLASS="OPTION"
 448 >-n</TT
 449 > (nibble) option.</P
 450 ><P
 451 >To sign the DNS queries sent by <B
 452 CLASS="COMMAND"
 453 >dig</B
 454 > and their
 455 responses using transaction signatures (TSIG), specify a TSIG key file
 456 using the <TT
 457 CLASS="OPTION"
 458 >-k</TT
 459 > option.  You can also specify the TSIG
 460 key itself on the command line using the <TT
 461 CLASS="OPTION"
 462 >-y</TT
 463 > option;
 464 <TT
 465 CLASS="PARAMETER"
 466 ><I
 467 >name</I
 468 ></TT
 469 > is the name of the TSIG key and
 470 <TT
 471 CLASS="PARAMETER"
 472 ><I
 473 >key</I
 474 ></TT
 475 > is the actual key.  The key is a base-64
 476 encoded string, typically generated by <SPAN
 477 CLASS="CITEREFENTRY"
 478 ><SPAN
 479 CLASS="REFENTRYTITLE"
 480 >dnssec-keygen</SPAN
 481 >(8)</SPAN
 482 >.
 483
 484 Caution should be taken when using the <TT
 485 CLASS="OPTION"
 486 >-y</TT
 487 > option on
 488 multi-user systems as the key can be visible in the output from
 489 <SPAN
 490 CLASS="CITEREFENTRY"
 491 ><SPAN
 492 CLASS="REFENTRYTITLE"
 493 >ps</SPAN
 494 >(1)</SPAN
 495 > or in the shell's history file.  When
 496 using TSIG authentication with <B
 497 CLASS="COMMAND"
 498 >dig</B
 499 >, the name
 500 server that is queried needs to know the key and algorithm that is
 501 being used.  In BIND, this is done by providing appropriate
 502 <B
 503 CLASS="COMMAND"
 504 >key</B
 505 > and <B
 506 CLASS="COMMAND"
 507 >server</B
 508 > statements in
 509 <TT
 510 CLASS="FILENAME"
 511 >named.conf</TT
 512 >.</P
 513 ></DIV
 514 ><DIV
 515 CLASS="REFSECT1"
 516 ><A
 517 NAME="AEN147"
 518 ></A
 519 ><H2
 520 >QUERY OPTIONS</H2
 521 ><P
 522 ><B
 523 CLASS="COMMAND"
 524 >dig</B
 525 > provides a number of query options which affect
 526 the way in which lookups are made and the results displayed.  Some of
 527 these set or reset flag bits in the query header, some determine which
 528 sections of the answer get printed, and others determine the timeout
 529 and retry strategies.</P
 530 ><P
 531 >Each query option is identified by a keyword preceded by a plus sign
 532 (<TT
 533 CLASS="LITERAL"
 534 >+</TT
 535 >).  Some keywords set or reset an option.  These may be preceded
 536 by the string <TT
 537 CLASS="LITERAL"
 538 >no</TT
 539 > to negate the meaning of that keyword.  Other
 540 keywords assign values to options like the timeout interval.  They
 541 have the form <TT
 542 CLASS="OPTION"
 543 >+keyword=value</TT
 544 >.
 545 The query options are:
 546
 547 <P
 548 ></P
 549 ><DIV
 550 CLASS="VARIABLELIST"
 551 ><DL
 552 ><DT
 553 ><TT
 554 CLASS="OPTION"
 555 >+[no]tcp</TT
 556 ></DT
 557 ><DD
 558 ><P
 559 >Use [do not use] TCP when querying name servers.  The default
 560 behaviour is to use UDP unless an AXFR or IXFR query is requested, in
 561 which case a TCP connection is used.</P
 562 ></DD
 563 ><DT
 564 ><TT
 565 CLASS="OPTION"
 566 >+[no]vc</TT
 567 ></DT
 568 ><DD
 569 ><P
 570 >Use [do not use] TCP when querying name servers.  This alternate
 571 syntax to <TT
 572 CLASS="PARAMETER"
 573 ><I
 574 >+[no]tcp</I
 575 ></TT
 576 > is provided for backwards
 577 compatibility.  The "vc" stands for "virtual circuit".</P
 578 ></DD
 579 ><DT
 580 ><TT
 581 CLASS="OPTION"
 582 >+[no]ignore</TT
 583 ></DT
 584 ><DD
 585 ><P
 586 >Ignore truncation in UDP responses instead of retrying with TCP.  By
 587 default, TCP retries are performed.</P
 588 ></DD
 589 ><DT
 590 ><TT
 591 CLASS="OPTION"
 592 >+domain=somename</TT
 593 ></DT
 594 ><DD
 595 ><P
 596 >Set the search list to contain the single domain
 597 <TT
 598 CLASS="PARAMETER"
 599 ><I
 600 >somename</I
 601 ></TT
 602 >, as if specified in a
 603 <B
 604 CLASS="COMMAND"
 605 >domain</B
 606 > directive in
 607 <TT
 608 CLASS="FILENAME"
 609 >/etc/resolv.conf</TT
 610 >, and enable search list
 611 processing as if the <TT
 612 CLASS="PARAMETER"
 613 ><I
 614 >+search</I
 615 ></TT
 616 > option were given.</P
 617 ></DD
 618 ><DT
 619 ><TT
 620 CLASS="OPTION"
 621 >+[no]search</TT
 622 ></DT
 623 ><DD
 624 ><P
 625 >Use [do not use] the search list defined by the searchlist or domain
 626 directive in <TT
 627 CLASS="FILENAME"
 628 >resolv.conf</TT
 629 > (if any).
 630 The search list is not used by default.</P
 631 ></DD
 632 ><DT
 633 ><TT
 634 CLASS="OPTION"
 635 >+[no]defname</TT
 636 ></DT
 637 ><DD
 638 ><P
 639 >Deprecated, treated as a synonym for <TT
 640 CLASS="PARAMETER"
 641 ><I
 642 >+[no]search</I
 643 ></TT
 644 ></P
 645 ></DD
 646 ><DT
 647 ><TT
 648 CLASS="OPTION"
 649 >+[no]aaonly</TT
 650 ></DT
 651 ><DD
 652 ><P
 653 >This option does nothing.  It is provided for compatibility with old
 654 versions of <B
 655 CLASS="COMMAND"
 656 >dig</B
 657 > where it set an unimplemented
 658 resolver flag.</P
 659 ></DD
 660 ><DT
 661 ><TT
 662 CLASS="OPTION"
 663 >+[no]adflag</TT
 664 ></DT
 665 ><DD
 666 ><P
 667 >Set [do not set] the AD (authentic data) bit in the query.  The AD bit
 668 currently has a standard meaning only in responses, not in queries,
 669 but the ability to set the bit in the query is provided for
 670 completeness.</P
 671 ></DD
 672 ><DT
 673 ><TT
 674 CLASS="OPTION"
 675 >+[no]cdflag</TT
 676 ></DT
 677 ><DD
 678 ><P
 679 >Set [do not set] the CD (checking disabled) bit in the query.  This
 680 requests the server to not perform DNSSEC validation of responses.</P
 681 ></DD
 682 ><DT
 683 ><TT
 684 CLASS="OPTION"
 685 >+[no]recurse</TT
 686 ></DT
 687 ><DD
 688 ><P
 689 >Toggle the setting of the RD (recursion desired) bit in the query.
 690 This bit is set by default, which means <B
 691 CLASS="COMMAND"
 692 >dig</B
 693 >
 694 normally sends recursive queries.  Recursion is automatically disabled
 695 when the <TT
 696 CLASS="PARAMETER"
 697 ><I
 698 >+nssearch</I
 699 ></TT
 700 > or
 701 <TT
 702 CLASS="PARAMETER"
 703 ><I
 704 >+trace</I
 705 ></TT
 706 > query options are used.</P
 707 ></DD
 708 ><DT
 709 ><TT
 710 CLASS="OPTION"
 711 >+[no]nssearch</TT
 712 ></DT
 713 ><DD
 714 ><P
 715 >When this option is set, <B
 716 CLASS="COMMAND"
 717 >dig</B
 718 > attempts to find the
 719 authoritative name servers for the zone containing the name being
 720 looked up and display the SOA record that each name server has for the
 721 zone.</P
 722 ></DD
 723 ><DT
 724 ><TT
 725 CLASS="OPTION"
 726 >+[no]trace</TT
 727 ></DT
 728 ><DD
 729 ><P
 730 >Toggle tracing of the delegation path from the root name servers for
 731 the name being looked up.  Tracing is disabled by default.  When
 732 tracing is enabled, <B
 733 CLASS="COMMAND"
 734 >dig</B
 735 > makes iterative queries to
 736 resolve the name being looked up.  It will follow referrals from the
 737 root servers, showing the answer from each server that was used to
 738 resolve the lookup.</P
 739 ></DD
 740 ><DT
 741 ><TT
 742 CLASS="OPTION"
 743 >+[no]cmd</TT
 744 ></DT
 745 ><DD
 746 ><P
 747 >toggles the printing of the initial comment in the output identifying
 748 the version of <B
 749 CLASS="COMMAND"
 750 >dig</B
 751 > and the query options that have
 752 been applied.  This comment is printed by default.</P
 753 ></DD
 754 ><DT
 755 ><TT
 756 CLASS="OPTION"
 757 >+[no]short</TT
 758 ></DT
 759 ><DD
 760 ><P
 761 >Provide a terse answer.  The default is to print the answer in a
 762 verbose form.</P
 763 ></DD
 764 ><DT
 765 ><TT
 766 CLASS="OPTION"
 767 >+[no]identify</TT
 768 ></DT
 769 ><DD
 770 ><P
 771 >Show [or do not show] the IP address and port number that supplied the
 772 answer when the <TT
 773 CLASS="PARAMETER"
 774 ><I
 775 >+short</I
 776 ></TT
 777 > option is enabled.  If
 778 short form answers are requested, the default is not to show the
 779 source address and port number of the server that provided the answer.</P
 780 ></DD
 781 ><DT
 782 ><TT
 783 CLASS="OPTION"
 784 >+[no]comments</TT
 785 ></DT
 786 ><DD
 787 ><P
 788 >Toggle the display of comment lines in the output.  The default is to
 789 print comments.</P
 790 ></DD
 791 ><DT
 792 ><TT
 793 CLASS="OPTION"
 794 >+[no]stats</TT
 795 ></DT
 796 ><DD
 797 ><P
 798 >This query option toggles the printing of statistics: when the query
 799 was made, the size of the reply and so on.  The default behaviour is
 800 to print the query statistics.</P
 801 ></DD
 802 ><DT
 803 ><TT
 804 CLASS="OPTION"
 805 >+[no]qr</TT
 806 ></DT
 807 ><DD
 808 ><P
 809 >Print [do not print] the query as it is sent.
 810 By default, the query is not printed.</P
 811 ></DD
 812 ><DT
 813 ><TT
 814 CLASS="OPTION"
 815 >+[no]question</TT
 816 ></DT
 817 ><DD
 818 ><P
 819 >Print [do not print] the question section of a query when an answer is
 820 returned.  The default is to print the question section as a comment.</P
 821 ></DD
 822 ><DT
 823 ><TT
 824 CLASS="OPTION"
 825 >+[no]answer</TT
 826 ></DT
 827 ><DD
 828 ><P
 829 >Display [do not display] the answer section of a reply.  The default
 830 is to display it.</P
 831 ></DD
 832 ><DT
 833 ><TT
 834 CLASS="OPTION"
 835 >+[no]authority</TT
 836 ></DT
 837 ><DD
 838 ><P
 839 >Display [do not display] the authority section of a reply.  The
 840 default is to display it.</P
 841 ></DD
 842 ><DT
 843 ><TT
 844 CLASS="OPTION"
 845 >+[no]additional</TT
 846 ></DT
 847 ><DD
 848 ><P
 849 >Display [do not display] the additional section of a reply.
 850 The default is to display it.</P
 851 ></DD
 852 ><DT
 853 ><TT
 854 CLASS="OPTION"
 855 >+[no]all</TT
 856 ></DT
 857 ><DD
 858 ><P
 859 >Set or clear all display flags.</P
 860 ></DD
 861 ><DT
 862 ><TT
 863 CLASS="OPTION"
 864 >+time=T</TT
 865 ></DT
 866 ><DD
 867 ><P
 868 >&#13;Sets the timeout for a query to
 869 <TT
 870 CLASS="PARAMETER"
 871 ><I
 872 >T</I
 873 ></TT
 874 > seconds.  The default time out is 5 seconds.
 875 An attempt to set <TT
 876 CLASS="PARAMETER"
 877 ><I
 878 >T</I
 879 ></TT
 880 > to less than 1 will result
 881 in a query timeout of 1 second being applied.</P
 882 ></DD
 883 ><DT
 884 ><TT
 885 CLASS="OPTION"
 886 >+tries=T</TT
 887 ></DT
 888 ><DD
 889 ><P
 890 >Sets the number of times to retry UDP queries to server to
 891 <TT
 892 CLASS="PARAMETER"
 893 ><I
 894 >T</I
 895 ></TT
 896 > instead of the default, 3.  If
 897 <TT
 898 CLASS="PARAMETER"
 899 ><I
 900 >T</I
 901 ></TT
 902 > is less than or equal to zero, the number of
 903 retries is silently rounded up to 1.</P
 904 ></DD
 905 ><DT
 906 ><TT
 907 CLASS="OPTION"
 908 >+ndots=D</TT
 909 ></DT
 910 ><DD
 911 ><P
 912 >Set the number of dots that have to appear in
 913 <TT
 914 CLASS="PARAMETER"
 915 ><I
 916 >name</I
 917 ></TT
 918 > to <TT
 919 CLASS="PARAMETER"
 920 ><I
 921 >D</I
 922 ></TT
 923 > for it to be
 924 considered absolute.  The default value is that defined using the
 925 ndots statement in <TT
 926 CLASS="FILENAME"
 927 >/etc/resolv.conf</TT
 928 >, or 1 if no
 929 ndots statement is present.  Names with fewer dots are interpreted as
 930 relative names and will be searched for in the domains listed in the
 931 <TT
 932 CLASS="OPTION"
 933 >search</TT
 934 > or <TT
 935 CLASS="OPTION"
 936 >domain</TT
 937 > directive in
 938 <TT
 939 CLASS="FILENAME"
 940 >/etc/resolv.conf</TT
 941 >.</P
 942 ></DD
 943 ><DT
 944 ><TT
 945 CLASS="OPTION"
 946 >+bufsize=B</TT
 947 ></DT
 948 ><DD
 949 ><P
 950 >Set the UDP message buffer size advertised using EDNS0 to
 951 <TT
 952 CLASS="PARAMETER"
 953 ><I
 954 >B</I
 955 ></TT
 956 > bytes.  The maximum and minimum sizes of this
 957 buffer are 65535 and 0 respectively.  Values outside this range are
 958 rounded up or down appropriately.</P
 959 ></DD
 960 ><DT
 961 ><TT
 962 CLASS="OPTION"
 963 >+[no]multiline</TT
 964 ></DT
 965 ><DD
 966 ><P
 967 >Print records like the SOA records in a verbose multi-line
 968 format with human-readable comments.  The default is to print
 969 each record on a single line, to facilitate machine parsing
 970 of the <B
 971 CLASS="COMMAND"
 972 >dig</B
 973 > output.</P
 974 ></DD
 975 ><DT
 976 ><TT
 977 CLASS="OPTION"
 978 >+[no]fail</TT
 979 ></DT
 980 ><DD
 981 ><P
 982 >Do not try the next server if you receive a SERVFAIL.  The default is
 983 to not try the next server which is the reverse of normal stub resolver
 984 behaviour.</P
 985 ></DD
 986 ><DT
 987 ><TT
 988 CLASS="OPTION"
 989 >+[no]besteffort</TT
 990 ></DT
 991 ><DD
 992 ><P
 993 >Attempt to display the contents of messages which are malformed.
 994 The default is to not display malformed answers.</P
 995 ></DD
 996 ><DT
 997 ><TT
 998 CLASS="OPTION"
 999 >+[no]dnssec</TT
1000 ></DT
1001 ><DD
1002 ><P
1003 >Requests DNSSEC records be sent by setting the DNSSEC OK bit (DO)
1004 in the OPT record in the additional section of the query.</P
1005 ></DD
1006 ></DL
1007 ></DIV
1008 >&#13;</P
1009 ></DIV
1010 ><DIV
1011 CLASS="REFSECT1"
1012 ><A
1013 NAME="AEN338"
1014 ></A
1015 ><H2
1016 >MULTIPLE QUERIES</H2
1017 ><P
1018 >The BIND 9 implementation of <B
1019 CLASS="COMMAND"
1020 >dig </B
1021 > supports
1022 specifying multiple queries on the command line (in addition to
1023 supporting the <TT
1024 CLASS="OPTION"
1025 >-f</TT
1026 > batch file option).  Each of those
1027 queries can be supplied with its own set of flags, options and query
1028 options.</P
1029 ><P
1030 >In this case, each <TT
1031 CLASS="PARAMETER"
1032 ><I
1033 >query</I
1034 ></TT
1035 > argument represent an
1036 individual query in the command-line syntax described above.  Each
1037 consists of any of the standard options and flags, the name to be
1038 looked up, an optional query type and class and any query options that
1039 should be applied to that query.</P
1040 ><P
1041 >A global set of query options, which should be applied to all queries,
1042 can also be supplied.  These global query options must precede the
1043 first tuple of name, class, type, options, flags, and query options
1044 supplied on the command line.  Any global query options (except
1045 the <TT
1046 CLASS="OPTION"
1047 >+[no]cmd</TT
1048 > option) can be
1049 overridden by a query-specific set of query options.  For example:
1050 <PRE
1051 CLASS="PROGRAMLISTING"
1052 >dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr</PRE
1053 >
1054 shows how <B
1055 CLASS="COMMAND"
1056 >dig</B
1057 > could be used from the command line
1058 to make three lookups: an ANY query for <TT
1059 CLASS="LITERAL"
1060 >www.isc.org</TT
1061 >, a
1062 reverse lookup of 127.0.0.1 and a query for the NS records of
1063 <TT
1064 CLASS="LITERAL"
1065 >isc.org</TT
1066 >.
1067
1068 A global query option of <TT
1069 CLASS="PARAMETER"
1070 ><I
1071 >+qr</I
1072 ></TT
1073 > is applied, so
1074 that <B
1075 CLASS="COMMAND"
1076 >dig</B
1077 > shows the initial query it made for each
1078 lookup.  The final query has a local query option of
1079 <TT
1080 CLASS="PARAMETER"
1081 ><I
1082 >+noqr</I
1083 ></TT
1084 > which means that <B
1085 CLASS="COMMAND"
1086 >dig</B
1087 >
1088 will not print the initial query when it looks up the NS records for
1089 <TT
1090 CLASS="LITERAL"
1091 >isc.org</TT
1092 >.</P
1093 ></DIV
1094 ><DIV
1095 CLASS="REFSECT1"
1096 ><A
1097 NAME="AEN356"
1098 ></A
1099 ><H2
1100 >FILES</H2
1101 ><P
1102 ><TT
1103 CLASS="FILENAME"
1104 >/etc/resolv.conf</TT
1105 ></P
1106 ><P
1107 ><TT
1108 CLASS="FILENAME"
1109 >${HOME}/.digrc</TT
1110 ></P
1111 ></DIV
1112 ><DIV
1113 CLASS="REFSECT1"
1114 ><A
1115 NAME="AEN362"
1116 ></A
1117 ><H2
1118 >SEE ALSO</H2
1119 ><P
1120 ><SPAN
1121 CLASS="CITEREFENTRY"
1122 ><SPAN
1123 CLASS="REFENTRYTITLE"
1124 >host</SPAN
1125 >(1)</SPAN
1126 >,
1127 <SPAN
1128 CLASS="CITEREFENTRY"
1129 ><SPAN
1130 CLASS="REFENTRYTITLE"
1131 >named</SPAN
1132 >(8)</SPAN
1133 >,
1134 <SPAN
1135 CLASS="CITEREFENTRY"
1136 ><SPAN
1137 CLASS="REFENTRYTITLE"
1138 >dnssec-keygen</SPAN
1139 >(8)</SPAN
1140 >,
1141 <I
1142 CLASS="CITETITLE"
1143 >RFC1035</I
1144 >.</P
1145 ></DIV
1146 ><DIV
1147 CLASS="REFSECT1"
1148 ><A
1149 NAME="AEN375"
1150 ></A
1151 ><H2
1152 >BUGS </H2
1153 ><P
1154 >There are probably too many query options. </P
1155 ></DIV
1156 ></BODY
1157 ></HTML
1158 >