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