nslookup.html revision 742cb92338832aeaf4d5abb81b27c5e13541ca99
0N/A<!--
0N/A - Copyright (C) 2004-2007, 2010, 2013-2016 Internet Systems Consortium, Inc. ("ISC")
0N/A -
0N/A - Permission to use, copy, modify, and/or distribute this software for any
0N/A - purpose with or without fee is hereby granted, provided that the above
0N/A - copyright notice and this permission notice appear in all copies.
0N/A -
0N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
0N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
0N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
0N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
0N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
0N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
0N/A - PERFORMANCE OF THIS SOFTWARE.
0N/A-->
0N/A<html>
0N/A<head>
0N/A<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
0N/A<title>nslookup</title>
0N/A<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
0N/A</head>
0N/A<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
0N/A<a name="id-1"></a><div class="titlepage"></div>
0N/A<div class="refnamediv">
0N/A<h2>Name</h2>
0N/A<p>nslookup &#8212; query Internet name servers interactively</p>
0N/A</div>
0N/A<div class="refsynopsisdiv">
0N/A<h2>Synopsis</h2>
0N/A<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
0N/A</div>
0N/A<div class="refsection">
338N/A<a name="id-1.7"></a><h2>DESCRIPTION</h2>
0N/A<p><span class="command"><strong>Nslookup</strong></span>
338N/A is a program to query Internet domain name servers. <span class="command"><strong>Nslookup</strong></span>
0N/A has two modes: interactive and non-interactive. Interactive mode allows
0N/A the user to query name servers for information about various hosts and
0N/A domains or to print a list of hosts in a domain. Non-interactive mode
0N/A is
0N/A used to print just the name and requested information for a host or
0N/A domain.
0N/A </p>
0N/A</div>
0N/A<div class="refsection">
0N/A<a name="id-1.8"></a><h2>ARGUMENTS</h2>
0N/A<p>
0N/A Interactive mode is entered in the following cases:
0N/A </p>
0N/A<div class="orderedlist"><ol class="orderedlist" type="a">
0N/A<li class="listitem"><p>
0N/A when no arguments are given (the default name server will be used)
0N/A </p></li>
0N/A<li class="listitem"><p>
0N/A when the first argument is a hyphen (-) and the second argument is
0N/A the host name or Internet address of a name server.
0N/A </p></li>
0N/A</ol></div>
0N/A<p>
0N/A </p>
0N/A<p>
0N/A Non-interactive mode is used when the name or Internet address of the
0N/A host to be looked up is given as the first argument. The optional second
0N/A argument specifies the host name or address of a name server.
0N/A </p>
0N/A<p>
0N/A Options can also be specified on the command line if they precede the
0N/A arguments and are prefixed with a hyphen. For example, to
0N/A change the default query type to host information, and the initial
0N/A timeout to 10 seconds, type:
0N/A
0N/A </p>
0N/A<pre class="programlisting">
0N/Anslookup -query=hinfo -timeout=10
0N/A</pre>
0N/A<p>
0N/A
0N/A </p>
0N/A<p>
0N/A The <code class="option">-version</code> option causes
0N/A <span class="command"><strong>nslookup</strong></span> to print the version
0N/A number and immediately exits.
0N/A </p>
0N/A</div>
0N/A<div class="refsection">
0N/A<a name="id-1.9"></a><h2>INTERACTIVE COMMANDS</h2>
0N/A<div class="variablelist"><dl class="variablelist">
205N/A<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
0N/A<dd>
0N/A<p>
0N/A Look up information for host using the current default server or
0N/A using server, if specified. If host is an Internet address and
0N/A the query type is A or PTR, the name of the host is returned.
0N/A If host is a name and does not have a trailing period, the
0N/A search list is used to qualify the name.
0N/A </p>
0N/A<p>
0N/A To look up a host not in the current domain, append a period to
0N/A the name.
0N/A </p>
0N/A</dd>
0N/A<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
0N/A<dd><p></p></dd>
0N/A<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
0N/A<dd><p>
0N/A Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
0N/A server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
0N/A the current default server. If an authoritative answer can't be
0N/A found, the names of servers that might have the answer are
0N/A returned.
0N/A </p></dd>
0N/A<dt><span class="term"><code class="constant">root</code></span></dt>
0N/A<dd><p>
0N/A not implemented
0N/A </p></dd>
0N/A<dt><span class="term"><code class="constant">finger</code></span></dt>
0N/A<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
the lookups. Valid keywords are:
</p>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="constant">all</code></span></dt>
<dd><p>
Prints the current values of the frequently used
options to <span class="command"><strong>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 class="variablelist">
<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 on or off the display of the full response packet and
any intermediate response packets when searching.
</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 or off. This displays more about
what nslookup is doing.
</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">ndots=</code><em class="replaceable"><code>number</code></em></span></dt>
<dd><p>
Set the number of dots (label separators) in a domain
that will disable searching. Absolute names always
stop searching.
</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="refsection">
<a name="id-1.10"></a><h2>RETURN VALUES</h2>
<p>
<span class="command"><strong>nslookup</strong></span> returns with an exit status of 1
if any query failed, and 0 otherwise.
</p>
</div>
<div class="refsection">
<a name="id-1.11"></a><h2>FILES</h2>
<p><code class="filename">/etc/resolv.conf</code>
</p>
</div>
<div class="refsection">
<a name="id-1.12"></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></body>
</html>