man.nslookup.html revision 7e71f05d8643aca84914437c900cb716444507e4
ec79b29695b183f794264bbb578c51e93d1f9b1emartin - Copyright (C) 2000-2015 Internet Systems Consortium, Inc. ("ISC")
ee508128c414648982d1cca7801f63b01a0a4f8aminfrin - This Source Code Form is subject to the terms of the Mozilla Public
95aaebc2605a69993e61418bdfe88001c2b2a5a1rpluem - License, v. 2.0. If a copy of the MPL was not distributed with this
95aaebc2605a69993e61418bdfe88001c2b2a5a1rpluem - file, You can obtain one at http://mozilla.org/MPL/2.0/.
f8f4567683d2823be89e7e70c6cfc35971bbbd16rpluem<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
40b10b9bf464adaaf1bb0fab6c8a81a2f0b7c1a8trawick<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
40b10b9bf464adaaf1bb0fab6c8a81a2f0b7c1a8trawick<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
8390c33bd34fcd89af38984bb8a5e567705fccc4trawick<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
8390c33bd34fcd89af38984bb8a5e567705fccc4trawick<link rel="next" href="man.dnssec-checkds.html" title="dnssec-checkds">
391a534b1ff745e8543e7fa257cdee4fe7549048rpluem<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
3421353061bc845097d0c6f4d864122cf3933d47trawick<tr><th colspan="3" align="center">nslookup</th></tr>
95817edd05387a5276f51fcd5db79fc21b89b55brooneg<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
5714cdd83e23557d801437daa5e3ab8ba78ae595jorton<a name="man.nslookup"></a><div class="titlepage"></div>
dace23289120f3af62555d6754d80e9e51d4249erooneg<p>nslookup — query Internet name servers interactively</p>
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div>
a1a615ca49b162d71d88089210395c9a9cfeb539rpluem<p><span class="command"><strong>Nslookup</strong></span>
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes is a program to query Internet domain name servers. <span class="command"><strong>Nslookup</strong></span>
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes has two modes: interactive and non-interactive. Interactive mode allows
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes the user to query name servers for information about various hosts and
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes domains or to print a list of hosts in a domain. Non-interactive mode
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes used to print just the name and requested information for a host or
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes Interactive mode is entered in the following cases:
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes<div class="orderedlist"><ol class="orderedlist" type="a">
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes when no arguments are given (the default name server will be used)
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes when the first argument is a hyphen (-) and the second argument is
69c36bbae91de0e99a682aaae9d6fa61fceb2771bnicholes the host name or Internet address of a name server.
1b0dce86d7fc8a5aa4c89b05255be26e508c615crpluem Non-interactive mode is used when the name or Internet address of the
1b0dce86d7fc8a5aa4c89b05255be26e508c615crpluem host to be looked up is given as the first argument. The optional second
edc5389f50ce4153e6192740f3c7a188c8cf8d67niq argument specifies the host name or address of a name server.
6c05afd314b4ddd545d63b4ff5de822cc30eec79trawick Options can also be specified on the command line if they precede the
6c05afd314b4ddd545d63b4ff5de822cc30eec79trawick arguments and are prefixed with a hyphen. For example, to
13cd67e9c1dacbd6b9f040bda337c725cedd98f3brianp change the default query type to host information, and the initial
13cd67e9c1dacbd6b9f040bda337c725cedd98f3brianp timeout to 10 seconds, type:
a623efbff95aab78da9e030524b0fa69b054f6d0brianpnslookup -query=hinfo -timeout=10
2f1bb5376c5c4022383bb729679ca751dd75a2eabrianp The <code class="option">-version</code> option causes
2f1bb5376c5c4022383bb729679ca751dd75a2eabrianp <span class="command"><strong>nslookup</strong></span> to print the version
ad862ab5716726a2d72a292ba1dfb29566c86153brianp number and immediately exits.
17d53ea32c4968e47733f1c2c063ae07d280efd6jerenkrantz<div class="variablelist"><dl class="variablelist">
17d53ea32c4968e47733f1c2c063ae07d280efd6jerenkrantz<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
b38565306421ff53e9f7499bc728d6df5cec294dpquerna Look up information for host using the current default server or
b38565306421ff53e9f7499bc728d6df5cec294dpquerna using server, if specified. If host is an Internet address and
b38565306421ff53e9f7499bc728d6df5cec294dpquerna the query type is A or PTR, the name of the host is returned.
b38565306421ff53e9f7499bc728d6df5cec294dpquerna If host is a name and does not have a trailing period, the
cbb903af5066589fe0e73f3ecf06abdc71e38effrpluem search list is used to qualify the name.
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem To look up a host not in the current domain, append a period to
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem the current default server. If an authoritative answer can't be
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem found, the names of servers that might have the answer are
c9ce3d3ead2ba4ea6f5bb176745172f3538aed60rpluem<dt><span class="term"><code class="constant">root</code></span></dt>
c9ce3d3ead2ba4ea6f5bb176745172f3538aed60rpluem not implemented
c9ce3d3ead2ba4ea6f5bb176745172f3538aed60rpluem<dt><span class="term"><code class="constant">finger</code></span></dt>
c9ce3d3ead2ba4ea6f5bb176745172f3538aed60rpluem not implemented
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem<dt><span class="term"><code class="constant">ls</code></span></dt>
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem not implemented
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem<dt><span class="term"><code class="constant">view</code></span></dt>
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem not implemented
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem<dt><span class="term"><code class="constant">help</code></span></dt>
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem not implemented
0deb1a75b17945f30e56e81b851a2a2ab08af50drpluem<dt><span class="term"><code class="constant">?</code></span></dt>
0919d062982a9c9d2f4a8933ef54ccba2dd2b8f8rpluem not implemented
8e72243380282ce619a2c6bce8f8359b8d95306fjim<dt><span class="term"><code class="constant">exit</code></span></dt>
8e72243380282ce619a2c6bce8f8359b8d95306fjim Exits the program.
8e72243380282ce619a2c6bce8f8359b8d95306fjim <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim This command is used to change state information that affects
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim the lookups. Valid keywords are:
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim<dt><span class="term"><code class="constant">all</code></span></dt>
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim Prints the current values of the frequently used
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim options to <span class="command"><strong>set</strong></span>.
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim Information about the current default
317b1987e48bbdbfe8b1dcccdcf5cd6c10a26436jim server and host is also printed.
b9ebc87040e76abda075c91317cd0e1a7c9810e4trawick<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
b9ebc87040e76abda075c91317cd0e1a7c9810e4trawick Change the query class to one of:
b9ebc87040e76abda075c91317cd0e1a7c9810e4trawick<dt><span class="term"><code class="constant">IN</code></span></dt>
dc681b5cee49eb24c3ae8d6f50c4c9c9c05faa52rpluem the Internet class
2c3721611cc8d1ebd87b152e7d933a6dec23b3dcwrowe<dt><span class="term"><code class="constant">CH</code></span></dt>
2c3721611cc8d1ebd87b152e7d933a6dec23b3dcwrowe the Chaos class
2c3721611cc8d1ebd87b152e7d933a6dec23b3dcwrowe<dt><span class="term"><code class="constant">HS</code></span></dt>
2c3721611cc8d1ebd87b152e7d933a6dec23b3dcwrowe the Hesiod class
cbb903af5066589fe0e73f3ecf06abdc71e38effrpluem<dt><span class="term"><code class="constant">ANY</code></span></dt>
cbb903af5066589fe0e73f3ecf06abdc71e38effrpluem The class specifies the protocol group of the information.
cbb903af5066589fe0e73f3ecf06abdc71e38effrpluem (Default = IN; abbreviation = cl)
cbb903af5066589fe0e73f3ecf06abdc71e38effrpluem <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
c0bcd91f17456a06ce290005aab0d1e360482ea5rpluem Turn on or off the display of the full response packet and
c0bcd91f17456a06ce290005aab0d1e360482ea5rpluem any intermediate response packets when searching.
941fcca87a4607a388e88cff3fd0cdefc29bb81cjerenkrantz (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
d05d20b9ae48c6768f40277a76ed198d30aed06ajim <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
f6316e220101e5d4d99d82aab75ca7d668870942rpluem Turn debugging mode on or off. This displays more about
f6316e220101e5d4d99d82aab75ca7d668870942rpluem what nslookup is doing.
c83edb2f6bafd5f7013cd6bad78753a1e0c5fbe6jim (Default = nod2)
c83edb2f6bafd5f7013cd6bad78753a1e0c5fbe6jim<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
c83edb2f6bafd5f7013cd6bad78753a1e0c5fbe6jim Sets the search list to <em class="replaceable"><code>name</code></em>.
b7ad88322f8ea46b7ddac349956eed358b6980f1rpluem <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
b7ad88322f8ea46b7ddac349956eed358b6980f1rpluem If the lookup request contains at least one period but
b7ad88322f8ea46b7ddac349956eed358b6980f1rpluem doesn't end with a trailing period, append the domain
b7ad88322f8ea46b7ddac349956eed358b6980f1rpluem names in the domain search list to the request until an
b7ad88322f8ea46b7ddac349956eed358b6980f1rpluem answer is received.
06eb85bfb9e99bcf9c38c07c2434850543354d94rpluem (Default = search)
79d1d5666b3ceb59c959b09600aa2bce32324677rpluem<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt>
a6ea86151dd968120a12b48867d45947ef2bb9darpluem Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>.
a17ca1093e7dc28c1a54cfd9741f65653f5b2b19jim (Default = 53; abbreviation = po)
fa735cac4e86858f11c0de4f7cea50fa63eab87ecolm<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt>
dbb3b82abaa9c0ad199a0a3d6a7a505136137c61colm<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt>
3d76cdd5855071bbfb95a27de7d77a8855d1e893niq Change the type of the information query.
3d76cdd5855071bbfb95a27de7d77a8855d1e893niq (Default = A; abbreviations = q, ty)
3d76cdd5855071bbfb95a27de7d77a8855d1e893niq <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
bf0dec31a67271a4a67a6d3a3a9b3cdb41278390rpluem Tell the name server to query other servers if it does not
7612604db51e61f6ec4a6593c188e6d0640646abwrowe information.
7612604db51e61f6ec4a6593c188e6d0640646abwrowe (Default = recurse; abbreviation = [no]rec)
0a2c6381b34b977101327f412a4b1ddc8a361ae7rpluem<dt><span class="term"><code class="constant">ndots=</code><em class="replaceable"><code>number</code></em></span></dt>
0a2c6381b34b977101327f412a4b1ddc8a361ae7rpluem Set the number of dots (label separators) in a domain
0a2c6381b34b977101327f412a4b1ddc8a361ae7rpluem that will disable searching. Absolute names always
8828f8c859fabac8c0080440392bc279877f9802rpluem stop searching.
8828f8c859fabac8c0080440392bc279877f9802rpluem<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
0830215c2542165c027f092c18924f2885c98b49trawick Set the number of retries to number.
0830215c2542165c027f092c18924f2885c98b49trawick<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
8f1c5a2aca731a7676bf74cdce67ec28557ec299trawick Change the initial timeout interval for waiting for a
bc886ee8559b4feb30d32dc8a50ba2c013c3cc02trawick reply to number seconds.
9505e1a9012d92bfd2b6228e675156f44a27aa04colm <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>
3aeb30211790fef38a8297f990b7ad3b2c46ece9colm Always use a virtual circuit when sending requests to the
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton (Default = novc)
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt>
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton Try the next nameserver if a nameserver responds with
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton SERVFAIL or a referral (nofail) or terminate query
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton (fail) on such a response.
70706a4d1ead0d72a443eac1cc446a0f1a4de069colm (Default = nofail)
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton <span class="command"><strong>nslookup</strong></span> returns with an exit status of 1
2e02c854b4531480fe3f7ab353154c99c5bd97e8jorton if any query failed, and 0 otherwise.
a09378e32e823d5619f766394fcdde1cfa16c5dajim<p><span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>,
ce8e09ffeb8c696f7fc6c5dfa8814c52caaac59bcolm <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>,
ce8e09ffeb8c696f7fc6c5dfa8814c52caaac59bcolm <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>.
f8ae06c7d0615d8b9441099794fe80a3f2915469colm<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
f8ae06c7d0615d8b9441099794fe80a3f2915469colm<td width="40%" align="right">�<a accesskey="n" href="man.dnssec-checkds.html">Next</a>
6eb3a057b5e4f046faba79104d7941552de755dacolm<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
be2abc811ae62b872703a7b43235598d641f8d8dmjc<td width="40%" align="right" valign="top">�<span class="application">dnssec-checkds</span>
1febae173a82bc2a71c3c0ba4105cf674000791bjim<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.0rc1</p>