0N/A<!
DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN" 0N/A [<!ENTITY mdash "—">]>
0N/A - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") 0N/A - Permission to use, copy, modify, and distribute this software for any 0N/A - purpose with or without fee is hereby granted, provided that the above 0N/A - copyright notice and this permission notice appear in all copies. 0N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 0N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 0N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 0N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 0N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 0N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 0N/A - PERFORMANCE OF THIS SOFTWARE. 0N/A - Copyright (c) 1985, 1989 0N/A - The Regents of the University of California. All rights reserved. 0N/A - Redistribution and use in source and binary forms, with or without 0N/A - modification, are permitted provided that the following conditions 0N/A - 1. Redistributions of source code must retain the above copyright 0N/A - notice, this list of conditions and the following disclaimer. 0N/A - 2. Redistributions in binary form must reproduce the above copyright 0N/A - notice, this list of conditions and the following disclaimer in the 0N/A - documentation and/or other materials provided with the distribution. 0N/A - 3. All advertising materials mentioning features or use of this software 0N/A - must display the following acknowledgement: 0N/A - This product includes software developed by the University of 0N/A - California, Berkeley and its contributors. 0N/A - 4. Neither the name of the University nor the names of its contributors 0N/A - may be used to endorse or promote products derived from this software 0N/A - without specific prior written permission. 0N/A - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 0N/A - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 0N/A - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 0N/A - ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 0N/A - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 0N/A - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 0N/A - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 0N/A - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 0N/A - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 0N/A - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 0N/A <
date>Jun 30, 2000</
date>
0N/A <
refentrytitle>nslookup</
refentrytitle>
0N/A <
manvolnum>1</
manvolnum>
0N/A <
refmiscinfo>BIND9</
refmiscinfo>
0N/A <
refname>nslookup</
refname>
0N/A <
refpurpose>query Internet name servers interactively</
refpurpose>
0N/A <
holder>Internet Systems Consortium, Inc. ("ISC")</
holder>
0N/A <
command>nslookup</
command>
0N/A <
arg><
option>-option</
option></
arg>
0N/A <
arg choice="opt">name | -</
arg>
0N/A <
arg choice="opt">server</
arg>
0N/A <
title>DESCRIPTION</
title>
0N/A <
para><
command>Nslookup</
command>
0N/A is a program to query Internet domain name servers. <
command>Nslookup</
command>
0N/A has two modes: interactive and non-interactive. Interactive mode allows
0N/A the user to query name servers for information about various hosts and
0N/A domains or to print a list of hosts in a domain. Non-interactive mode
0N/A used to print just the name and requested information for a host or
0N/A <
title>ARGUMENTS</
title>
0N/A Interactive mode is entered in the following cases:
0N/A <
orderedlist numeration="loweralpha">
0N/A when no arguments are given (the default name server will be used)
0N/A when the first argument is a hyphen (-) and the second argument is
0N/A the host name or Internet address of a name server.
0N/A Non-interactive mode is used when the name or Internet address of the
0N/A host to be looked up is given as the first argument. The optional second
0N/A argument specifies the host name or address of a name server.
0N/A Options can also be specified on the command line if they precede the
0N/A arguments and are prefixed with a hyphen. For example, to
0N/A change the default query type to host information, and the initial
0N/A timeout to 10 seconds, type:
0N/Anslookup -query=hinfo -timeout=10
0N/A <
title>INTERACTIVE COMMANDS</
title>
0N/A <
term>host <
optional>server</
optional></
term>
0N/A Look up information for host using the current default server or
0N/A using server, if specified. If host is an Internet address and
0N/A the query type is A or PTR, the name of the host is returned.
0N/A If host is a name and does not have a trailing period, the
0N/A search list is used to qualify the name.
0N/A To look up a host not in the current domain, append a period to
0N/A <
term><
constant>server</
constant> <
replaceable class="parameter">domain</
replaceable></
term>
0N/A <
term><
constant>lserver</
constant> <
replaceable class="parameter">domain</
replaceable></
term>
0N/A Change the default server to <
replaceable>domain</
replaceable>; <
constant>lserver</
constant> uses the initial
0N/A server to look up information about <
replaceable>domain</
replaceable>, while <
constant>server</
constant> uses
0N/A the current default server. If an authoritative answer can't be
0N/A found, the names of servers that might have the answer are
0N/A <
term><
constant>root</
constant></
term>
0N/A <
term><
constant>finger</
constant></
term>
0N/A <
term><
constant>ls</
constant></
term>
0N/A <
term><
constant>view</
constant></
term>
0N/A <
term><
constant>help</
constant></
term>
0N/A <
term><
constant>?</
constant></
term>
0N/A <
term><
constant>exit</
constant></
term>
0N/A <
term><
constant>set</
constant>
0N/A <
replaceable>keyword<
optional>=value</
optional></
replaceable></
term>
0N/A This command is used to change state information that affects
0N/A the lookups. Valid keywords are:
0N/A <
term><
constant>all</
constant></
term>
0N/A Prints the current values of the frequently used
0N/A options to <
command>set</
command>.
0N/A Information about the current default
0N/A server and host is also printed.
0N/A <
term><
constant>class=</
constant><
replaceable>value</
replaceable></
term>
0N/A Change the query class to one of:
0N/A <
term><
constant>IN</
constant></
term>
0N/A <
term><
constant>CH</
constant></
term>
0N/A <
term><
constant>HS</
constant></
term>
0N/A <
term><
constant>ANY</
constant></
term>
0N/A The class specifies the protocol group of the information.
0N/A (Default = IN; abbreviation = cl)
0N/A <
replaceable><
optional>no</
optional></
replaceable>debug</
constant></
term>
0N/A Turn debugging mode on. A lot more information is
0N/A printed about the packet sent to the server and the
0N/A (Default = nodebug; abbreviation = <
optional>no</
optional>deb)
0N/A <
replaceable><
optional>no</
optional></
replaceable>d2</
constant></
term>
0N/A Turn debugging mode on. A lot more information is
0N/A printed about the packet sent to the server and the
0N/A <
term><
constant>domain=</
constant><
replaceable>name</
replaceable></
term>
0N/A Sets the search list to <
replaceable>name</
replaceable>.
0N/A <
replaceable><
optional>no</
optional></
replaceable>search</
constant></
term>
0N/A If the lookup request contains at least one period but
0N/A doesn't end with a trailing period, append the domain
0N/A names in the domain search list to the request until an
0N/A <
term><
constant>port=</
constant><
replaceable>value</
replaceable></
term>
0N/A Change the default
TCP/
UDP name server port to <
replaceable>value</
replaceable>.
0N/A (Default = 53; abbreviation = po)
0N/A <
term><
constant>querytype=</
constant><
replaceable>value</
replaceable></
term>
0N/A <
term><
constant>type=</
constant><
replaceable>value</
replaceable></
term>
0N/A Change the top of the information query.
0N/A (Default = A; abbreviations = q, ty)
0N/A <
replaceable><
optional>no</
optional></
replaceable>recurse</
constant></
term>
0N/A Tell the name server to query other servers if it does not
0N/A (Default = recurse; abbreviation = [no]rec)
0N/A <
term><
constant>retry=</
constant><
replaceable>number</
replaceable></
term>
0N/A Set the number of retries to number.
0N/A <
term><
constant>timeout=</
constant><
replaceable>number</
replaceable></
term>
0N/A Change the initial timeout interval for waiting for a
0N/A reply to number seconds.
0N/A <
replaceable><
optional>no</
optional></
replaceable>vc</
constant></
term>
0N/A Always use a virtual circuit when sending requests to the
0N/A <
replaceable><
optional>no</
optional></
replaceable>fail</
constant></
term>
0N/A Try the next nameserver if a nameserver responds with
0N/A SERVFAIL or a referral (nofail) or terminate query
0N/A (fail) on such a response.
0N/A <
title>FILES</
title>
0N/A <
title>SEE ALSO</
title>
0N/A <
para><
citerefentry>
0N/A <
refentrytitle>dig</
refentrytitle><
manvolnum>1</
manvolnum>
0N/A <
refentrytitle>host</
refentrytitle><
manvolnum>1</
manvolnum>
0N/A <
refentrytitle>named</
refentrytitle><
manvolnum>8</
manvolnum>
0N/A <
title>Author</
title>