d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
71cef386fae61275b03e203825680b39fedaa8c6Tinderbox User - Copyright (C) 2000-2018 Internet Systems Consortium, Inc. ("ISC")
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt - This Source Code Form is subject to the terms of the Mozilla Public
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt - License, v. 2.0. If a copy of the MPL was not distributed with this
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt - file, You can obtain one at http://mozilla.org/MPL/2.0/.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<link rel="prev" href="man.delv.html" title="delv">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<link rel="next" href="man.dnssec-checkds.html" title="dnssec-checkds">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<tr><th colspan="3" align="center">nslookup</th></tr>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<a accesskey="p" href="man.delv.html">Prev</a>�</td>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<a name="man.nslookup"></a><div class="titlepage"></div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User — query Internet name servers interactively
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><span class="command"><strong>Nslookup</strong></span>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt is a program to query Internet domain name servers. <span class="command"><strong>Nslookup</strong></span>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt has two modes: interactive and non-interactive. Interactive mode allows
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the user to query name servers for information about various hosts and
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt domains or to print a list of hosts in a domain. Non-interactive mode
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt used to print just the name and requested information for a host or
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Interactive mode is entered in the following cases:
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<div class="orderedlist"><ol class="orderedlist" type="a">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt when no arguments are given (the default name server will be used)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt when the first argument is a hyphen (-) and the second argument is
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the host name or Internet address of a name server.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Non-interactive mode is used when the name or Internet address of the
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt host to be looked up is given as the first argument. The optional second
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt argument specifies the host name or address of a name server.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Options can also be specified on the command line if they precede the
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt arguments and are prefixed with a hyphen. For example, to
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt change the default query type to host information, and the initial
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt timeout to 10 seconds, type:
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Huntnslookup -query=hinfo -timeout=10
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt The <code class="option">-version</code> option causes
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt <span class="command"><strong>nslookup</strong></span> to print the version
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt number and immediately exits.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<a name="id-1.14.6.9"></a><h2>INTERACTIVE COMMANDS</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <div class="variablelist"><dl class="variablelist">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Look up information for host using the current default server or
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt using server, if specified. If host is an Internet address and
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the query type is A or PTR, the name of the host is returned.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt If host is a name and does not have a trailing period, the
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt search list is used to qualify the name.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt To look up a host not in the current domain, append a period to
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the current default server. If an authoritative answer can't be
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt found, the names of servers that might have the answer are
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">root</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">finger</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">ls</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">view</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">help</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">?</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt not implemented
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">exit</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Exits the program.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">set</code>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt This command is used to change state information that affects
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the lookups. Valid keywords are:
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<div class="variablelist"><dl class="variablelist">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">all</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Prints the current values of the frequently used
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt options to <span class="command"><strong>set</strong></span>.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Information about the current default
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt server and host is also printed.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Change the query class to one of:
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<div class="variablelist"><dl class="variablelist">
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">IN</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the Internet class
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">CH</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the Chaos class
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">HS</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt the Hesiod class
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">ANY</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt The class specifies the protocol group of the information.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = IN; abbreviation = cl)
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Turn on or off the display of the full response packet and
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt any intermediate response packets when searching.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Turn debugging mode on or off. This displays more about
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt what nslookup is doing.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = nod2)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Sets the search list to <em class="replaceable"><code>name</code></em>.
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt If the lookup request contains at least one period but
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt doesn't end with a trailing period, append the domain
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt names in the domain search list to the request until an
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt answer is received.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = search)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = 53; abbreviation = po)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Change the type of the information query.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = A; abbreviations = q, ty)
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Tell the name server to query other servers if it does not
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt information.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = recurse; abbreviation = [no]rec)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">ndots=</code><em class="replaceable"><code>number</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Set the number of dots (label separators) in a domain
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt that will disable searching. Absolute names always
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt stop searching.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Set the number of retries to number.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Change the initial timeout interval for waiting for a
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt reply to number seconds.
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Always use a virtual circuit when sending requests to the
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = novc)
c32570b3191fdfb38a65567b8bb729fdb42ff847Tinderbox User<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt Try the next nameserver if a nameserver responds with
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt SERVFAIL or a referral (nofail) or terminate query
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (fail) on such a response.
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt (Default = nofail)
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt <span class="command"><strong>nslookup</strong></span> returns with an exit status of 1
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt if any query failed, and 0 otherwise.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><code class="filename">/etc/resolv.conf</code>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<a accesskey="p" href="man.delv.html">Prev</a>�</td>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="40%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="40%" align="left" valign="top">delv�</td>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
28a4d32b05736e13299fb10c6c0addfa88c3cf87Evan Hunt<td width="40%" align="right" valign="top">�<span class="application">dnssec-checkds</span>
c313914d0e66b20969215e519bbf2ab4ecf39512Tinderbox User<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.3 (Extended Support Version)</p>