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