nslookup.docbook revision 7d441a69eb59a4f6dd3ab1c3e02998a582a69e2e
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - Copyright (C) 2000-2002 Internet Software Consortium.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - Permission to use, copy, modify, and distribute this software for any
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - purpose with or without fee is hereby granted, provided that the above
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - copyright notice and this permission notice appear in all copies.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - PERFORMANCE OF THIS SOFTWARE.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<!-- $Id: nslookup.docbook,v 1.4 2004/08/20 00:54:29 marka Exp $ -->
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - Copyright (c) 1985, 1989
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - The Regents of the University of California. All rights reserved.
50066670817cdf9e86c832066d73715232b29680Tinderbox User - Redistribution and use in source and binary forms, with or without
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - modification, are permitted provided that the following conditions
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - 1. Redistributions of source code must retain the above copyright
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - notice, this list of conditions and the following disclaimer.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - 2. Redistributions in binary form must reproduce the above copyright
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - notice, this list of conditions and the following disclaimer in the
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - documentation and/or other materials provided with the distribution.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - 3. All advertising materials mentioning features or use of this software
50066670817cdf9e86c832066d73715232b29680Tinderbox User - must display the following acknowledgement:
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - This product includes software developed by the University of
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - California, Berkeley and its contributors.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - 4. Neither the name of the University nor the names of its contributors
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - may be used to endorse or promote products derived from this software
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - without specific prior written permission.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont - SUCH DAMAGE.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<refentryinfo>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont</refentryinfo>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<refpurpose>query Internet name servers interactively</refpurpose>
28b3569d6248168e6c00caab951521cc8141a49dAutomatic Updater<refsynopsisdiv>
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater</refsynopsisdiv>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupontis a program to query Internet domain name servers. <command>Nslookup</command>
2a31bd531072824ef252c18303859d6af7451b00Francis Duponthas two modes: interactive and non-interactive. Interactive mode allows
28b3569d6248168e6c00caab951521cc8141a49dAutomatic Updaterthe user to query name servers for information about various hosts and
2a31bd531072824ef252c18303859d6af7451b00Francis Dupontdomains or to print a list of hosts in a domain. Non-interactive mode is
2a31bd531072824ef252c18303859d6af7451b00Francis Dupontused to print just the name and requested information for a host or
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic UpdaterInteractive mode is entered in the following cases:
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox Userwhen no arguments are given (the default name server will be used)
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox Userwhen the first argument is a hyphen (-) and the second argument is
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox Userthe host name or Internet address of a name server.
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User</OrderedList>
2a31bd531072824ef252c18303859d6af7451b00Francis DupontNon-interactive mode is used when the name or Internet address of the
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userhost to be looked up is given as the first argument. The optional second
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userargument specifies the host name or address of a name server.
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox UserOptions can also be specified on the command line if they precede the
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userarguments and are prefixed with a hyphen. For example, to
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userchange the default query type to host information, and the initial timeout to 10 seconds, type:
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User<InformalExample>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User<PROGRAMLISTING>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Usernslookup -query=hinfo -timeout=10
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User</PROGRAMLISTING>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User</InformalExample>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User<variablelist>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User<varlistentry><term>host <optional>server</optional></term>
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox UserLook up information for host using the current default server or
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userusing server, if specified. If host is an Internet address and
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Userthe query type is A or PTR, the name of the host is returned.
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox UserIf host is a name and does not have a trailing period, the
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox Usersearch list is used to qualify the name.
2a31bd531072824ef252c18303859d6af7451b00Francis DupontTo look up a host not in the current domain, append a period to
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para></para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterChange the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updaterserver to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updaterthe current default server. If an authoritative answer can't be
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updaterfound, the names of servers that might have the answer are
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater<varlistentry><term><constant>root</constant></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater<listitem><para>not implemented</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>finger</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para>not implemented</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>ls</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para>not implemented</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>view</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para>not implemented</para></listitem></varlistentry>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater<varlistentry><term><constant>help</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para>not implemented</para></listitem></varlistentry>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater<varlistentry><term><constant>?</constant></term>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater<listitem><para>not implemented</para></listitem></varlistentry>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater<varlistentry><term><constant>exit</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<listitem><para>Exits the program.</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<varlistentry><term><constant>set</constant> <replaceable>keyword<optional>=value</optional></replaceable></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater<listitem><para>This command is used to change state information that affects
2a31bd531072824ef252c18303859d6af7451b00Francis Dupontthe lookups. Valid keywords are:
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <variablelist>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <varlistentry><term><constant>all</constant></term>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <para>Prints the current values of the frequently used
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont options to <command>set</command>. Information about the current default
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont server and host is also printed.
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater </varlistentry>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <varlistentry><term><constant>class=</constant><replaceable>value</replaceable></term>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater Change the query class to one of:
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <variablelist>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <varlistentry><term><constant>IN</constant></term>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <listitem><para>the Internet class</para></listitem></varlistentry>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <varlistentry><term><constant>CH</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <listitem><para>the Chaos class</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <varlistentry><term><constant>HS</constant></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <listitem><para>the Hesiod class</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <varlistentry><term><constant>ANY</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <listitem><para>wildcard</para></listitem></varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont </variablelist>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont The class specifies the protocol group of the information.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont (Default = IN; abbreviation = cl)
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont </varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont Turn debugging mode on. A lot more information is
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont printed about the packet sent to the server and the
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont resulting answer.
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater (Default = nodebug; abbreviation = <optional>no</optional>deb)
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>d2</constant></term>
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater Turn debugging mode on. A lot more information is
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater printed about the packet sent to the server and the
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater resulting answer.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont (Default = nod2)
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant>domain=</constant><replaceable>name</replaceable></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater Sets the search list to <replaceable>name</replaceable>.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>search</constant></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater If the lookup request contains at least one period but
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User doesn't end with a trailing period, append the domain
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User names in the domain search list to the request until an
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater answer is received.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater (Default = search)
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant>port=</constant><replaceable>value</replaceable></term>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Change the default TCP/UDP name server port to <replaceable>value</replaceable>.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater (Default = 53; abbreviation = po)
5a24d24c8fba3480d707c0c902379ddb36501e12Automatic Updater <varlistentry><term><constant>querytype=</constant><replaceable>value</replaceable></term>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater <listitem><para></para></listitem></varlistentry>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant>type=</constant><replaceable>value</replaceable></term>
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater Change the top of the information query.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater (Default = A; abbreviations = q, ty)
79cf9524b15ca65f55fd6913e6cf01b5581c588aAutomatic Updater <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>recurse</constant></term>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Tell the name server to query other servers if it does not have the
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater (Default = recurse; abbreviation = [no]rec)
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant>retry=</constant><replaceable>number</replaceable></term>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Set the number of retries to number.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <varlistentry><term><constant>timeout=</constant><replaceable>number</replaceable></term>
50066670817cdf9e86c832066d73715232b29680Tinderbox User Change the initial timeout interval for waiting for a
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont reply to number seconds.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>vc</constant></term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont Always use a virtual circuit when sending requests to the server.
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont (Default = novc)
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont </variablelist>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont</variablelist>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<citerefentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<refentrytitle>dig</refentrytitle><manvolnum>1</manvolnum>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont</citerefentry>,
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<citerefentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont<refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont</citerefentry>,
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater<refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont</citerefentry>.
2a31bd531072824ef252c18303859d6af7451b00Francis DupontAndrew Cherenson