~andreserl/ubuntu/lucid/bind9/bind9-apport-533601

« back to all changes in this revision

Viewing changes to bin/dig/dig.html

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2009-01-26 10:33:42 UTC
  • mfrom: (1.4.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20090126103342-zfv3z8v6jgci62tg
* New upstream patch release
  - supportable version of fix from 9.5.0.dfsg.P2-5.1
  - CVE-2009-0025:  Closes: #511936
  - 2475: Overly agressive cache entry removal.  Closes: #511768
  - other bug fixes worthy of patch-release inclusion

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15
15
 - PERFORMANCE OF THIS SOFTWARE.
16
16
-->
17
 
<!-- $Id: dig.html,v 1.41.150.2 2008/05/15 01:42:11 tbox Exp $ -->
 
17
<!-- $Id: dig.html,v 1.41.150.4 2008/10/14 01:40:21 tbox Exp $ -->
18
18
<html>
19
19
<head>
20
20
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
29
29
</div>
30
30
<div class="refsynopsisdiv">
31
31
<h2>Synopsis</h2>
32
 
<div class="cmdsynopsis"><p><code class="command">dig</code>  [@server] [<code class="option">-b <em class="replaceable"><code>address</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-k <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port#</code></em></code>] [<code class="option">-q <em class="replaceable"><code>name</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-x <em class="replaceable"><code>addr</code></em></code>] [<code class="option">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]name:key</code></em></code>] [<code class="option">-4</code>] [<code class="option">-6</code>] [name] [type] [class] [queryopt...]</p></div>
 
32
<div class="cmdsynopsis"><p><code class="command">dig</code>  [@server] [<code class="option">-b <em class="replaceable"><code>address</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-k <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-m</code>] [<code class="option">-p <em class="replaceable"><code>port#</code></em></code>] [<code class="option">-q <em class="replaceable"><code>name</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-x <em class="replaceable"><code>addr</code></em></code>] [<code class="option">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]name:key</code></em></code>] [<code class="option">-4</code>] [<code class="option">-6</code>] [name] [type] [class] [queryopt...]</p></div>
33
33
<div class="cmdsynopsis"><p><code class="command">dig</code>  [<code class="option">-h</code>]</p></div>
34
34
<div class="cmdsynopsis"><p><code class="command">dig</code>  [global-queryopt...] [query...]</p></div>
35
35
</div>
36
36
<div class="refsect1" lang="en">
37
 
<a name="id2543511"></a><h2>DESCRIPTION</h2>
 
37
<a name="id2543515"></a><h2>DESCRIPTION</h2>
38
38
<p><span><strong class="command">dig</strong></span>
39
39
      (domain information groper) is a flexible tool
40
40
      for interrogating DNS name servers.  It performs DNS lookups and
62
62
      <code class="filename">/etc/resolv.conf</code>.
63
63
    </p>
64
64
<p>
65
 
      When no command line arguments or options are given, will perform an
66
 
      NS query for "." (the root).
 
65
      When no command line arguments or options are given,
 
66
      <span><strong class="command">dig</strong></span> will perform an NS query for "." (the root).
67
67
    </p>
68
68
<p>
69
69
      It is possible to set per-user defaults for <span><strong class="command">dig</strong></span> via
74
74
<p>
75
75
      The IN and CH class names overlap with the IN and CH top level
76
76
      domains names.  Either use the <code class="option">-t</code> and
77
 
      <code class="option">-c</code> options to specify the type and class or
78
 
      use the <code class="option">-q</code> the specify the domain name or
 
77
      <code class="option">-c</code> options to specify the type and class, 
 
78
      use the <code class="option">-q</code> the specify the domain name, or
79
79
      use "IN." and "CH." when looking up these top level domains.
80
80
    </p>
81
81
</div>
82
82
<div class="refsect1" lang="en">
83
 
<a name="id2543580"></a><h2>SIMPLE USAGE</h2>
 
83
<a name="id2543589"></a><h2>SIMPLE USAGE</h2>
84
84
<p>
85
85
      A typical invocation of <span><strong class="command">dig</strong></span> looks like:
86
86
      </p>
126
126
    </p>
127
127
</div>
128
128
<div class="refsect1" lang="en">
129
 
<a name="id2543671"></a><h2>OPTIONS</h2>
 
129
<a name="id2543680"></a><h2>OPTIONS</h2>
130
130
<p>
131
131
      The <code class="option">-b</code> option sets the source IP address of the query
132
132
      to <em class="parameter"><code>address</code></em>.  This must be a valid
152
152
      <span><strong class="command">dig</strong></span> using the command-line interface.
153
153
    </p>
154
154
<p>
 
155
      The <code class="option">-m</code> option enables memory usage debugging.
 
156
      
 
157
    </p>
 
158
<p>
155
159
      If a non-standard port number is to be queried, the
156
160
      <code class="option">-p</code> option is used.  <em class="parameter"><code>port#</code></em> is
157
161
      the port number that <span><strong class="command">dig</strong></span> will send its
226
230
    </p>
227
231
</div>
228
232
<div class="refsect1" lang="en">
229
 
<a name="id2543942"></a><h2>QUERY OPTIONS</h2>
 
233
<a name="id2544028"></a><h2>QUERY OPTIONS</h2>
230
234
<p><span><strong class="command">dig</strong></span>
231
235
      provides a number of query options which affect
232
236
      the way in which lookups are made and the results displayed.  Some of
549
553
    </p>
550
554
</div>
551
555
<div class="refsect1" lang="en">
552
 
<a name="id2545145"></a><h2>MULTIPLE QUERIES</h2>
 
556
<a name="id2545163"></a><h2>MULTIPLE QUERIES</h2>
553
557
<p>
554
558
      The BIND 9 implementation of <span><strong class="command">dig </strong></span>
555
559
      supports
595
599
    </p>
596
600
</div>
597
601
<div class="refsect1" lang="en">
598
 
<a name="id2545275"></a><h2>IDN SUPPORT</h2>
 
602
<a name="id2545225"></a><h2>IDN SUPPORT</h2>
599
603
<p>
600
604
      If <span><strong class="command">dig</strong></span> has been built with IDN (internationalized
601
605
      domain name) support, it can accept and display non-ASCII domain names.
609
613
    </p>
610
614
</div>
611
615
<div class="refsect1" lang="en">
612
 
<a name="id2545298"></a><h2>FILES</h2>
 
616
<a name="id2545248"></a><h2>FILES</h2>
613
617
<p><code class="filename">/etc/resolv.conf</code>
614
618
    </p>
615
619
<p><code class="filename">${HOME}/.digrc</code>
616
620
    </p>
617
621
</div>
618
622
<div class="refsect1" lang="en">
619
 
<a name="id2545315"></a><h2>SEE ALSO</h2>
 
623
<a name="id2545333"></a><h2>SEE ALSO</h2>
620
624
<p><span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>,
621
625
      <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
622
626
      <span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>,
624
628
    </p>
625
629
</div>
626
630
<div class="refsect1" lang="en">
627
 
<a name="id2545352"></a><h2>BUGS</h2>
 
631
<a name="id2545370"></a><h2>BUGS</h2>
628
632
<p>
629
633
      There are probably too many query options.
630
634
    </p>