bin/dig/nslookup.docbook

	nslookup.docbook revision 8454718b87840e1689be04cbea5f61fd57e1d1ce
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews<!--
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - Copyright (C) 2004-2007, 2010, 2013-2015  Internet Systems Consortium, Inc. ("ISC")
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
938440694b33cd752e9e4b71a526368b4811c177Tinderbox User - purpose with or without fee is hereby granted, provided that the above
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - copyright notice and this permission notice appear in all copies.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - PERFORMANCE OF THIS SOFTWARE.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews-->
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews<!--
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - Copyright (c) 1985, 1989
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    The Regents of the University of California.  All rights reserved.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - Redistribution and use in source and binary forms, with or without
1753d3c4d74241a847794f7e7cfd94cc79be6600Evan Hunt - modification, are permitted provided that the following conditions
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - are met:
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - 1. Redistributions of source code must retain the above copyright
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    notice, this list of conditions and the following disclaimer.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - 2. Redistributions in binary form must reproduce the above copyright
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    notice, this list of conditions and the following disclaimer in the
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    documentation and/or other materials provided with the distribution.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - 3. Neither the name of the University nor the names of its contributors
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    may be used to endorse or promote products derived from this software
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -    without specific prior written permission.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews -
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
dde8659175c5798267fb0fdefd7576e4efe271b3Automatic Updater - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
a094c46640de70bb03a9351211fb17c41b6fbbb5Automatic Updater - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
06140f733a711340d20650b9b096efe234d6ebcbAutomatic Updater - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
99d8f5a70440ee8b63ab1745d713b96dde890546Tinderbox User - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
938440694b33cd752e9e4b71a526368b4811c177Tinderbox User - SUCH DAMAGE.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews-->
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews<!-- Converted by db4-upgrade version 1.0 -->
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews<refentry xmlns="http://docbook.org/ns/docbook" version="5.0">
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <info>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <date>2014-01-24</date>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </info>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <refentryinfo>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <corpname>ISC</corpname>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </refentryinfo>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
35490da6150316932957908f2f85109ecf9f7c59Jeremy Reed  <refmeta>
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews    <refentrytitle>nslookup</refentrytitle>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <manvolnum>1</manvolnum>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <refmiscinfo>BIND9</refmiscinfo>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </refmeta>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <refnamediv>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <refname>nslookup</refname>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <refpurpose>query Internet name servers interactively</refpurpose>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </refnamediv>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt
35490da6150316932957908f2f85109ecf9f7c59Jeremy Reed  <docinfo>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt    <copyright>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <year>2004</year>
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      <year>2005</year>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <year>2006</year>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <year>2007</year>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <year>2010</year>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <year>2013</year>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <year>2014</year>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      <year>2015</year>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman    </copyright>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman  </docinfo>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <refsynopsisdiv>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <cmdsynopsis sepchar=" ">
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <command>nslookup</command>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <arg choice="opt" rep="norepeat"><option>-option</option></arg>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <arg choice="opt" rep="norepeat">name | -</arg>
832fb12cfeee424a1e5b7cfd3b2da9f39cac3708Jeremy Reed      <arg choice="opt" rep="norepeat">server</arg>
e17cb80d7cebc23a4de75376155f2231dea193e6Mark Andrews    </cmdsynopsis>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </refsynopsisdiv>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <refsection><info><title>DESCRIPTION</title></info>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <para><command>Nslookup</command>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      is a program to query Internet domain name servers.  <command>Nslookup</command>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      has two modes: interactive and non-interactive.  Interactive mode allows
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      the user to query name servers for information about various hosts and
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      domains or to print a list of hosts in a domain.  Non-interactive mode
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      is
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      used to print just the name and requested information for a host or
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      domain.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  </refsection>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews  <refsection><info><title>ARGUMENTS</title></info>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      Interactive mode is entered in the following cases:
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <orderedlist numeration="loweralpha" inheritnum="ignore" continuation="restarts">
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            when no arguments are given (the default name server will be used)
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            when the first argument is a hyphen (-) and the second argument is
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            the host name or Internet address of a name server.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
37dee1ff94960a61243f611c0f87f8c316815c53Mark Andrews      </orderedlist>
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews    </para>
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      Non-interactive mode is used when the name or Internet address of the
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      host to be looked up is given as the first argument. The optional second
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      argument specifies the host name or address of a name server.
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews    </para>
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews    <para>
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      Options can also be specified on the command line if they precede the
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      arguments and are prefixed with a hyphen.  For example, to
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      change the default query type to host information, and the initial
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      timeout to 10 seconds, type:
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews      <!-- <informalexample> produces bad nroff. -->
b1c6de5456a5287b442de5620282902da39a4968Mark Andrews        <programlisting>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrewsnslookup -query=hinfo  -timeout=10
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt</programlisting>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <!-- </informalexample> -->
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews    </para>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt    <para>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      The <option>-version</option> option causes
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <command>nslookup</command> to print the version
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      number and immediately exits.
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt    </para>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt  </refsection>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt  <refsection><info><title>INTERACTIVE COMMANDS</title></info>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt    <variablelist>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <varlistentry>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <term><constant>host</constant> <optional>server</optional></term>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <listitem>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt          <para>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt            Look up information for host using the current default server or
fdc2d31c00280488df9ee7bd1e1e7410d3e30388Mark Andrews            using server, if specified.  If host is an Internet address and
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews            the query type is A or PTR, the name of the host is returned.
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews            If host is a name and does not have a trailing period, the
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews            search list is used to qualify the name.
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews          </para>
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews
2ae23f7fc6f9422a1a4198e82778c92aba4577d3Mark Andrews          <para>
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews            To look up a host not in the current domain, append a period to
0a82492610e2424bb999946bd6e5a13c83f453b4Mark Andrews            the name.
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt          </para>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        </listitem>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      </varlistentry>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <varlistentry>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <listitem>
edad003e630cf9a25db88d95247d10eb96117d66Jeremy C. Reed          <para/>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        </listitem>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt            Change the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt            server to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt            the current default server.  If an authoritative answer can't be
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt            found, the names of servers that might have the answer are
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt            returned.
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt          </para>
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt        </listitem>
35490da6150316932957908f2f85109ecf9f7c59Jeremy Reed      </varlistentry>
35490da6150316932957908f2f85109ecf9f7c59Jeremy Reed
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt      <varlistentry>
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt        <term><constant>root</constant></term>
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt        <listitem>
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            not implemented
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <term><constant>finger</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            not implemented
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      <varlistentry>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <term><constant>ls</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            not implemented
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <varlistentry>
553ead32ff5b00284e574dcabc39115d4d74ec66Evan Hunt        <term><constant>view</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            not implemented
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman          </para>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        </listitem>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      </varlistentry>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      <varlistentry>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        <term><constant>help</constant></term>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        <listitem>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman          <para>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman            not implemented
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman          </para>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        </listitem>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      </varlistentry>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman      <varlistentry>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        <term><constant>?</constant></term>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman        <listitem>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman          <para>
42782931073786f98d3d0a617351db40066949a4Mukund Sivaraman            not implemented
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <term><constant>exit</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            Exits the program.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <term><constant>set</constant>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <replaceable>keyword<optional>=value</optional></replaceable></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            This command is used to change state information that affects
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            the lookups.  Valid keywords are:
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews            <variablelist>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews              <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                <term><constant>all</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                <listitem>
832fb12cfeee424a1e5b7cfd3b2da9f39cac3708Jeremy Reed                  <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    Prints the current values of the frequently used
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    options to <command>set</command>.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    Information about the  current default
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    server and host is also printed.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                  </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews              </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews              <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                <term><constant>class=</constant><replaceable>value</replaceable></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                  <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    Change the query class to one of:
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                    <variablelist>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <term><constant>IN</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                            the Internet class
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <term><constant>CH</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          <para>
35490da6150316932957908f2f85109ecf9f7c59Jeremy Reed                            the Chaos class
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <term><constant>HS</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          <para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                            the Hesiod class
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                          </para>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        </listitem>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                      <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <term><constant>ANY</constant></term>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews                        <listitem>
59a4c9c6b4e8af2553216894e5ed8fd879987b7cAutomatic Updater                          <para>
                            wildcard
                          </para>
                        </listitem>
                      </varlistentry>
                    </variablelist>
                    The class specifies the protocol group of the information.

                  </para>
          <para>
                    (Default = IN; abbreviation = cl)
                  </para>
                </listitem>
              </varlistentry>

              <varlistentry>
                <term><constant>
                    <replaceable><optional>no</optional></replaceable>debug</constant></term>
                <listitem>
                  <para>
            Turn on or off the display of the full response packet and
            any intermediate response packets when searching.
                  </para>
          <para>
                    (Default = nodebug; abbreviation = <optional>no</optional>deb)
                  </para>
                </listitem>
              </varlistentry>

              <varlistentry>
                <term><constant>
                    <replaceable><optional>no</optional></replaceable>d2</constant></term>
                <listitem>
                  <para>
                    Turn debugging mode on or off.  This displays more about
                what nslookup is doing.
                  </para>
          <para>
                    (Default = nod2)
                  </para>
                </listitem>
              </varlistentry>

              <varlistentry>
                <term><constant>domain=</constant><replaceable>name</replaceable></term>
                <listitem>
                  <para>
                    Sets the search list to <replaceable>name</replaceable>.
                  </para>
                </listitem>
              </varlistentry>

              <varlistentry>
                <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>ndots=</constant><replaceable>number</replaceable></term>
                <listitem>
                  <para>
            Set the number of dots (label separators) in a domain
            that will disable searching.  Absolute names always
            stop searching.
                  </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>
  </refsection>

  <refsection><info><title>RETURN VALUES</title></info>
    <para>
      <command>nslookup</command> returns with an exit status of 1
      if any query failed, and 0 otherwise.
    </para>
  </refsection>

  <refsection><info><title>FILES</title></info>

    <para><filename>/etc/resolv.conf</filename>
    </para>
  </refsection>

  <refsection><info><title>SEE ALSO</title></info>

    <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>
  </refsection>
</refentry>