man.host.html revision 9700e6d72c3ba0d0c567969ab97d9eff202656d4
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
71cef386fae61275b03e203825680b39fedaa8c6Tinderbox User - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC")
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User - This Source Code Form is subject to the terms of the Mozilla Public
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User - License, v. 2.0. If a copy of the MPL was not distributed with this
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User - file, You can obtain one at http://mozilla.org/MPL/2.0/.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<link rel="prev" href="man.mdig.html" title="mdig">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<link rel="next" href="man.delv.html" title="delv">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<table width="100%" summary="Navigation header">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<tr><th colspan="3" align="center">host</th></tr>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<a accesskey="p" href="man.mdig.html">Prev</a>�</td>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<th width="60%" align="center">Manual pages</th>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<td width="20%" align="right">�<a accesskey="n" href="man.delv.html">Next</a>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<a name="man.host"></a><div class="titlepage"></div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User — DNS lookup utility
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-N <em class="replaceable"><code>ndots</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-R <em class="replaceable"><code>number</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-t <em class="replaceable"><code>type</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-W <em class="replaceable"><code>wait</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-m <em class="replaceable"><code>flag</code></em></code>]
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<a name="id-1.14.4.7"></a><h2>DESCRIPTION</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><span class="command"><strong>host</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User is a simple utility for performing DNS lookups.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User It is normally used to convert names to IP addresses and vice versa.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User When no arguments or options are given,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="command"><strong>host</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User prints a short summary of its command line arguments and options.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><em class="parameter"><code>name</code></em> is the domain name that is to be
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User up. It can also be a dotted-decimal IPv4 address or a colon-delimited
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User IPv6 address, in which case <span class="command"><strong>host</strong></span> will by
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User perform a reverse lookup for that address.
bfb7b680bf88c1fdd9949197b71c512c532280a4Tinderbox User <em class="parameter"><code>server</code></em> is an optional argument which
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the name or IP address of the name server that <span class="command"><strong>host</strong></span>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User should query instead of the server or servers listed in
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <code class="filename">/etc/resolv.conf</code>.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User <div class="variablelist"><dl class="variablelist">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Use IPv4 only for query transport.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User See also the <code class="option">-6</code> option.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Use IPv6 only for query transport.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User See also the <code class="option">-4</code> option.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User "All". The <code class="option">-a</code> option is normally equivalent
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to <code class="option">-v -t <code class="literal">ANY</code></code>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User It also affects the behaviour of the <code class="option">-l</code>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User list zone option.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User Query class: This can be used to lookup HS (Hesiod) or CH
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User (Chaosnet) class resource records. The default class is IN
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User Check consistency: <span class="command"><strong>host</strong></span> will query the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User SOA records for zone <em class="parameter"><code>name</code></em> from all
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the listed authoritative name servers for that zone. The
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User list of name servers is defined by the NS records that are
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User found for the zone.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Print debugging traces.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Equivalent to the <code class="option">-v</code> verbose option.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Use the IP6.INT domain for reverse lookups of IPv6
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User addresses as defined in RFC1886 and deprecated in RFC4159.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User The default is to use IP6.ARPA as specified in RFC3596.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <span class="command"><strong>host</strong></span> command performs a zone transfer of
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User zone <em class="parameter"><code>name</code></em> and prints out the NS,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Together, the <code class="option">-l -a</code>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User options print all records in the zone.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-N <em class="replaceable"><code>ndots</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The number of dots that have to be
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User in <em class="parameter"><code>name</code></em> for it to be considered
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User absolute. The default value is that defined using the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User ndots statement in <code class="filename">/etc/resolv.conf</code>,
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User or 1 if no ndots statement is present. Names with fewer
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User dots are interpreted as relative names and will be
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User searched for in the domains listed in
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User the <span class="type">search</span> or <span class="type">domain</span> directive
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User in <code class="filename">/etc/resolv.conf</code>.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User Non-recursive query:
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User Setting this option clears the RD (recursion desired) bit
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User in the query. This should mean that the name server
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User receiving the query will not attempt to
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User resolve <em class="parameter"><code>name</code></em>.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User enables <span class="command"><strong>host</strong></span> to mimic the behavior of a
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User name server by making non-recursive queries and expecting
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User to receive answers to those queries that can be
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User referrals to other name servers.
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<dt><span class="term">-R <em class="replaceable"><code>number</code></em></span></dt>
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User Number of retries for UDP queries: