man.nslookup.html revision 8dcec3cf256105c620d02d5c84c9ccbfe495ca8d
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen - Copyright (C) 2000-2016 Internet Systems Consortium, Inc. ("ISC")
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen - This Source Code Form is subject to the terms of the Mozilla Public
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen - License, v. 2.0. If a copy of the MPL was not distributed with this
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen - file, You can obtain one at http://mozilla.org/MPL/2.0/.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<link rel="prev" href="man.delv.html" title="delv">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<link rel="next" href="man.dnssec-checkds.html" title="dnssec-checkds">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<table width="100%" summary="Navigation header">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<tr><th colspan="3" align="center">nslookup</th></tr>
b5efdb8af40ea759a1ea584c1bc44ecc81dd00ceLennart Poettering<a accesskey="p" href="man.delv.html">Prev</a>�</td>
b5efdb8af40ea759a1ea584c1bc44ecc81dd00ceLennart Poettering<th width="60%" align="center">Manual pages</th>
958b66ea16deddd794b3a52643bd44633e165eadLennart Poettering<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<a name="man.nslookup"></a><div class="titlepage"></div>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen — query Internet name servers interactively
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <p><span class="command"><strong>Nslookup</strong></span>
397d15fd397060a19a90969b6aa283965c40fb27Martin Pitt is a program to query Internet domain name servers. <span class="command"><strong>Nslookup</strong></span>
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering has two modes: interactive and non-interactive. Interactive mode allows
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering the user to query name servers for information about various hosts and
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen domains or to print a list of hosts in a domain. Non-interactive mode
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen used to print just the name and requested information for a host or
46b0c76e2c355c0d0cc4792abb98cde07b28bc53Emil Renner Berthing<a name="id-1.14.6.8"></a><h2>ARGUMENTS</h2>
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering Interactive mode is entered in the following cases:
ed9e361a8a798f9fee353b5c7e0e23308e0d329fTom Gundersen<div class="orderedlist"><ol class="orderedlist" type="a">
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering when no arguments are given (the default name server will be used)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen when the first argument is a hyphen (-) and the second argument is
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the host name or Internet address of a name server.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Non-interactive mode is used when the name or Internet address of the
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering host to be looked up is given as the first argument. The optional second
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering argument specifies the host name or address of a name server.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Options can also be specified on the command line if they precede the
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen arguments and are prefixed with a hyphen. For example, to
46b0c76e2c355c0d0cc4792abb98cde07b28bc53Emil Renner Berthing change the default query type to host information, and the initial
84b5b79a8f7b423c5b7cad4170eb68d57fe5e26cAngus Gibson timeout to 10 seconds, type:
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poetteringnslookup -query=hinfo -timeout=10
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen The <code class="option">-version</code> option causes
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <span class="command"><strong>nslookup</strong></span> to print the version
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen number and immediately exits.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<a name="id-1.14.6.9"></a><h2>INTERACTIVE COMMANDS</h2>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <div class="variablelist"><dl class="variablelist">
ed9e361a8a798f9fee353b5c7e0e23308e0d329fTom Gundersen<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Look up information for host using the current default server or
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen using server, if specified. If host is an Internet address and
ed9e361a8a798f9fee353b5c7e0e23308e0d329fTom Gundersen the query type is A or PTR, the name of the host is returned.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen If host is a name and does not have a trailing period, the
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen search list is used to qualify the name.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen To look up a host not in the current domain, append a period to
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the current default server. If an authoritative answer can't be
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen found, the names of servers that might have the answer are
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">root</code></span></dt>
79008bddf679a5e0900369950eb346c9fa687107Lennart Poettering not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">finger</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">ls</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">view</code></span></dt>
91b5f997316ddc77d26f9a7a5e24c335484586bdTom Gundersen not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">help</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">?</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen not implemented
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">exit</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Exits the program.
91b5f997316ddc77d26f9a7a5e24c335484586bdTom Gundersen<dt><span class="term"><code class="constant">set</code>
91b5f997316ddc77d26f9a7a5e24c335484586bdTom Gundersen <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
ed9e361a8a798f9fee353b5c7e0e23308e0d329fTom Gundersen This command is used to change state information that affects
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the lookups. Valid keywords are:
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<div class="variablelist"><dl class="variablelist">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">all</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Prints the current values of the frequently used
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen options to <span class="command"><strong>set</strong></span>.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Information about the current default
f414a269b378d526b8b26c5b52743360b43965ceTom Gundersen server and host is also printed.
f414a269b378d526b8b26c5b52743360b43965ceTom Gundersen<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
f414a269b378d526b8b26c5b52743360b43965ceTom Gundersen Change the query class to one of:
f414a269b378d526b8b26c5b52743360b43965ceTom Gundersen<div class="variablelist"><dl class="variablelist">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">IN</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the Internet class
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">CH</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the Chaos class
79008bddf679a5e0900369950eb346c9fa687107Lennart Poettering<dt><span class="term"><code class="constant">HS</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen the Hesiod class
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">ANY</code></span></dt>
dce391e78f5d8d5f4feb3eb6a15436de12dacf46Lennart Poettering The class specifies the protocol group of the information.
dce391e78f5d8d5f4feb3eb6a15436de12dacf46Lennart Poettering (Default = IN; abbreviation = cl)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Turn on or off the display of the full response packet and
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen any intermediate response packets when searching.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Turn debugging mode on or off. This displays more about
1c4baffc1895809bae9ac36b670af90a4cb9cd7dTom Gundersen what nslookup is doing.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = nod2)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Sets the search list to <em class="replaceable"><code>name</code></em>.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen If the lookup request contains at least one period but
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen doesn't end with a trailing period, append the domain
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen names in the domain search list to the request until an
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen answer is received.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = search)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = 53; abbreviation = po)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
6666907869fb3bc7fe6a6025540db5b887c7a78bTom Gundersen<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Change the type of the information query.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = A; abbreviations = q, ty)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Tell the name server to query other servers if it does not
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = recurse; abbreviation = [no]rec)
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering<dt><span class="term"><code class="constant">ndots=</code><em class="replaceable"><code>number</code></em></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Set the number of dots (label separators) in a domain
e6b18ffaea7d557eec3028a37c043da67a78550cDavid Herrmann that will disable searching. Absolute names always
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen stop searching.
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering Set the number of retries to number.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering Change the initial timeout interval for waiting for a
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen reply to number seconds.
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Always use a virtual circuit when sending requests to the
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = novc)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen Try the next nameserver if a nameserver responds with
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen SERVFAIL or a referral (nofail) or terminate query
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (fail) on such a response.
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen (Default = nofail)
f6b8196f7cf1e366e15597283bc3d13af72a7eb5Lennart Poettering<a name="id-1.14.6.10"></a><h2>RETURN VALUES</h2>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen <span class="command"><strong>nslookup</strong></span> returns with an exit status of 1
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen if any query failed, and 0 otherwise.
f2341e0a87cab1558c84c933956e9181d5fb6c52Lennart Poettering <p><code class="filename">/etc/resolv.conf</code>
f2341e0a87cab1558c84c933956e9181d5fb6c52Lennart Poettering<a name="id-1.14.6.12"></a><h2>SEE ALSO</h2>
f2341e0a87cab1558c84c933956e9181d5fb6c52Lennart Poettering <span class="refentrytitle">dig</span>(1)
f2341e0a87cab1558c84c933956e9181d5fb6c52Lennart Poettering <span class="refentrytitle">host</span>(1)
f2341e0a87cab1558c84c933956e9181d5fb6c52Lennart Poettering <span class="refentrytitle">named</span>(8)
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<table width="100%" summary="Navigation footer">
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<a accesskey="p" href="man.delv.html">Prev</a>�</td>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<td width="40%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<td width="40%" align="left" valign="top">delv�</td>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
3c9b886068d99e5d3cbabcac32a4decf37244c54Tom Gundersen<td width="40%" align="right" valign="top">�<span class="application">dnssec-checkds</span>
dce391e78f5d8d5f4feb3eb6a15436de12dacf46Lennart Poettering<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.1rc2</p>