← Back to branch summary

~ubuntu-branches/ubuntu/maverick/bind9/maverick

« back to all changes in this revision

Viewing changes to bin/dig/host.docbook

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2005-04-19 10:21:58 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050419102158-kp20cp1bqf4ivpzy
Tags: 1:9.3.1-2ubuntu1
resync with debian

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/dig/host.docbook
1
1
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
2
2
<!--
3
3
 - Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
4
 
 - Copyright (C) 2000, 2001, 2003  Internet Software Consortium.
 
4
 - Copyright (C) 2000-2002  Internet Software Consortium.
5
5
 -
6
6
 - Permission to use, copy, modify, and distribute this software for any
7
7
 - purpose with or without fee is hereby granted, provided that the above
16
16
 - PERFORMANCE OF THIS SOFTWARE.
17
17
-->
18
18
 
19
 
<!-- $Id: host.docbook,v 1.2.2.3 2004/03/09 06:09:13 marka Exp $ -->
 
19
<!-- $Id: host.docbook,v 1.2.2.2.4.5 2004/04/13 01:26:26 marka Exp $ -->
20
20
 
21
21
<refentry>
22
22
 
44
44
  <arg><option>-R <replaceable class="parameter">number</replaceable></option></arg>
45
45
  <arg><option>-t <replaceable class="parameter">type</replaceable></option></arg>
46
46
  <arg><option>-W <replaceable class="parameter">wait</replaceable></option></arg>
 
47
  <arg><option>-4</option></arg>
 
48
  <arg><option>-6</option></arg>
47
49
  <arg choice=req>name</arg>
48
50
  <arg choice=opt>server</arg>
49
51
</cmdsynopsis>
103
105
<para>
104
106
List mode is selected by the <option>-l</option> option.  This makes
105
107
<command>host</command> perform a zone transfer for zone
106
 
<parameter>name</parameter>.  The argument is provided for
107
 
compatibility with older implementations.  This option is equivalent
108
 
to making a query of type AXFR.
 
108
<parameter>name</parameter>.  Transfer the zone printing out the NS, PTR
 
109
and address records (A/AAAA).  If combined with <option>-a</option>
 
110
all records will be printed.  
109
111
</para>
110
112
 
111
113
<para>
112
 
The <option>-n</option>
 
114
The <option>-i</option>
113
115
option specifies that reverse lookups of IPv6 addresses should
114
 
use the IP6.INT domain and "nibble" labels as defined in RFC1886.
115
 
The default is to use IP6.ARPA and binary labels as defined in RFC2874.
 
116
use the IP6.INT domain as defined in RFC1886.
 
117
The default is to use IP6.ARPA.
116
118
</para>
117
119
 
118
120
<para>
155
157
</para>
156
158
 
157
159
<para>
 
160
The <option>-4</option> option forces <command>host</command> to only
 
161
use IPv4 query transport.  The <option>-6</option> option forces
 
162
<command>host</command> to only use IPv6 query transport.
 
163
</para>
 
164
 
 
165
<para>
158
166
The <option>-t</option> option is used to select the query type.
159
167
<parameter>type</parameter> can be any recognised query type: CNAME,
160
168
NS, SOA, SIG, KEY, AXFR, etc.  When no query type is specified,
163
171
<option>-C</option> option was given, queries will be made for SOA
164
172
records, and if <parameter>name</parameter> is a dotted-decimal IPv4
165
173
address or colon-delimited IPv6 address, <command>host</command> will
166
 
query for PTR records.
 
174
query for PTR records.  If a query type of IXFR is chosen the starting
 
175
serial number can be specified by appending an equal followed by the
 
176
starting serial number (e.g. -t IXFR=12345678).
167
177
</para>
168
178
 
169
179
<para>