6/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.4.2.7.4.20 2007/08/28 07:19:07 tbox Exp $ -->
  22
  23 <refentry>
  24
  25 <refentryinfo>
  26 <date>Jun 30, 2000</date>
  27 </refentryinfo>
  28
  29 <refmeta>
  30 <refentrytitle>dig</refentrytitle>
  31 <manvolnum>1</manvolnum>
  32 <refmiscinfo>BIND9</refmiscinfo>
  33 </refmeta>
  34
  35   <docinfo>
  36     <copyright>
  37       <year>2004</year>
  38       <year>2005</year>
  39       <year>2006</year>
  40       <year>2007</year>
  41       <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
  42     </copyright>
  43     <copyright>
  44       <year>2000</year>
  45       <year>2001</year>
  46       <year>2002</year>
  47       <year>2003</year>
  48       <holder>Internet Software Consortium.</holder>
  49     </copyright>
  50   </docinfo>
  51
  52 <refnamediv>
  53 <refname>dig</refname>
  54 <refpurpose>DNS lookup utility</refpurpose>
  55 </refnamediv>
  56
  57 <refsynopsisdiv>
  58 <cmdsynopsis>
  59 <command>dig</command>
  60 <arg choice="opt">@server</arg>
  61 <arg><option>-b <replaceable class="parameter">address</replaceable></option></arg>
  62 <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
  63 <arg><option>-f <replaceable class="parameter">filename</replaceable></option></arg>
  64 <arg><option>-k <replaceable class="parameter">filename</replaceable></option></arg>
  65 <arg><option>-p <replaceable class="parameter">port#</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">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>
  92 <command>dig</command> (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 command-line
 103 arguments, it also has a batch mode of operation for reading lookup
 104 requests from a file.  A brief summary of its command-line arguments
 105 and options is printed when the <option>-h</option> option is given.
 106 Unlike earlier versions, the BIND 9 implementation of
 107 <command>dig</command> allows multiple lookups to be issued from the
 108 command line.
 109 </para>
 110
 111 <para>
 112 Unless it is told to query a specific name server,
 113 <command>dig</command> will try each of the servers listed in
 114 <filename>/etc/resolv.conf</filename>.
 115 </para>
 116
 117 <para>
 118 When no command line arguments or options are given, will perform an
 119 NS query for "." (the root).
 120 </para>
 121
 122 <para>
 123 It is possible to set per-user defaults for <command>dig</command> via
 124 <filename>${HOME}/.digrc</filename>.  This file is read and any options in it
 125 are applied before the command line arguments.
 126 </para>
 127
 128      <para>
 129        The IN and CH class names overlap with the IN and CH top level
 130        domains names.  Either use the <option>-t</option> and
 131        <option>-c</option> options to specify the type and class or
 132        use "IN." and "CH." when looking up these top level domains.
 133      </para>
 134
 135 </refsect1>
 136
 137 <refsect1>
 138 <title>SIMPLE USAGE</title>
 139
 140 <para>
 141 A typical invocation of <command>dig</command> looks like:
 142 <programlisting> dig @server name type </programlisting> where:
 143
 144 <variablelist>
 145
 146 <varlistentry><term><constant>server</constant></term>
 147 <listitem><para>
 148 is the name or IP address of the name server to query.  This can be an IPv4
 149 address in dotted-decimal notation or an IPv6
 150 address in colon-delimited notation.  When the supplied
 151 <parameter>server</parameter> argument is a hostname,
 152 <command>dig</command> resolves that name before querying that name
 153 server.  If no <parameter>server</parameter> argument is provided,
 154 <command>dig</command> consults <filename>/etc/resolv.conf</filename>
 155 and queries the name servers listed there.  The reply from the name
 156 server that responds is displayed.
 157 </para></listitem></varlistentry>
 158
 159 <varlistentry><term><constant>name</constant></term>
 160 <listitem><para>
 161 is the name of the resource record that is to be looked up.
 162 </para></listitem></varlistentry>
 163
 164 <varlistentry><term><constant>type</constant></term>
 165 <listitem><para>
 166 indicates what type of query is required &mdash;
 167 ANY, A, MX, SIG, etc.
 168 <parameter>type</parameter> can be any valid query type.  If no
 169 <parameter>type</parameter> argument is supplied,
 170 <command>dig</command> will perform a lookup for an A record.
 171 </para></listitem></varlistentry>
 172
 173 </variablelist>
 174 </para>
 175
 176 </refsect1>
 177
 178 <refsect1>
 179 <title>OPTIONS</title>
 180
 181 <para>
 182 The <option>-b</option> option sets the source IP address of the query
 183 to <parameter>address</parameter>.  This must be a valid address on
 184 one of the host's network interfaces or "0.0.0.0" or "::".  An optional port
 185 may be specified by appending "#&lt;port&gt;"
 186 </para>
 187
 188 <para>
 189 The default query class (IN for internet) is overridden by the
 190 <option>-c</option> option.  <parameter>class</parameter> is any valid
 191 class, such as HS for Hesiod records or CH for Chaosnet records.
 192 </para>
 193
 194 <para>
 195 The <option>-f</option> option makes <command>dig </command> operate
 196 in batch mode by reading a list of lookup requests to process from the
 197 file <parameter>filename</parameter>.  The file contains a number of
 198 queries, one per line.  Each entry in the file should be organized in
 199 the same way they would be presented as queries to
 200 <command>dig</command> using the command-line interface.
 201 </para>
 202
 203 <para>
 204 If a non-standard port number is to be queried, the
 205 <option>-p</option> option is used.  <parameter>port#</parameter> is
 206 the port number that <command>dig</command> will send its queries
 207 instead of the standard DNS port number 53.  This option would be used
 208 to test a name server that has been configured to listen for queries
 209 on a non-standard port number.
 210 </para>
 211
 212 <para>
 213 The <option>-4</option> option forces <command>dig</command> to only
 214 use IPv4 query transport.  The <option>-6</option> option forces
 215 <command>dig</command> to only use IPv6 query transport.
 216 </para>
 217
 218 <para>
 219 The <option>-t</option> option sets the query type to
 220 <parameter>type</parameter>.  It can be any valid query type which is
 221 supported in BIND 9.  The default query type is "A", unless the
 222 <option>-x</option> option is supplied to indicate a reverse lookup.
 223 A zone transfer can be requested by specifying a type of AXFR.  When
 224 an incremental zone transfer (IXFR) is required,
 225 <parameter>type</parameter> is set to <literal>ixfr=N</literal>.
 226 The incremental zone transfer will contain the changes made to the zone
 227 since the serial number in the zone's SOA record was
 228 <parameter>N</parameter>.
 229 </para>
 230
 231 <para>
 232 Reverse lookups &mdash; mapping addresses to names &mdash; are simplified by the
 233 <option>-x</option> option.  <parameter>addr</parameter> is an IPv4
 234 address in dotted-decimal notation, or a colon-delimited IPv6 address.
 235 When this option is used, there is no need to provide the
 236 <parameter>name</parameter>, <parameter>class</parameter> and
 237 <parameter>type</parameter> arguments.  <command>dig</command>
 238 automatically performs a lookup for a name like
 239 <literal>11.12.13.10.in-addr.arpa</literal> and sets the query type and
 240 class to PTR and IN respectively.  By default, IPv6 addresses are
 241 looked up using nibble format under the IP6.ARPA domain.
 242 To use the older RFC1886 method using the IP6.INT domain
 243 specify the <option>-i</option> option.  Bit string labels (RFC2874)
 244 are now experimental and are not attempted.
 245 </para>
 246
 247 <para>
 248 To sign the DNS queries sent by <command>dig</command> and their
 249 responses using transaction signatures (TSIG), specify a TSIG key file
 250 using the <option>-k</option> option.  You can also specify the TSIG
 251 key itself on the command line using the <option>-y</option> option;
 252 <parameter>name</parameter> is the name of the TSIG key and
 253 <parameter>key</parameter> is the actual key.  The key is a base-64
 254 encoded string, typically generated by <citerefentry>
 255 <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
 256 </citerefentry>.
 257
 258 Caution should be taken when using the <option>-y</option> option on
 259 multi-user systems as the key can be visible in the output from
 260 <citerefentry> <refentrytitle>ps</refentrytitle><manvolnum>1
 261 </manvolnum> </citerefentry> or in the shell's history file.  When
 262 using TSIG authentication with <command>dig</command>, the name
 263 server that is queried needs to know the key and algorithm that is
 264 being used.  In BIND, this is done by providing appropriate
 265 <command>key</command> and <command>server</command> statements in
 266 <filename>named.conf</filename>.
 267 </para>
 268
 269 </refsect1>
 270
 271 <refsect1>
 272 <title>QUERY OPTIONS</title>
 273
 274 <para>
 275 <command>dig</command> provides a number of query options which affect
 276 the way in which lookups are made and the results displayed.  Some of
 277 these set or reset flag bits in the query header, some determine which
 278 sections of the answer get printed, and others determine the timeout
 279 and retry strategies.
 280 </para>
 281
 282 <para>
 283 Each query option is identified by a keyword preceded by a plus sign
 284 (<literal>+</literal>).  Some keywords set or reset an option.  These may be preceded
 285 by the string <literal>no</literal> to negate the meaning of that keyword.  Other
 286 keywords assign values to options like the timeout interval.  They
 287 have the form <option>+keyword=value</option>.
 288 The query options are:
 289
 290 <variablelist>
 291
 292 <varlistentry><term><option>+[no]tcp</option></term>
 293 <listitem><para>
 294 Use [do not use] TCP when querying name servers.  The default
 295 behavior is to use UDP unless an AXFR or IXFR query is requested, in
 296 which case a TCP connection is used.
 297 </para></listitem></varlistentry>
 298
 299 <varlistentry><term><option>+[no]vc</option></term>
 300 <listitem><para>
 301 Use [do not use] TCP when querying name servers.  This alternate
 302 syntax to <parameter>+[no]tcp</parameter> is provided for backwards
 303 compatibility.  The "vc" stands for "virtual circuit".
 304 </para></listitem></varlistentry>
 305
 306 <varlistentry><term><option>+[no]ignore</option></term>
 307 <listitem><para>
 308 Ignore truncation in UDP responses instead of retrying with TCP.  By
 309 default, TCP retries are performed.
 310 </para></listitem></varlistentry>
 311
 312 <varlistentry><term><option>+domain=somename</option></term>
 313 <listitem><para>
 314 Set the search list to contain the single domain
 315 <parameter>somename</parameter>, as if specified in a
 316 <command>domain</command> directive in
 317 <filename>/etc/resolv.conf</filename>, and enable search list
 318 processing as if the <parameter>+search</parameter> option were given.
 319 </para></listitem></varlistentry>
 320
 321 <varlistentry><term><option>+[no]search</option></term>
 322 <listitem><para>
 323 Use [do not use] the search list defined by the searchlist or domain
 324 directive in <filename>resolv.conf</filename> (if any).
 325 The search list is not used by default.
 326 </para></listitem></varlistentry>
 327
 328 <varlistentry><term><option>+[no]defname</option></term>
 329 <listitem><para>
 330 Deprecated, treated as a synonym for <parameter>+[no]search</parameter>
 331 </para></listitem></varlistentry>
 332
 333 <varlistentry><term><option>+[no]aaonly</option></term>
 334 <listitem><para>
 335 Sets the "aa" flag in the query.
 336 </para></listitem></varlistentry>
 337
 338 <varlistentry><term><option>+[no]aaflag</option></term>
 339 <listitem><para>
 340 A synonym for <parameter>+[no]aaonly</parameter>.
 341 </para></listitem></varlistentry>
 342
 343 <varlistentry><term><option>+[no]adflag</option></term>
 344 <listitem><para>
 345 Set [do not set] the AD (authentic data) bit in the query.  The AD bit
 346 currently has a standard meaning only in responses, not in queries,
 347 but the ability to set the bit in the query is provided for
 348 completeness.
 349 </para></listitem></varlistentry>
 350
 351 <varlistentry><term><option>+[no]cdflag</option></term>
 352 <listitem><para>
 353 Set [do not set] the CD (checking disabled) bit in the query.  This
 354 requests the server to not perform DNSSEC validation of responses.
 355 </para></listitem></varlistentry>
 356
 357 <varlistentry><term><option>+[no]cl</option></term>
 358 <listitem><para>
 359 Display [do not display] the CLASS when printing the record.
 360 </para></listitem></varlistentry>
 361
 362 <varlistentry><term><option>+[no]ttlid</option></term>
 363 <listitem><para>
 364 Display [do not display] the TTL when printing the record.
 365 </para></listitem></varlistentry>
 366
 367 <varlistentry><term><option>+[no]recurse</option></term>
 368 <listitem><para>
 369 Toggle the setting of the RD (recursion desired) bit in the query.
 370 This bit is set by default, which means <command>dig</command>
 371 normally sends recursive queries.  Recursion is automatically disabled
 372 when the <parameter>+nssearch</parameter> or
 373 <parameter>+trace</parameter> query options are used.
 374 </para></listitem></varlistentry>
 375
 376 <varlistentry><term><option>+[no]nssearch</option></term>
 377 <listitem><para>
 378 When this option is set, <command>dig</command> attempts to find the
 379 authoritative name servers for the zone containing the name being
 380 looked up and display the SOA record that each name server has for the
 381 zone.
 382 </para></listitem></varlistentry>
 383
 384 <varlistentry><term><option>+[no]trace</option></term>
 385 <listitem><para>
 386 Toggle tracing of the delegation path from the root name servers for
 387 the name being looked up.  Tracing is disabled by default.  When
 388 tracing is enabled, <command>dig</command> makes iterative queries to
 389 resolve the name being looked up.  It will follow referrals from the
 390 root servers, showing the answer from each server that was used to
 391 resolve the lookup.
 392 </para></listitem></varlistentry>
 393
 394 <varlistentry><term><option>+[no]cmd</option></term>
 395 <listitem><para>
 396 Toggles the printing of the initial comment in the output identifying
 397 the version of <command>dig</command> and the query options that have
 398 been applied.  This comment is printed by default.
 399 </para></listitem></varlistentry>
 400
 401 <varlistentry><term><option>+[no]short</option></term>
 402 <listitem><para>
 403 Provide a terse answer.  The default is to print the answer in a
 404 verbose form.
 405 </para></listitem></varlistentry>
 406
 407 <varlistentry><term><option>+[no]identify</option></term>
 408 <listitem><para>
 409 Show [or do not show] the IP address and port number that supplied the
 410 answer when the <parameter>+short</parameter> option is enabled.  If
 411 short form answers are requested, the default is not to show the
 412 source address and port number of the server that provided the answer.
 413 </para></listitem></varlistentry>
 414
 415 <varlistentry><term><option>+[no]comments</option></term>
 416 <listitem><para>
 417 Toggle the display of comment lines in the output.  The default is to
 418 print comments.
 419 </para></listitem></varlistentry>
 420
 421 <varlistentry><term><option>+[no]stats</option></term>
 422 <listitem><para>
 423 This query option toggles the printing of statistics: when the query
 424 was made, the size of the reply and so on.  The default behavior is
 425 to print the query statistics.
 426 </para></listitem></varlistentry>
 427
 428 <varlistentry><term><option>+[no]qr</option></term>
 429 <listitem><para>
 430 Print [do not print] the query as it is sent.
 431 By default, the query is not printed.
 432 </para></listitem></varlistentry>
 433
 434 <varlistentry><term><option>+[no]question</option></term>
 435 <listitem><para>
 436 Print [do not print] the question section of a query when an answer is
 437 returned.  The default is to print the question section as a comment.
 438 </para></listitem></varlistentry>
 439
 440 <varlistentry><term><option>+[no]answer</option></term>
 441 <listitem><para>
 442 Display [do not display] the answer section of a reply.  The default
 443 is to display it.
 444 </para></listitem></varlistentry>
 445
 446 <varlistentry><term><option>+[no]authority</option></term>
 447 <listitem><para>
 448 Display [do not display] the authority section of a reply.  The
 449 default is to display it.
 450 </para></listitem></varlistentry>
 451
 452 <varlistentry><term><option>+[no]additional</option></term>
 453 <listitem><para>
 454 Display [do not display] the additional section of a reply.
 455 The default is to display it.
 456 </para></listitem></varlistentry>
 457
 458 <varlistentry><term><option>+[no]all</option></term>
 459 <listitem><para>
 460 Set or clear all display flags.
 461 </para></listitem></varlistentry>
 462
 463 <varlistentry><term><option>+time=T</option></term>
 464 <listitem><para>
 465
 466 Sets the timeout for a query to
 467 <parameter>T</parameter> seconds.  The default timeout is 5 seconds.
 468 An attempt to set <parameter>T</parameter> to less than 1 will result
 469 in a query timeout of 1 second being applied.
 470 </para></listitem></varlistentry>
 471
 472 <varlistentry><term><option>+tries=T</option></term>
 473 <listitem><para>
 474 Sets the number of times to try UDP queries to server to
 475 <parameter>T</parameter> instead of the default, 3.  If
 476 <parameter>T</parameter> is less than or equal to zero, the number of
 477 tries is silently rounded up to 1.
 478 </para></listitem></varlistentry>
 479
 480 <varlistentry><term><option>+retry=T</option></term>
 481 <listitem><para>
 482 Sets the number of times to retry UDP queries to server to
 483 <parameter>T</parameter> instead of the default, 2.  Unlike
 484 <parameter>+tries</parameter>, this does not include the initial
 485 query.
 486 </para></listitem></varlistentry>
 487
 488 <varlistentry><term><option>+ndots=D</option></term>
 489 <listitem><para>
 490 Set the number of dots that have to appear in
 491 <parameter>name</parameter> to <parameter>D</parameter> for it to be
 492 considered absolute.  The default value is that defined using the
 493 ndots statement in <filename>/etc/resolv.conf</filename>, or 1 if no
 494 ndots statement is present.  Names with fewer dots are interpreted as
 495 relative names and will be searched for in the domains listed in the
 496 <option>search</option> or <option>domain</option> directive in
 497 <filename>/etc/resolv.conf</filename>.
 498 </para></listitem></varlistentry>
 499
 500 <varlistentry><term><option>+bufsize=B</option></term>
 501 <listitem><para>
 502 Set the UDP message buffer size advertised using EDNS0 to
 503 <parameter>B</parameter> bytes.  The maximum and minimum sizes of this
 504 buffer are 65535 and 0 respectively.  Values outside this range are
 505 rounded up or down appropriately.
 506 </para>
 507 </listitem></varlistentry>
 508
 509 <varlistentry><term><option>+[no]multiline</option></term>
 510 <listitem><para>
 511 Print records like the SOA records in a verbose multi-line
 512 format with human-readable comments.  The default is to print
 513 each record on a single line, to facilitate machine parsing
 514 of the <command>dig</command> output.
 515 </para></listitem></varlistentry>
 516
 517 <varlistentry><term><option>+[no]fail</option></term>
 518 <listitem><para>
 519 Do not try the next server if you receive a SERVFAIL.  The default is
 520 to not try the next server which is the reverse of normal stub resolver
 521 behavior.
 522 </para></listitem></varlistentry>
 523
 524 <varlistentry><term><option>+[no]besteffort</option></term>
 525 <listitem><para>
 526 Attempt to display the contents of messages which are malformed.
 527 The default is to not display malformed answers.
 528 </para></listitem></varlistentry>
 529
 530 <varlistentry><term><option>+[no]dnssec</option></term>
 531 <listitem><para>
 532 Requests DNSSEC records be sent by setting the DNSSEC OK bit (DO)
 533 in the OPT record in the additional section of the query.
 534 </para></listitem></varlistentry>
 535
 536 <varlistentry><term><option>+[no]sigchase</option></term>
 537 <listitem><para>
 538 Chase DNSSEC signature chains.  Requires dig be compiled with
 539 -DDIG_SIGCHASE.
 540 </para></listitem></varlistentry>
 541
 542         <varlistentry>
 543           <term><option>+trusted-key=####</option></term>
 544           <listitem>
 545             <para>
 546               Specifies a file containing trusted keys to be used with
 547               <option>+sigchase</option>.  Each DNSKEY record must be
 548               on its own line.
 549             </para>
 550             <para>
 551               If not specified <command>dig</command> will look for
 552               <filename>/etc/trusted-key.key</filename> then
 553               <filename>trusted-key.key</filename> in the current directory.
 554             </para>
 555             <para>
 556               Requires dig be compiled with -DDIG_SIGCHASE.
 557             </para>
 558           </listitem>
 559         </varlistentry>
 560
 561 <varlistentry><term><option>+[no]topdown</option></term>
 562 <listitem><para>
 563 When chasing DNSSEC signature chains perform a top-down validation.
 564 Requires dig be compiled with -DDIG_SIGCHASE.
 565 </para></listitem></varlistentry>
 566
 567
 568
 569 </variablelist>
 570
 571 </para>
 572 </refsect1>
 573
 574 <refsect1>
 575 <title>MULTIPLE QUERIES</title>
 576
 577 <para>
 578 The BIND 9 implementation of <command>dig </command> supports
 579 specifying multiple queries on the command line (in addition to
 580 supporting the <option>-f</option> batch file option).  Each of those
 581 queries can be supplied with its own set of flags, options and query
 582 options.
 583 </para>
 584
 585 <para>
 586 In this case, each <parameter>query</parameter> argument represent an
 587 individual query in the command-line syntax described above.  Each
 588 consists of any of the standard options and flags, the name to be
 589 looked up, an optional query type and class and any query options that
 590 should be applied to that query.
 591 </para>
 592
 593 <para>
 594 A global set of query options, which should be applied to all queries,
 595 can also be supplied.  These global query options must precede the
 596 first tuple of name, class, type, options, flags, and query options
 597 supplied on the command line.  Any global query options (except
 598 the <option>+[no]cmd</option> option) can be
 599 overridden by a query-specific set of query options.  For example:
 600 <programlisting>
 601 dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
 602 </programlisting>
 603 shows how <command>dig</command> could be used from the command line
 604 to make three lookups: an ANY query for <literal>www.isc.org</literal>, a
 605 reverse lookup of 127.0.0.1 and a query for the NS records of
 606 <literal>isc.org</literal>.
 607
 608 A global query option of <parameter>+qr</parameter> is applied, so
 609 that <command>dig</command> shows the initial query it made for each
 610 lookup.  The final query has a local query option of
 611 <parameter>+noqr</parameter> which means that <command>dig</command>
 612 will not print the initial query when it looks up the NS records for
 613 <literal>isc.org</literal>.
 614 </para>
 615
 616 </refsect1>
 617
 618 <refsect1>
 619 <title>FILES</title>
 620 <para>
 621 <filename>/etc/resolv.conf</filename>
 622 </para>
 623 <para>
 624 <filename>${HOME}/.digrc</filename>
 625 </para>
 626 </refsect1>
 627
 628 <refsect1>
 629 <title>SEE ALSO</title>
 630 <para>
 631 <citerefentry>
 632 <refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
 633 </citerefentry>,
 634 <citerefentry>
 635 <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
 636 </citerefentry>,
 637 <citerefentry>
 638 <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
 639 </citerefentry>,
 640 <citetitle>RFC1035</citetitle>.
 641 </para>
 642 </refsect1>
 643
 644 <refsect1>
 645 <title>BUGS </title>
 646 <para>
 647 There are probably too many query options.
 648 </para>
 649 </refsect1>
 650 </refentry>