nslookup.docbook revision 819fe493f97078521bb6b9a7b97583bef89f5abc
414N/A<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
553N/A<!--
414N/A - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
414N/A - Copyright (C) 2000-2002 Internet Software Consortium.
414N/A -
414N/A - Permission to use, copy, modify, and distribute this software for any
414N/A - purpose with or without fee is hereby granted, provided that the above
414N/A - copyright notice and this permission notice appear in all copies.
414N/A -
414N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
414N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
414N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
414N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
414N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
414N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
414N/A - PERFORMANCE OF THIS SOFTWARE.
414N/A-->
414N/A
553N/A<!-- $Id: nslookup.docbook,v 1.1 2004/08/16 04:20:59 marka Exp $ -->
553N/A
553N/A<refentry>
414N/A
414N/A<refentryinfo>
414N/A<date>Jun 30, 2000</date>
414N/A</refentryinfo>
414N/A
414N/A<refmeta>
414N/A<refentrytitle>nslookup</refentrytitle>
414N/A<manvolnum>1</manvolnum>
414N/A<refmiscinfo>BIND9</refmiscinfo>
414N/A</refmeta>
414N/A
414N/A<refnamediv>
414N/A<refname>nslookup</refname>
414N/A<refpurpose>query Internet name servers interactively</refpurpose>
414N/A</refnamediv>
414N/A
414N/A<refsynopsisdiv>
414N/A<cmdsynopsis>
414N/A <command>nslookup</command>
414N/A <arg><option>-option</option></arg>
414N/A <arg choice=opt>name | -</arg>
414N/A <arg choice=opt>server</arg>
414N/A</cmdsynopsis>
414N/A</refsynopsisdiv>
414N/A
414N/A<refsect1>
414N/A<title>DESCRIPTION</title>
414N/A<para>
414N/A<command>Nslookup</command>
414N/Ais a program to query Internet domain name servers. <command>Nslookup</command>
414N/Ahas two modes: interactive and non-interactive. Interactive mode allows
414N/Athe user to query name servers for information about various hosts and
414N/Adomains or to print a list of hosts in a domain. Non-interactive mode is
414N/Aused to print just the name and requested information for a host or
414N/Adomain.
414N/A</para>
414N/A</refsect1>
414N/A
414N/A<refsect1>
414N/A<title>ARGUMENTS</title>
414N/A<para>
414N/AInteractive mode is entered in the following cases:
414N/A<OrderedList Numeration=Loweralpha>
414N/A<Listitem>
414N/A<para>
414N/Awhen no arguments are given (the default name server will be used)
414N/A</para>
414N/A</Listitem>
414N/A<Listitem>
414N/A<para>
414N/Awhen the first argument is a hyphen (-) and the second argument is
414N/Athe host name or Internet address of a name server.
414N/A</para>
414N/A</Listitem>
414N/A</OrderedList>
414N/A</para>
414N/A
414N/A<para>
414N/ANon-interactive mode is used when the name or Internet address of the
414N/Ahost to be looked up is given as the first argument. The optional second
414N/Aargument specifies the host name or address of a name server.
414N/A</para>
414N/A
414N/A<para>
414N/AOptions can also be specified on the command line if they precede the
414N/Aarguments and are prefixed with a hyphen. For example, to
414N/Achange the default query type to host information, and the initial timeout to 10 seconds, type:
414N/A<InformalExample>
414N/A<PROGRAMLISTING>
414N/Anslookup -query=hinfo -timeout=10
414N/A</PROGRAMLISTING>
414N/A</InformalExample>
414N/A</para>
414N/A
414N/A</refsect1>
414N/A
414N/A<refsect1>
414N/A<title>INTERACTIVE COMMANDS</title>
414N/A<variablelist>
414N/A<varlistentry><term>host <optional>server</optional></term>
414N/A<listitem><para>
414N/ALook up information for host using the current default server or
414N/Ausing server, if specified. If host is an Internet address and
414N/Athe query type is A or PTR, the name of the host is returned.
414N/AIf host is a name and does not have a trailing period, the
414N/Asearch list is used to qualify the name.
414N/A</para>
414N/A
414N/A<para>
414N/ATo look up a host not in the current domain, append a period to
414N/Athe name.
414N/A</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term>
414N/A<listitem><para></para></listitem>
414N/A<varlistentry><term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term>
414N/A<listitem><para>
414N/AChange the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial
414N/Aserver to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses
414N/Athe current default server. If an authoritative answer can't be
414N/Afound, the names of servers that might have the answer are
414N/Areturned.
414N/A</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>root</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>finger</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>ls</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>view</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>help</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>?</constant></term>
414N/A<listitem><para>not implemented</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>exit</constant></term>
414N/A<listitem><para>Exits the program.</para></listitem></varlistentry>
414N/A
414N/A<varlistentry><term><constant>set</constant> <replaceable>keyword<optional>=value</optional></replaceable></term>
414N/A<listitem><para>This command is used to change state information that affects
414N/Athe lookups. Valid keywords are:
414N/A <variablelist>
414N/A <varlistentry><term><constant>all</constant></term>
414N/A <listitem>
414N/A <para>Prints the current values of the frequently used
414N/A options to <command>set</command>. Information about the current default
414N/A server and host is also printed.
414N/A </para>
414N/A </listitem>
414N/A </varlistentry>
414N/A
414N/A <varlistentry><term><constant>class=</constant><replaceable>value</replaceable></term>
414N/A <listitem><para>
414N/A Change the query class to one of:
414N/A <variablelist>
414N/A <varlistentry><term><constant>IN</constant></term>
414N/A <listitem><para>the Internet class</para></listitem></varlistentry>
414N/A <varlistentry><term><constant>CH</constant></term>
414N/A <listitem><para>the Chaos class</para></listitem></varlistentry>
414N/A <varlistentry><term><constant>HS</constant></term>
414N/A <listitem><para>the Hesiod class</para></listitem></varlistentry>
414N/A <varlistentry><term><constant>ANY</constant></term>
414N/A <listitem><para>wildcard</para></listitem></varlistentry>
414N/A </variablelist>
414N/A The class specifies the protocol group of the information.
414N/A </para><para>
414N/A (Default = IN; abbreviation = cl)
414N/A </para></listitem>
414N/A </varlistentry>
414N/A
414N/A <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
414N/A <listitem><para>
414N/A Turn debugging mode on. A lot more information is
414N/A printed about the packet sent to the server and the
414N/A resulting answer.
414N/A </para><para>
414N/A (Default = nodebug; abbreviation = <optional>no</optional>deb)
414N/A </para></listitem>
414N/A
414N/A <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>d2</constant></term>
414N/A <listitem><para>
414N/A Turn debugging mode on. A lot more information is
414N/A printed about the packet sent to the server and the
414N/A resulting answer.
414N/A </para><para>
414N/A (Default = nod2)
414N/A </para></listitem>
414N/A
414N/A <varlistentry><term><constant>domain=</constant><replaceable>name</replaceable></term>
414N/A <listitem><para>
414N/A Sets the search list to <replaceable>name</replaceable>.
414N/A </para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>search</constant></term>
414N/A <listitem><para>
414N/A If the lookup request contains at least one period but
414N/A doesn't end with a trailing period, append the domain
414N/A names in the domain search list to the request until an
414N/A answer is received.
414N/A </para><para>
414N/A (Default = search)
414N/A </para></listitem>
414N/A
414N/A <varlistentry><term><constant>port=</constant><replaceable>value</replaceable></term>
414N/A <listitem><para>
414N/A Change the default TCP/UDP name server port to <replaceable>value</replaceable>.
414N/A </para><para>
414N/A (Default = 53; abbreviation = po)
414N/A </para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant>querytype=</constant><replaceable>value</replaceable></term>
414N/A <listitem><para></para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant>type=</constant><replaceable>value</replaceable></term>
414N/A <listitem><para>
414N/A Change the top of the information query.
414N/A </para><para>
414N/A (Default = A; abbreviations = q, ty)
414N/A </para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>recurse</constant></term>
414N/A <listitem><para>
414N/A Tell the name server to query other servers if it does not have the
414N/A information.
414N/A </para><para>
414N/A (Default = recurse; abbreviation = [no]rec)
414N/A </para></listitem>
414N/A
414N/A <varlistentry><term><constant>retry=</constant><replaceable>number</replaceable></term>
414N/A <listitem><para>
414N/A Set the number of retries to number.
414N/A </para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant>timeout=</constant><replaceable>number</replaceable></term>
414N/A <listitem><para>
414N/A Change the initial timeout interval for waiting for a
414N/A reply to number seconds.
414N/A </para></listitem></varlistentry>
414N/A
414N/A <varlistentry><term><constant><replaceable><optional>no</optional></replaceable>vc</constant></term>
414N/A <listitem><para>
414N/A Always use a virtual circuit when sending requests to the server.
414N/A </para><para>
414N/A (Default = novc)
414N/A </para></listitem>
414N/A
</variablelist>
</para></listitem></varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>FILES</title>
<para>
<filename>/etc/resolv.conf</filename>
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>dig</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>.
</para>
</refsect1>
</refentry>