2004-09-19 01:30:24 +00:00
|
|
|
<!--
|
2005-12-29 04:22:58 +00:00
|
|
|
- Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
|
|
|
|
|
-
|
2004-09-19 01:30:24 +00:00
|
|
|
- Permission to use, copy, modify, and distribute this software for any
|
|
|
|
|
- purpose with or without fee is hereby granted, provided that the above
|
|
|
|
|
- copyright notice and this permission notice appear in all copies.
|
2005-12-29 04:22:58 +00:00
|
|
|
-
|
2004-09-19 01:30:24 +00:00
|
|
|
- THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
|
|
|
|
|
- REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
2005-12-29 04:22:58 +00:00
|
|
|
- AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
|
2004-09-19 01:30:24 +00:00
|
|
|
- INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
|
|
|
- LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
|
|
|
|
|
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
|
|
|
- PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
|
-->
|
2005-12-29 04:22:58 +00:00
|
|
|
<!-- $Id: nslookup.html,v 1.1.6.9 2005/10/13 02:33:44 marka Exp $ -->
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
|
|
|
<title>nslookup</title>
|
|
|
|
|
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
|
|
|
|
|
</head>
|
|
|
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
|
|
|
|
|
<a name="id2463728"></a><div class="titlepage"></div>
|
|
|
|
|
<div class="refnamediv">
|
|
|
|
|
<h2>Name</h2>
|
|
|
|
|
<p>nslookup — query Internet name servers interactively</p>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsynopsisdiv">
|
|
|
|
|
<h2>Synopsis</h2>
|
|
|
|
|
<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsect1" lang="en">
|
|
|
|
|
<a name="id2525973"></a><h2>DESCRIPTION</h2>
|
|
|
|
|
<p>
|
|
|
|
|
<span><strong class="command">Nslookup</strong></span>
|
|
|
|
|
is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span>
|
2004-09-19 01:30:24 +00:00
|
|
|
has two modes: interactive and non-interactive. Interactive mode allows
|
|
|
|
|
the user to query name servers for information about various hosts and
|
|
|
|
|
domains or to print a list of hosts in a domain. Non-interactive mode is
|
|
|
|
|
used to print just the name and requested information for a host or
|
2005-12-29 04:22:58 +00:00
|
|
|
domain.
|
|
|
|
|
</p>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsect1" lang="en">
|
|
|
|
|
<a name="id2525990"></a><h2>ARGUMENTS</h2>
|
|
|
|
|
<p>
|
|
|
|
|
Interactive mode is entered in the following cases:
|
|
|
|
|
</p>
|
|
|
|
|
<div class="orderedlist"><ol type="a">
|
|
|
|
|
<li><p>
|
|
|
|
|
when no arguments are given (the default name server will be used)
|
|
|
|
|
</p></li>
|
|
|
|
|
<li><p>
|
|
|
|
|
when the first argument is a hyphen (-) and the second argument is
|
|
|
|
|
the host name or Internet address of a name server.
|
|
|
|
|
</p></li>
|
|
|
|
|
</ol></div>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Non-interactive mode is used when the name or Internet address of the
|
2004-09-19 01:30:24 +00:00
|
|
|
host to be looked up is given as the first argument. The optional second
|
2005-12-29 04:22:58 +00:00
|
|
|
argument specifies the host name or address of a name server.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Options can also be specified on the command line if they precede the
|
2004-09-19 01:30:24 +00:00
|
|
|
arguments and are prefixed with a hyphen. For example, to
|
|
|
|
|
change the default query type to host information, and the initial timeout to 10 seconds, type:
|
2005-12-29 04:22:58 +00:00
|
|
|
</p>
|
|
|
|
|
<div class="informalexample"><pre class="programlisting">
|
|
|
|
|
nslookup -query=hinfo -timeout=10
|
|
|
|
|
</pre></div>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsect1" lang="en">
|
|
|
|
|
<a name="id2526033"></a><h2>INTERACTIVE COMMANDS</h2>
|
|
|
|
|
<div class="variablelist"><dl>
|
|
|
|
|
<dt><span class="term">host [<span class="optional">server</span>]</span></dt>
|
|
|
|
|
<dd>
|
|
|
|
|
<p>
|
|
|
|
|
Look up information for host using the current default server or
|
2004-09-19 01:30:24 +00:00
|
|
|
using server, if specified. If host is an Internet address and
|
|
|
|
|
the query type is A or PTR, the name of the host is returned.
|
|
|
|
|
If host is a name and does not have a trailing period, the
|
2005-12-29 04:22:58 +00:00
|
|
|
search list is used to qualify the name.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
To look up a host not in the current domain, append a period to
|
|
|
|
|
the name.
|
|
|
|
|
</p>
|
|
|
|
|
</dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
|
|
|
|
|
<dd><p></p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
|
|
|
|
|
<dd><p>
|
|
|
|
|
Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
|
|
|
|
|
server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
|
2004-09-19 01:30:24 +00:00
|
|
|
the current default server. If an authoritative answer can't be
|
|
|
|
|
found, the names of servers that might have the answer are
|
2005-12-29 04:22:58 +00:00
|
|
|
returned.
|
|
|
|
|
</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">root</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">finger</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">ls</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">view</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">help</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</p></dd>
|
|
|
|
|
<dt><span class="term"><code class="constant">?</code></span></dt>
|
|
|
|
|
<dd><p>not implemented</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
|
2004-09-19 01:30:24 +00:00
|
|
|
the lookups. Valid keywords are:
|
2005-12-29 04:22:58 +00:00
|
|
|
</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
|
2004-09-19 01:30:24 +00:00
|
|
|
server and host is also printed.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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>
|
2004-09-19 01:30:24 +00:00
|
|
|
The class specifies the protocol group of the information.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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
|
2004-09-19 01:30:24 +00:00
|
|
|
printed about the packet sent to the server and the
|
|
|
|
|
resulting answer.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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
|
2004-09-19 01:30:24 +00:00
|
|
|
printed about the packet sent to the server and the
|
|
|
|
|
resulting answer.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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
|
2004-09-19 01:30:24 +00:00
|
|
|
doesn't end with a trailing period, append the domain
|
|
|
|
|
names in the domain search list to the request until an
|
|
|
|
|
answer is received.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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 top 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
|
2004-09-19 01:30:24 +00:00
|
|
|
information.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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
|
2004-09-19 01:30:24 +00:00
|
|
|
reply to number seconds.
|
2005-12-29 04:22:58 +00:00
|
|
|
</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>
|
|
|
|
|
</dl></div>
|
|
|
|
|
<p>
|
|
|
|
|
</p>
|
|
|
|
|
</dd>
|
|
|
|
|
</dl></div>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsect1" lang="en">
|
|
|
|
|
<a name="id2526490"></a><h2>FILES</h2>
|
|
|
|
|
<p>
|
|
|
|
|
<code class="filename">/etc/resolv.conf</code>
|
|
|
|
|
</p>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="refsect1" lang="en">
|
|
|
|
|
<a name="id2526503"></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="id2526538"></a><h2>Author</h2>
|
|
|
|
|
<p>
|
|
|
|
|
Andrew Cherenson
|
|
|
|
|
</p>
|
|
|
|
|
</div>
|
|
|
|
|
</div></body>
|
|
|
|
|
</html>
|
