diff options
Diffstat (limited to 'bin/dig/nslookup.html')
| -rw-r--r-- | bin/dig/nslookup.html | 307 |
1 files changed, 307 insertions, 0 deletions
diff --git a/bin/dig/nslookup.html b/bin/dig/nslookup.html new file mode 100644 index 0000000..0f38176 --- /dev/null +++ b/bin/dig/nslookup.html @@ -0,0 +1,307 @@ +<!-- + - Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC") + - + - Permission to use, copy, modify, and distribute this software for any + - purpose with or without fee is hereby granted, provided that the above + - copyright notice and this permission notice appear in all copies. + - + - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH + - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, + - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM + - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE + - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR + - PERFORMANCE OF THIS SOFTWARE. +--> +<!-- $Id: nslookup.html,v 1.21 2007/05/16 06:12:01 marka Exp $ --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>nslookup</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.71.1"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> +<a name="id2476276"></a><div class="titlepage"></div> +<div class="refnamediv"> +<h2>Name</h2> +<p>nslookup — query Internet name servers interactively</p> +</div> +<div class="refsynopsisdiv"> +<h2>Synopsis</h2> +<div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div> +</div> +<div class="refsect1" lang="en"> +<a name="id2543355"></a><h2>DESCRIPTION</h2> +<p><span><strong class="command">Nslookup</strong></span> + is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span> + has two modes: interactive and non-interactive. Interactive mode allows + the user to query name servers for information about various hosts and + domains or to print a list of hosts in a domain. Non-interactive mode + is + used to print just the name and requested information for a host or + domain. + </p> +</div> +<div class="refsect1" lang="en"> +<a name="id2543371"></a><h2>ARGUMENTS</h2> +<p> + Interactive mode is entered in the following cases: + </p> +<div class="orderedlist"><ol type="a"> +<li><p> + when no arguments are given (the default name server will be used) + </p></li> +<li><p> + when the first argument is a hyphen (-) and the second argument is + the host name or Internet address of a name server. + </p></li> +</ol></div> +<p> + </p> +<p> + Non-interactive mode is used when the name or Internet address of the + host to be looked up is given as the first argument. The optional second + argument specifies the host name or address of a name server. + </p> +<p> + Options can also be specified on the command line if they precede the + arguments and are prefixed with a hyphen. For example, to + change the default query type to host information, and the initial + timeout to 10 seconds, type: + </p> +<div class="informalexample"><pre class="programlisting"> +nslookup -query=hinfo -timeout=10 +</pre></div> +<p> + </p> +</div> +<div class="refsect1" lang="en"> +<a name="id2543413"></a><h2>INTERACTIVE COMMANDS</h2> +<div class="variablelist"><dl> +<dt><span class="term"><code class="constant">host</code> [<span class="optional">server</span>]</span></dt> +<dd> +<p> + Look up information for host using the current default server or + using server, if specified. If host is an Internet address and + the query type is A or PTR, the name of the host is returned. + If host is a name and does not have a trailing period, the + search list is used to qualify the name. + </p> +<p> + To look up a host not in the current domain, append a period to + the name. + </p> +</dd> +<dt><span class="term"><code class="constant">server</code> <em class="replaceable"><code>domain</code></em></span></dt> +<dd><p></p></dd> +<dt><span class="term"><code class="constant">lserver</code> <em class="replaceable"><code>domain</code></em></span></dt> +<dd><p> + Change the default server to <em class="replaceable"><code>domain</code></em>; <code class="constant">lserver</code> uses the initial + server to look up information about <em class="replaceable"><code>domain</code></em>, while <code class="constant">server</code> uses + the current default server. If an authoritative answer can't be + found, the names of servers that might have the answer are + returned. + </p></dd> +<dt><span class="term"><code class="constant">root</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">finger</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">ls</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">view</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">help</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">?</code></span></dt> +<dd><p> + not implemented + </p></dd> +<dt><span class="term"><code class="constant">exit</code></span></dt> +<dd><p> + Exits the program. + </p></dd> +<dt><span class="term"><code class="constant">set</code> + <em class="replaceable"><code>keyword[<span class="optional">=value</span>]</code></em></span></dt> +<dd> +<p> + This command is used to change state information that affects + the lookups. Valid keywords are: + </p> +<div class="variablelist"><dl> +<dt><span class="term"><code class="constant">all</code></span></dt> +<dd><p> + Prints the current values of the frequently used + options to <span><strong class="command">set</strong></span>. + Information about the current default + server and host is also printed. + </p></dd> +<dt><span class="term"><code class="constant">class=</code><em class="replaceable"><code>value</code></em></span></dt> +<dd> +<p> + Change the query class to one of: + </p> +<div class="variablelist"><dl> +<dt><span class="term"><code class="constant">IN</code></span></dt> +<dd><p> + the Internet class + </p></dd> +<dt><span class="term"><code class="constant">CH</code></span></dt> +<dd><p> + the Chaos class + </p></dd> +<dt><span class="term"><code class="constant">HS</code></span></dt> +<dd><p> + the Hesiod class + </p></dd> +<dt><span class="term"><code class="constant">ANY</code></span></dt> +<dd><p> + wildcard + </p></dd> +</dl></div> +<p> + The class specifies the protocol group of the information. + + </p> +<p> + (Default = IN; abbreviation = cl) + </p> +</dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>debug</code></span></dt> +<dd> +<p> + Turn on or off the display of the full response packet and + any intermediate response packets when searching. + </p> +<p> + (Default = nodebug; abbreviation = [<span class="optional">no</span>]deb) + </p> +</dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>d2</code></span></dt> +<dd> +<p> + Turn debugging mode on or off. This displays more about + what nslookup is doing. + </p> +<p> + (Default = nod2) + </p> +</dd> +<dt><span class="term"><code class="constant">domain=</code><em class="replaceable"><code>name</code></em></span></dt> +<dd><p> + Sets the search list to <em class="replaceable"><code>name</code></em>. + </p></dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>search</code></span></dt> +<dd> +<p> + 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 + answer is received. + </p> +<p> + (Default = search) + </p> +</dd> +<dt><span class="term"><code class="constant">port=</code><em class="replaceable"><code>value</code></em></span></dt> +<dd> +<p> + Change the default TCP/UDP name server port to <em class="replaceable"><code>value</code></em>. + </p> +<p> + (Default = 53; abbreviation = po) + </p> +</dd> +<dt><span class="term"><code class="constant">querytype=</code><em class="replaceable"><code>value</code></em></span></dt> +<dd><p></p></dd> +<dt><span class="term"><code class="constant">type=</code><em class="replaceable"><code>value</code></em></span></dt> +<dd> +<p> + Change the type of the information query. + </p> +<p> + (Default = A; abbreviations = q, ty) + </p> +</dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>recurse</code></span></dt> +<dd> +<p> + Tell the name server to query other servers if it does not + have the + information. + </p> +<p> + (Default = recurse; abbreviation = [no]rec) + </p> +</dd> +<dt><span class="term"><code class="constant">retry=</code><em class="replaceable"><code>number</code></em></span></dt> +<dd><p> + Set the number of retries to number. + </p></dd> +<dt><span class="term"><code class="constant">timeout=</code><em class="replaceable"><code>number</code></em></span></dt> +<dd><p> + Change the initial timeout interval for waiting for a + reply to number seconds. + </p></dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>vc</code></span></dt> +<dd> +<p> + Always use a virtual circuit when sending requests to the + server. + </p> +<p> + (Default = novc) + </p> +</dd> +<dt><span class="term"><code class="constant"> + <em class="replaceable"><code>[<span class="optional">no</span>]</code></em>fail</code></span></dt> +<dd> +<p> + Try the next nameserver if a nameserver responds with + SERVFAIL or a referral (nofail) or terminate query + (fail) on such a response. + </p> +<p> + (Default = nofail) + </p> +</dd> +</dl></div> +<p> + </p> +</dd> +</dl></div> +</div> +<div class="refsect1" lang="en"> +<a name="id2546279"></a><h2>FILES</h2> +<p><code class="filename">/etc/resolv.conf</code> + </p> +</div> +<div class="refsect1" lang="en"> +<a name="id2546291"></a><h2>SEE ALSO</h2> +<p><span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>, + <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>, + <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>. + </p> +</div> +<div class="refsect1" lang="en"> +<a name="id2546325"></a><h2>Author</h2> +<p> + Andrew Cherenson + </p> +</div> +</div></body> +</html> |