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