8N/A - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC") 8N/A - Copyright (C) 2000-2003 Internet Software Consortium. 8N/A - Permission to use, copy, modify, and/or distribute this software for any 8N/A - purpose with or without fee is hereby granted, provided that the above 8N/A - copyright notice and this permission notice appear in all copies. 8N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 8N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 8N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 8N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 8N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 8N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 8N/A - PERFORMANCE OF THIS SOFTWARE. 8N/A<
meta http-
equiv="Content-Type" content="text/html; charset=ISO-8859-1">
8N/A<
meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
8N/A<
link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
8N/A<
body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
749N/A<
table width="100%" summary="Navigation header">
771N/A<
tr><
th colspan="3" align="center">host</
th></
tr>
749N/A<
td width="20%" align="left">
783N/A<
th width="60%" align="center">Manual pages</
th>
8N/A<
div class="refentry" lang="en">
232N/A<
div class="refnamediv">
765N/A<
p>host — DNS lookup utility</
p>
765N/A<
div class="refsynopsisdiv">
765N/A<
div class="cmdsynopsis"><
p><
code class="command">host</
code> [<
code class="option">-aCdlnrsTwv</
code>] [<
code class="option">-c <
em class="replaceable"><
code>class</
code></
em></
code>] [<
code class="option">-N <
em class="replaceable"><
code>ndots</
code></
em></
code>] [<
code class="option">-R <
em class="replaceable"><
code>number</
code></
em></
code>] [<
code class="option">-t <
em class="replaceable"><
code>type</
code></
em></
code>] [<
code class="option">-W <
em class="replaceable"><
code>wait</
code></
em></
code>] [<
code class="option">-m <
em class="replaceable"><
code>flag</
code></
em></
code>] [<
code class="option">-4</
code>] [<
code class="option">-6</
code>] [<
code class="option">-v</
code>] [<
code class="option">-V</
code>] {name} [server]</
p></
div>
765N/A<
div class="refsect1" lang="en">
765N/A<
a name="id2617025"></
a><
h2>DESCRIPTION</
h2>
765N/A<
p><
span><
strong class="command">host</
strong></
span>
765N/A is a simple utility for performing DNS lookups.
765N/A It is normally used to convert names to IP addresses and vice versa.
765N/A When no arguments or options are given,
765N/A <
span><
strong class="command">host</
strong></
span>
765N/A prints a short summary of its command line arguments and options.
765N/A<
p><
em class="parameter"><
code>name</
code></
em> is the domain name that is to be
65N/A up. It can also be a dotted-decimal IPv4 address or a colon-delimited
771N/A IPv6 address, in which case <
span><
strong class="command">host</
strong></
span> will by
771N/A perform a reverse lookup for that address.
771N/A <
em class="parameter"><
code>server</
code></
em> is an optional argument which
771N/A the name or IP address of the name server that <
span><
strong class="command">host</
strong></
span>
771N/A should query instead of the server or servers listed in
771N/A The <
code class="option">-a</
code> (all) option is equivalent to setting the
771N/A <
code class="option">-v</
code> option and asking <
span><
strong class="command">host</
strong></
span> to make
771N/A When the <
code class="option">-C</
code> option is used, <
span><
strong class="command">host</
strong></
span>
771N/A will attempt to display the SOA records for zone
771N/A <
em class="parameter"><
code>name</
code></
em> from all the listed
771N/A servers for that zone. The list of name servers is defined by the NS
783N/A records that are found for the zone.
783N/A The <
code class="option">-c</
code> option instructs to make a DNS query of class
783N/A <
em class="parameter"><
code>class</
code></
em>. This can be used to lookup
783N/A Chaosnet class resource records. The default class is IN (Internet).
783N/A Verbose output is generated by <
span><
strong class="command">host</
strong></
span> when
783N/A <
code class="option">-d</
code> or <
code class="option">-v</
code> option is used. The two
783N/A options are equivalent. They have been provided for backwards
771N/A compatibility. In previous versions, the <
code class="option">-d</
code> option
771N/A switched on debugging traces and <
code class="option">-v</
code> enabled verbose
771N/A output. Verbose output can also be enabled by setting the
771N/A <
em class="parameter"><
code>debug</
code></
em> option in
771N/A List mode is selected by the <
code class="option">-l</
code> option. This makes
967N/A <
span><
strong class="command">host</
strong></
span> perform a zone transfer for zone
771N/A <
em class="parameter"><
code>name</
code></
em>. Transfer the zone printing out
967N/A and address records (
A/
AAAA). If combined with <
code class="option">-a</
code>
771N/A all records will be printed.
967N/A The <
code class="option">-i</
code>
967N/A option specifies that reverse lookups of IPv6 addresses should
967N/A The <
code class="option">-N</
code> option sets the number of dots that have to be
967N/A in <
em class="parameter"><
code>name</
code></
em> for it to be considered
967N/A default value is that defined using the ndots statement in
967N/A present. Names with fewer dots are interpreted as relative names and
967N/A will be searched for in the domains listed in the <
span class="type">search</
span>
967N/A or <
span class="type">domain</
span> directive in
967N/A The number of UDP retries for a lookup can be changed with the
967N/A <
code class="option">-R</
code> option. <
em class="parameter"><
code>number</
code></
em>
967N/A how many times <
span><
strong class="command">host</
strong></
span> will repeat a query
967N/A <
em class="parameter"><
code>number</
code></
em> is negative or zero, the
967N/A retries will default to 1. The default value is 1, or
967N/A the value of the <
em class="parameter"><
code>attempts</
code></
em> option in
771N/A Non-recursive queries can be made via the <
code class="option">-r</
code> option.
65N/A Setting this option clears the <
span class="type">RD</
span> — recursion
65N/A desired — bit in the query which <
span><
strong class="command">host</
strong></
span> makes.
65N/A This should mean that the name server receiving the query will not
65N/A attempt to resolve <
em class="parameter"><
code>name</
code></
em>. The
65N/A <
code class="option">-r</
code> option enables <
span><
strong class="command">host</
strong></
span>
65N/A the behavior of a name server by making non-recursive queries and
231N/A expecting to receive answers to those queries that are usually
231N/A referrals to other name servers.
176N/A By default, <
span><
strong class="command">host</
strong></
span> uses UDP when making
176N/A <
code class="option">-T</
code> option makes it use a TCP connection when querying
176N/A the name server. TCP will be automatically selected for queries that
298N/A require it, such as zone transfer (AXFR) requests.
95N/A The <
code class="option">-4</
code> option forces <
span><
strong class="command">host</
strong></
span> to only
95N/A use IPv4 query transport. The <
code class="option">-6</
code> option forces
95N/A <
span><
strong class="command">host</
strong></
span> to only use IPv6 query transport.
459N/A The <
code class="option">-t</
code> option is used to select the query type.
95N/A <
em class="parameter"><
code>type</
code></
em> can be any recognized query
95N/A NS, SOA, SIG, KEY, AXFR, etc. When no query type is specified,
95N/A <
span><
strong class="command">host</
strong></
span> automatically selects an appropriate
766N/A type. By default, it looks for A, AAAA, and MX records, but if the
766N/A <
code class="option">-C</
code> option was given, queries will be made for SOA
766N/A records, and if <
em class="parameter"><
code>name</
code></
em> is a
771N/A address or colon-delimited IPv6 address, <
span><
strong class="command">host</
strong></
span> will
771N/A query for PTR records. If a query type of IXFR is chosen the starting
771N/A serial number can be specified by appending an equal followed by the
771N/A starting serial number (
e.g. -t IXFR=12345678).
65N/A The time to wait for a reply can be controlled through the
771N/A <
code class="option">-W</
code> and <
code class="option">-w</
code> options. The
771N/A <
code class="option">-W</
code> option makes <
span><
strong class="command">host</
strong></
span>
435N/A <
em class="parameter"><
code>wait</
code></
em> seconds. If <
em class="parameter"><
code>wait</
code></
em>
435N/A is less than one, the wait interval is set to one second. When the
238N/A <
code class="option">-w</
code> option is used, <
span><
strong class="command">host</
strong></
span>
238N/A effectively wait forever for a reply. The time to wait for a response
766N/A will be set to the number of seconds given by the hardware's maximum
238N/A value for an integer quantity. By default, <
span><
strong class="command">host</
strong></
span>
238N/A will wait for 5 seconds for UDP responses and 10 seconds for TCP
238N/A connections. These defaults can be overridden by the
232N/A <
em class="parameter"><
code>timeout</
code></
em> option in
969N/A The <
code class="option">-s</
code> option tells <
span><
strong class="command">host</
strong></
span>
969N/A <
span class="emphasis"><
em>not</
em></
span> to send the query to the next nameserver
969N/A if any server responds with a SERVFAIL response, which is the
969N/A reverse of normal stub resolver behavior.
969N/A The <
code class="option">-m</
code> can be used to set the memory usage debugging
969N/A <
em class="parameter"><
code>record</
code></
em>, <
em class="parameter"><
code>usage</
code></
em> and
969N/A <
em class="parameter"><
code>trace</
code></
em>.
969N/A The <
code class="option">-V</
code> option causes <
span><
strong class="command">host</
strong></
span>
969N/A to print the version number and exit.
969N/A<
div class="refsect1" lang="en">
969N/A<
a name="id2617793"></
a><
h2>IDN SUPPORT</
h2>
969N/A If <
span><
strong class="command">host</
strong></
span> has been built with IDN (internationalized
969N/A domain name) support, it can accept and display non-ASCII domain names.
969N/A <
span><
strong class="command">host</
strong></
span> appropriately converts character encoding of
969N/A domain name before sending a request to DNS server or displaying a
771N/A If you'd like to turn off the IDN support for some reason, defines
743N/A the <
code class="envar">IDN_DISABLE</
code> environment variable.
743N/A The IDN support is disabled if the variable is set when
232N/A <
span><
strong class="command">host</
strong></
span> runs.
203N/A<
div class="refsect1" lang="en">
203N/A<
a name="id2619323"></
a><
h2>FILES</
h2>
459N/A<
div class="refsect1" lang="en">
203N/A<
a name="id2619337"></
a><
h2>SEE ALSO</
h2>
314N/A<
p><
span class="citerefentry"><
span class="refentrytitle">dig</
span>(1)</
span>,
314N/A <
span class="citerefentry"><
span class="refentrytitle">named</
span>(8)</
span>.
314N/A<
table width="100%" summary="Navigation footer">
314N/A<
td width="40%" align="left">
314N/A<
td width="40%" align="left" valign="top">dig�</
td>
749N/A<
td width="20%" align="center"><
a accesskey="h" href="Bv9ARM.html">Home</
a></
td>
749N/A<
td width="40%" align="right" valign="top">�delv</
td>
<
p style="text-align: center;">BIND 9.11.0pre-alpha</
p>