nslookup.html revision b0e8629055a766d4555a005a283c2889a5974945
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg - Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - Permission to use, copy, modify, and distribute this software for any
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - purpose with or without fee is hereby granted, provided that the above
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - copyright notice and this permission notice appear in all copies.
4da61833a1cbbca94094f9653fd970582b97a72etrawick - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
4da61833a1cbbca94094f9653fd970582b97a72etrawick - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
4da61833a1cbbca94094f9653fd970582b97a72etrawick - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
4da61833a1cbbca94094f9653fd970582b97a72etrawick - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
4da61833a1cbbca94094f9653fd970582b97a72etrawick - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
4789804be088bcd86ae637a29cdb7fda25169521jailletc - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
4789804be088bcd86ae637a29cdb7fda25169521jailletc - PERFORMANCE OF THIS SOFTWARE.
4789804be088bcd86ae637a29cdb7fda25169521jailletc<!-- $Id: nslookup.html,v 1.19 2007/01/30 00:24:59 marka Exp $ -->
e50c3026198fd496f183cda4c32a202925476778covener<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic<p>nslookup — query Internet name servers interactively</p>
69301145375a889e7e37caf7cc7321ac0f91801erpluem<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza<p><span><strong class="command">Nslookup</strong></span>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza has two modes: interactive and non-interactive. Interactive mode allows
d58a848a016d401b965111e50ef829e1641f7834minfrin the user to query name servers for information about various hosts and
d58a848a016d401b965111e50ef829e1641f7834minfrin domains or to print a list of hosts in a domain. Non-interactive mode
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf used to print just the name and requested information for a host or
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic Interactive mode is entered in the following cases:
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic when no arguments are given (the default name server will be used)
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic when the first argument is a hyphen (-) and the second argument is
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic the host name or Internet address of a name server.
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener Non-interactive mode is used when the name or Internet address of the
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener host to be looked up is given as the first argument. The optional second
44ff304057225e944e220e981d434a046d14cf06covener argument specifies the host name or address of a name server.
44ff304057225e944e220e981d434a046d14cf06covener Options can also be specified on the command line if they precede the
5d1ba75b8794925e67591c209085a49279791de9covener arguments and are prefixed with a hyphen. For example, to
5d1ba75b8794925e67591c209085a49279791de9covener change the default query type to host information, and the initial
5d1ba75b8794925e67591c209085a49279791de9covener timeout to 10 seconds, type:
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand<div class="informalexample"><pre class="programlisting">
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrandnslookup -query=hinfo -timeout=10
45a10d38e6051fd7bdf9d742aaae633d97ff02abjailletc<a name="id2543413"></a><h2>INTERACTIVE COMMANDS</h2>
f7317ff316c2b141feea31bddb74d5d3fa1584edjorton<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem Look up information for host using the current default server or
1e2d421a36999d292042a5539971070d54aa6c63ylavic using server, if specified. If host is an Internet address and
1e2d421a36999d292042a5539971070d54aa6c63ylavic the query type is A or PTR, the name of the host is returned.
1e2d421a36999d292042a5539971070d54aa6c63ylavic If host is a name and does not have a trailing period, the
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh search list is used to qualify the name.
0b67eb8568cd58bb77082703951679b42cf098actrawick To look up a host not in the current domain, append a period to
5ef3c61605a3a021ff71f488983cb0065f8e1a79covener<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
09c87c777bed1655621bb20e1c46cb6b1a63279dcovener<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavic Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
3060ce7f798fbda7999cd4ddf89b525d2b294185covener server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic the current default server. If an authoritative answer can't be
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic found, the names of servers that might have the answer are
e6b4bd1113567627ab6bb6c6a7105e1e01a7d889jailletc<dt><span class="term"><code class="constant">root</code></span></dt>
e466c40e1801982602ee0200c9e8b61cc148742djailletc not implemented
457468b82e59d01eba00dd9d0817309c8f5e414ejim<dt><span class="term"><code class="constant">finger</code></span></dt>
04983e3bd1754764eec7d6bb772fe3b0bf391771jorton not implemented
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem<dt><span class="term"><code class="constant">ls</code></span></dt>
15660979a30d251681463de2e0584853890082accovener not implemented
49dacedb6c387b786b7911082ff35121a45f414bcovener<dt><span class="term"><code class="constant">view</code></span></dt>
cfd9415521847b2f9394fad04fb701cfb955f503rjung not implemented
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe<dt><span class="term"><code class="constant">help</code></span></dt>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe not implemented
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe<dt><span class="term"><code class="constant">?</code></span></dt>
63b9f1f5880391261705f696d7d65507bbe9ace3covener not implemented
63b9f1f5880391261705f696d7d65507bbe9ace3covener<dt><span class="term"><code class="constant">exit</code></span></dt>
49dacedb6c387b786b7911082ff35121a45f414bcovener Exits the program.
49dacedb6c387b786b7911082ff35121a45f414bcovener<dt><span class="term"><code class="constant">set</code>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim This command is used to change state information that affects
fc42512879dd0504532f52fe5d0d0383dda96a1eniq the lookups. Valid keywords are:
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq<dt><span class="term"><code class="constant">all</code></span></dt>
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq Prints the current values of the frequently used
da0442c0440caef34706e2c2f3af05cb65921cc0jailletc options to <span><strong class="command">set</strong></span>.
983528026996668ea295be95aedb9c7a346af470ylavic Information about the current default
da0442c0440caef34706e2c2f3af05cb65921cc0jailletc server and host is also printed.
06b8f183140c8e02e0974e938a05078b511d1603covener<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem Change the query class to one of:
259878293a997ff49f5ddfc53d3739cbdc25444ecovener<dt><span class="term"><code class="constant">IN</code></span></dt>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem the Internet class
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrin<dt><span class="term"><code class="constant">CH</code></span></dt>
65967d05f839dbf27cf91d91fa79585eeae19660minfrin the Chaos class
65967d05f839dbf27cf91d91fa79585eeae19660minfrin<dt><span class="term"><code class="constant">HS</code></span></dt>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin the Hesiod class
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<dt><span class="term"><code class="constant">ANY</code></span></dt>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph The class specifies the protocol group of the information.
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick (Default = IN; abbreviation = cl)
54d750a84a175d8e338880514d440773eb986b50covener <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
54d750a84a175d8e338880514d440773eb986b50covener Turn debugging mode on. A lot more information is
54d750a84a175d8e338880514d440773eb986b50covener printed about the packet sent to the server and the
54d750a84a175d8e338880514d440773eb986b50covener resulting answer.
54d750a84a175d8e338880514d440773eb986b50covener (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
5f066f496cd9f20a2a701255bc67d44e7cb46daetrawick <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
2e15620d724fb8e3a5be183b917359a2fd6e9468covener Turn debugging mode on. A lot more information is
2e15620d724fb8e3a5be183b917359a2fd6e9468covener printed about the packet sent to the server and the
2e15620d724fb8e3a5be183b917359a2fd6e9468covener resulting answer.
1b988c41ee505962781d110a3e4c2c90f1ea0aa4covener (Default = nod2)
b8efdc95bec9cf089aa1be0bfd07d46aa1137a7acovener<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
b8efdc95bec9cf089aa1be0bfd07d46aa1137a7acovener Sets the search list to <em class="replaceable"><code>name</code></em>.
f06e7c4b1bce6b6491e5de0b7998d3f5696b293dchrisd <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
179565be4043d7e5f9161aa75271fa0a001866d9covener If the lookup request contains at least one period but
111436a32ba1254291e4883292fb116d15fe8f64covener doesn't end with a trailing period, append the domain
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener names in the domain search list to the request until an
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener answer is received.
7b7430e701e9a31ce809da7c220bb8dfcf68c86etrawick (Default = search)
ccc20788c1e5fc973f36df634399c89acb70deaejerenkrantz<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
273e512f20f262e5e2aa8e0e83371d1929fb76adjkaluza Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>.
efe780dcf13b2b95effabf897d694d8f23feac74trawick (Default = 53; abbreviation = po)
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
993d1261a278d7322bccef219101220b7b4fb8c5jkaluza<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
ba050a6f942b9fa0e81ed73437588005c569655ccovener Change the type of the information query.
135ddda3a989215d2bedbcf1529bfb269c3eda23niq (Default = A; abbreviations = q, ty)
001a44c352f89c9ec332ffd3e0a6927dcd19432chumbedooh <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
793214f67dede32edfd9ee96c664ead04d175cbbjfclere Tell the name server to query other servers if it does not
9b0076ddd1103e5fa9c1f9bafde4b06ce244fbaecovener information.
249d09d51808cb7981af99762c3b3736ca126cd5jkaluza (Default = recurse; abbreviation = [no]rec)
249d09d51808cb7981af99762c3b3736ca126cd5jkaluza<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
56589be3d7a3e9343370df240010c6928cc78b39jkaluza Set the number of retries to number.
77ca16c5676da23155311e13cee61e7eaba9fa3ejailletc<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
77ca16c5676da23155311e13cee61e7eaba9fa3ejailletc Change the initial timeout interval for waiting for a
77ca16c5676da23155311e13cee61e7eaba9fa3ejailletc reply to number seconds.
f87299dab99bc04b51a6b8cad51b6795db862c0atrawick <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>
4d12805e6c18253040223ea637acd6b3b3c18f60jorton Always use a virtual circuit when sending requests to the
a4df2cd1e1391575a327c2a90ba4315f805a0a78covener (Default = novc)
cb666b29f81df1d11d65002250153353568021fccovener <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt>
1c2cab00d988fc48cbe59032cf76cc0bab20d6f7covener Try the next nameserver if a nameserver responds with
6a80c3c6f4b8ea7ba5e89402b8b779b09ce020e0covener SERVFAIL or a referral (nofail) or terminate query
75a230a728338d84dcfe81edd375352f34de22d0covener (fail) on such a response.
1f50dc34ae069adeed20b2986e5ffdefa5c410e0covener (Default = nofail)
a511a29faf2ff7ead3b67680154a624effb31aafminfrin<p><span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>,
a511a29faf2ff7ead3b67680154a624effb31aafminfrin <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>,
a511a29faf2ff7ead3b67680154a624effb31aafminfrin <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>.
deec48c67d4786bc77112ffbf3a4e70b931097edminfrin Andrew Cherenson