1N/A - Copyright (C) 2000-2018 Internet Systems Consortium, Inc. ("ISC") 1N/A - This Source Code Form is subject to the terms of the Mozilla Public 1N/A - License, v. 2.0. If a copy of the MPL was not distributed with this 1N/A<
meta http-
equiv="Content-Type" content="text/html; charset=ISO-8859-1">
1N/A<
title>nslookup</
title>
1N/A<
meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
1N/A<
link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
1N/A<
body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
1N/A<
div class="navheader">
1N/A<
table width="100%" summary="Navigation header">
1N/A<
tr><
th colspan="3" align="center">nslookup</
th></
tr>
1N/A<
td width="20%" align="left">
1N/A<
th width="60%" align="center">Manual pages</
th>
1N/A<
div class="refentry">
1N/A <
div class="refnamediv">
1N/A — query Internet name servers interactively
1N/A <
div class="refsynopsisdiv">
1N/A <
div class="cmdsynopsis"><
p>
1N/A <
code class="command">nslookup</
code>
1N/A [<
code class="option">-option</
code>]
1N/A <
div class="refsection">
1N/A<
a name="id-1.14.6.7"></
a><
h2>DESCRIPTION</
h2>
1N/A <
p><
span class="command"><
strong>Nslookup</
strong></
span>
1N/A is a program to query Internet domain name servers. <
span class="command"><
strong>Nslookup</
strong></
span>
1N/A has two modes: interactive and non-interactive. Interactive mode allows
1N/A the user to query name servers for information about various hosts and
1N/A domains or to print a list of hosts in a domain. Non-interactive mode
1N/A used to print just the name and requested information for a host or
1N/A <
div class="refsection">
1N/A<
a name="id-1.14.6.8"></
a><
h2>ARGUMENTS</
h2>
1N/A Interactive mode is entered in the following cases:
1N/A<
div class="orderedlist"><
ol class="orderedlist" type="a">
1N/A<
li class="listitem">
1N/A when no arguments are given (the default name server will be used)
1N/A<
li class="listitem">
1N/A when the first argument is a hyphen (-) and the second argument is
1N/A the host name or Internet address of a name server.
1N/A Non-interactive mode is used when the name or Internet address of the
1N/A host to be looked up is given as the first argument. The optional second
1N/A argument specifies the host name or address of a name server.
1N/A Options can also be specified on the command line if they precede the
1N/A arguments and are prefixed with a hyphen. For example, to
1N/A change the default query type to host information, and the initial
1N/A timeout to 10 seconds, type:
1N/A<
pre class="programlisting">
1N/Anslookup -query=hinfo -timeout=10
1N/A The <
code class="option">-version</
code> option causes
1N/A <
span class="command"><
strong>nslookup</
strong></
span> to print the version
1N/A number and immediately exits.
1N/A <
div class="refsection">
1N/A<
a name="id-1.14.6.9"></
a><
h2>INTERACTIVE COMMANDS</
h2>
1N/A <
div class="variablelist"><
dl class="variablelist">
1N/A<
dt><
span class="term"><
code class="constant">host</
code> [<
span class="optional">server</
span>]</
span></
dt>
1N/A Look up information for host using the current default server or
1N/A using server, if specified. If host is an Internet address and
1N/A the query type is A or PTR, the name of the host is returned.
1N/A If host is a name and does not have a trailing period, the
1N/A search list is used to qualify the name.
1N/A To look up a host not in the current domain, append a period to
1N/A<
dt><
span class="term"><
code class="constant">server</
code> <
em class="replaceable"><
code>domain</
code></
em></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">lserver</
code> <
em class="replaceable"><
code>domain</
code></
em></
span></
dt>
1N/A Change the default server to <
em class="replaceable"><
code>domain</
code></
em>; <
code class="constant">lserver</
code> uses the initial
1N/A server to look up information about <
em class="replaceable"><
code>domain</
code></
em>, while <
code class="constant">server</
code> uses
1N/A the current default server. If an authoritative answer can't be
1N/A found, the names of servers that might have the answer are
1N/A<
dt><
span class="term"><
code class="constant">root</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">finger</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">ls</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">view</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">help</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">?</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">exit</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">set</
code>
1N/A <
em class="replaceable"><
code>keyword[<
span class="optional">=value</
span>]</
code></
em></
span></
dt>
1N/A This command is used to change state information that affects
1N/A the lookups. Valid keywords are:
1N/A<
div class="variablelist"><
dl class="variablelist">
1N/A<
dt><
span class="term"><
code class="constant">all</
code></
span></
dt>
1N/A Prints the current values of the frequently used
1N/A options to <
span class="command"><
strong>set</
strong></
span>.
1N/A Information about the current default
1N/A server and host is also printed.
1N/A<
dt><
span class="term"><
code class="constant">class=</
code><
em class="replaceable"><
code>value</
code></
em></
span></
dt>
1N/A Change the query class to one of:
1N/A<
div class="variablelist"><
dl class="variablelist">
1N/A<
dt><
span class="term"><
code class="constant">IN</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">CH</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">HS</
code></
span></
dt>
1N/A<
dt><
span class="term"><
code class="constant">ANY</
code></
span></
dt>
1N/A The class specifies the protocol group of the information.
1N/A (Default = IN; abbreviation = cl)
1N/A<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>debug</
code></
span></
dt>
1N/A Turn on or off the display of the full response packet and
1N/A any intermediate response packets when searching.
1N/A (Default = nodebug; abbreviation = [<
span class="optional">no</
span>]deb)
1N/A<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>d2</
code></
span></
dt>
1N/A Turn debugging mode on or off. This displays more about
1N/A what nslookup is doing.
1N/A<
dt><
span class="term"><
code class="constant">domain=</
code><
em class="replaceable"><
code>name</
code></
em></
span></
dt>
1N/A Sets the search list to <
em class="replaceable"><
code>name</
code></
em>.
<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>search</
code></
span></
dt>
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
<
dt><
span class="term"><
code class="constant">port=</
code><
em class="replaceable"><
code>value</
code></
em></
span></
dt>
Change the default
TCP/
UDP name server port to <
em class="replaceable"><
code>value</
code></
em>.
(Default = 53; abbreviation = po)
<
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>
Change the type of the information query.
(Default = A; abbreviations = q, ty)
<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>recurse</
code></
span></
dt>
Tell the name server to query other servers if it does not
(Default = recurse; abbreviation = [no]rec)
<
dt><
span class="term"><
code class="constant">ndots=</
code><
em class="replaceable"><
code>number</
code></
em></
span></
dt>
Set the number of dots (label separators) in a domain
that will disable searching. Absolute names always
<
dt><
span class="term"><
code class="constant">retry=</
code><
em class="replaceable"><
code>number</
code></
em></
span></
dt>
Set the number of retries to number.
<
dt><
span class="term"><
code class="constant">timeout=</
code><
em class="replaceable"><
code>number</
code></
em></
span></
dt>
Change the initial timeout interval for waiting for a
<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>vc</
code></
span></
dt>
Always use a virtual circuit when sending requests to the
<
dt><
span class="term"><
code class="constant"><
em class="replaceable"><
code>[<
span class="optional">no</
span>]</
code></
em>fail</
code></
span></
dt>
Try the next nameserver if a nameserver responds with
SERVFAIL or a referral (nofail) or terminate query
(fail) on such a response.
<
a name="id-1.14.6.10"></
a><
h2>RETURN VALUES</
h2>
<
span class="command"><
strong>nslookup</
strong></
span> returns with an exit status of 1
if any query failed, and 0 otherwise.
<
a name="id-1.14.6.11"></
a><
h2>FILES</
h2>
<
a name="id-1.14.6.12"></
a><
h2>SEE ALSO</
h2>
<
p><
span class="citerefentry">
<
span class="refentrytitle">dig</
span>(1)
<
span class="citerefentry">
<
span class="refentrytitle">host</
span>(1)
<
span class="citerefentry">
<
span class="refentrytitle">named</
span>(8)
<
table width="100%" summary="Navigation footer">
<
td width="40%" align="left">
<
td width="20%" align="center"><
a accesskey="u" href="Bv9ARM.ch13.html">Up</
a></
td>
<
td width="40%" align="left" valign="top">delv�</
td>
<
td width="20%" align="center"><
a accesskey="h" href="Bv9ARM.html">Home</
a></
td>
<
td width="40%" align="right" valign="top">�<
span class="application">dnssec-checkds</
span>