nslookup.html revision 69f175fc57a578dd85c1548ed3f34284321f9d3a
b0e8629055a766d4555a005a283c2889a5974945Mark Andrews - Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Permission to use, copy, modify, and distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: nslookup.html,v 1.17 2006/12/17 04:54:22 marka Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id2476423"></a><div class="titlepage"></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p>nslookup — query Internet name servers interactively</p>
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span><strong class="command">Nslookup</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein has two modes: interactive and non-interactive. Interactive mode allows
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the user to query name servers for information about various hosts and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein domains or to print a list of hosts in a domain. Non-interactive mode
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein used to print just the name and requested information for a host or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Interactive mode is entered in the following cases:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein when no arguments are given (the default name server will be used)
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews when the first argument is a hyphen (-) and the second argument is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the host name or Internet address of a name server.
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews Non-interactive mode is used when the name or Internet address of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein host to be looked up is given as the first argument. The optional second
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews argument specifies the host name or address of a name server.
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews Options can also be specified on the command line if they precede the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein arguments and are prefixed with a hyphen. For example, to
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews change the default query type to host information, and the initial
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews timeout to 10 seconds, type:
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews<div class="informalexample"><pre class="programlisting">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinnslookup -query=hinfo -timeout=10
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id2543668"></a><h2>INTERACTIVE COMMANDS</h2>
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews Look up information for host using the current default server or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein using server, if specified. If host is an Internet address and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the query type is A or PTR, the name of the host is returned.
92554adb458c7b336e5390c5c9fbf2fcc1276524Mark Andrews If host is a name and does not have a trailing period, the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein search list is used to qualify the name.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein To look up a host not in the current domain, append a period to
f4429c1c31ec32f05125baab1adcc4f09863f7afMark Andrews<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the current default server. If an authoritative answer can't be
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews found, the names of servers that might have the answer are
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<dt><span class="term"><code class="constant">root</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<dt><span class="term"><code class="constant">finger</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">ls</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">view</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<dt><span class="term"><code class="constant">help</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">?</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">exit</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Exits the program.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">set</code>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This command is used to change state information that affects
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the lookups. Valid keywords are:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">all</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Prints the current values of the frequently used
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein options to <span><strong class="command">set</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Information about the current default
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein server and host is also printed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Change the query class to one of:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">IN</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the Internet class
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">CH</code></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews the Chaos class
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term"><code class="constant">HS</code></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews the Hesiod class
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term"><code class="constant">ANY</code></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews The class specifies the protocol group of the information.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = IN; abbreviation = cl)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn debugging mode on. A lot more information is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein printed about the packet sent to the server and the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein resulting answer.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn debugging mode on. A lot more information is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein printed about the packet sent to the server and the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein resulting answer.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = nod2)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Sets the search list to <em class="replaceable"><code>name</code></em>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If the lookup request contains at least one period but
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein doesn't end with a trailing period, append the domain
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein names in the domain search list to the request until an
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein answer is received.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = search)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>.
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews (Default = 53; abbreviation = po)
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews Change the type of the information query.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = A; abbreviations = q, ty)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Tell the name server to query other servers if it does not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein information.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = recurse; abbreviation = [no]rec)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Set the number of retries to number.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Change the initial timeout interval for waiting for a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein reply to number seconds.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>
bea931e17b7567f09107f93ab7e25c7f00abeb9cMark Andrews Always use a virtual circuit when sending requests to the
b05bdb520d83f7ecaad708fe305268c3420be01dMark Andrews (Default = novc)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Try the next nameserver if a nameserver responds with
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein SERVFAIL or a referral (nofail) or terminate query
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (fail) on such a response.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = nofail)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><code class="filename">/etc/resolv.conf</code>
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews<p><span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Andrew Cherenson