nslookup.html revision 71c66a876ecca77923638d3f94cc0783152b2f03
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - Permission to use, copy, modify, and distribute this software for any
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - purpose with or without fee is hereby granted, provided that the above
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - copyright notice and this permission notice appear in all copies.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano - PERFORMANCE OF THIS SOFTWARE.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<!-- $Id: nslookup.html,v 1.15 2006/06/29 13:03:32 marka Exp $ -->
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<meta name="generator" content="DocBook XSL Stylesheets V1.70.1">
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<a name="id2482694"></a><div class="titlepage"></div>
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler<p>nslookup — query Internet name servers interactively</p>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<p><span><strong class="command">Nslookup</strong></span>
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span>
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano has two modes: interactive and non-interactive. Interactive mode allows
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano the user to query name servers for information about various hosts and
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano domains or to print a list of hosts in a domain. Non-interactive mode
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano used to print just the name and requested information for a host or
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano Interactive mode is entered in the following cases:
05cda563bff2433c21acf5d13c364d581c34efd6Daniel Lezcano when no arguments are given (the default name server will be used)
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano when the first argument is a hyphen (-) and the second argument is
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the host name or Internet address of a name server.
7ee895e428cef6df576e4c9e6d10ac7d41b5a213Daniel Lezcano Non-interactive mode is used when the name or Internet address of the
7ee895e428cef6df576e4c9e6d10ac7d41b5a213Daniel Lezcano host to be looked up is given as the first argument. The optional second
7ee895e428cef6df576e4c9e6d10ac7d41b5a213Daniel Lezcano argument specifies the host name or address of a name server.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Options can also be specified on the command line if they precede the
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano arguments and are prefixed with a hyphen. For example, to
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano change the default query type to host information, and the initial
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano timeout to 10 seconds, type:
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<div class="informalexample"><pre class="programlisting">
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcanonslookup -query=hinfo -timeout=10
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<a name="id2549470"></a><h2>INTERACTIVE COMMANDS</h2>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term">host [<span class="optional">server</span>]</span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Look up information for host using the current default server or
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano using server, if specified. If host is an Internet address and
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the query type is A or PTR, the name of the host is returned.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano If host is a name and does not have a trailing period, the
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano search list is used to qualify the name.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano To look up a host not in the current domain, append a period to
7ee895e428cef6df576e4c9e6d10ac7d41b5a213Daniel Lezcano<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
7ee895e428cef6df576e4c9e6d10ac7d41b5a213Daniel Lezcano<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the current default server. If an authoritative answer can't be
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano found, the names of servers that might have the answer are
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">root</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">finger</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">ls</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">view</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">help</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">?</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano not implemented
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">exit</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Exits the program.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">set</code>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano This command is used to change state information that affects
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the lookups. Valid keywords are:
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">all</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Prints the current values of the frequently used
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano options to <span><strong class="command">set</strong></span>.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Information about the current default
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano server and host is also printed.
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano Change the query class to one of:
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">IN</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the Internet class
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">CH</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the Chaos class
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">HS</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano the Hesiod class
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano<dt><span class="term"><code class="constant">ANY</code></span></dt>
b3357a6f5b90f1e342c270de66491afc412c1cf7Daniel Lezcano The class specifies the protocol group of the information.
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler (Default = IN; abbreviation = cl)
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler<dt><span class="term"><code class="constant">
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler Turn debugging mode on. A lot more information is
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler printed about the packet sent to the server and the
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler resulting answer.
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler<dt><span class="term"><code class="constant">
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler Turn debugging mode on. A lot more information is
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler printed about the packet sent to the server and the
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler resulting answer.
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler (Default = nod2)
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler Sets the search list to <em class="replaceable"><code>name</code></em>.
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler<dt><span class="term"><code class="constant">
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler If the lookup request contains at least one period but
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler doesn't end with a trailing period, append the domain
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler names in the domain search list to the request until an
20d816599f954e7e5864d39884cc0de56f9358fdChristian Seiler answer is received.
<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
<em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>