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