nslookup.html revision c32570b3191fdfb38a65567b8bb729fdb42ff847
c40265eba0c99708887d68e67901924065ba2514Brian Wellington<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2004-2007, 2010, 2013-2017 Internet Systems Consortium, Inc. ("ISC")
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - This Source Code Form is subject to the terms of the Mozilla Public
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - License, v. 2.0. If a copy of the MPL was not distributed with this
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - file, You can obtain one at http://mozilla.org/MPL/2.0/.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
c40265eba0c99708887d68e67901924065ba2514Brian Wellington<a name="man.nslookup"></a><div class="titlepage"></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein — query Internet name servers interactively
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews <p><span class="command"><strong>Nslookup</strong></span>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews is a program to query Internet domain name servers. <span class="command"><strong>Nslookup</strong></span>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews has two modes: interactive and non-interactive. Interactive mode allows
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews the user to query name servers for information about various hosts and
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews domains or to print a list of hosts in a domain. Non-interactive mode
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews used to print just the name and requested information for a host or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Interactive mode is entered in the following cases:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="orderedlist"><ol class="orderedlist" type="a">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein when no arguments are given (the default name server will be used)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein when the first argument is a hyphen (-) and the second argument is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the host name or Internet address of a name server.
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews Non-interactive mode is used when the name or Internet address of the
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews host to be looked up is given as the first argument. The optional second
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews argument specifies the host name or address of a name server.
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews Options can also be specified on the command line if they precede the
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews arguments and are prefixed with a hyphen. For example, to
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews change the default query type to host information, and the initial
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews timeout to 10 seconds, type:
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrewsnslookup -query=hinfo -timeout=10
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews The <code class="option">-version</code> option causes
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews <span class="command"><strong>nslookup</strong></span> to print the version
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews number and immediately exits.
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews<a name="id-1.9"></a><h2>INTERACTIVE COMMANDS</h2>
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews <div class="variablelist"><dl class="variablelist">
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews Look up information for host using the current default server or
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews using server, if specified. If host is an Internet address and
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews the query type is A or PTR, the name of the host is returned.
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews If host is a name and does not have a trailing period, the
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews search list is used to qualify the name.
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews To look up a host not in the current domain, append a period to
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews the current default server. If an authoritative answer can't be
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews found, the names of servers that might have the answer are
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">root</code></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">finger</code></span></dt>
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews not implemented
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews<dt><span class="term"><code class="constant">ls</code></span></dt>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews not implemented
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews<dt><span class="term"><code class="constant">view</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">help</code></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">?</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not implemented
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">exit</code></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews Exits the program.
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">set</code>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews This command is used to change state information that affects
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews the lookups. Valid keywords are:
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<div class="variablelist"><dl class="variablelist">
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews<dt><span class="term"><code class="constant">all</code></span></dt>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews Prints the current values of the frequently used
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews options to <span class="command"><strong>set</strong></span>.
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews Information about the current default
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews server and host is also printed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Change the query class to one of:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="variablelist"><dl class="variablelist">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">IN</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the Internet class
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">CH</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the Chaos class
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">HS</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the Hesiod class
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant">ANY</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The class specifies the protocol group of the information.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = IN; abbreviation = cl)
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn on or off the display of the full response packet and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein any intermediate response packets when searching.
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn debugging mode on or off. This displays more about
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews what nslookup is doing.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Default = nod2)
<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt>
<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt>
<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>
<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt>
<dt><span class="term"><code class="constant">ndots=</code><em class="replaceable"><code>number</code></em></span></dt>
<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt>
<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt>
<dt><span class="term"><code class="constant"><em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt>