bin/dig/nslookup.docbook

	nslookup.docbook revision 3001a1b4e6298466882a4147307b4c28a3b08f91
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews<!--
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater - Copyright (C) 2004-2007, 2010, 2013-2016  Internet Systems Consortium, Inc. ("ISC")
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - This Source Code Form is subject to the terms of the Mozilla Public
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - file, You can obtain one at http://mozilla.org/MPL/2.0/.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein-->
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews<!--
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (c) 1985, 1989
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews -    The Regents of the University of California.  All rights reserved.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews -
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - Redistribution and use in source and binary forms, with or without
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - modification, are permitted provided that the following conditions
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - are met:
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User - 1. Redistributions of source code must retain the above copyright
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -    notice, this list of conditions and the following disclaimer.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 2. Redistributions in binary form must reproduce the above copyright
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -    notice, this list of conditions and the following disclaimer in the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -    documentation and/or other materials provided with the distribution.
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews - 3. Neither the name of the University nor the names of its contributors
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -    may be used to endorse or promote products derived from this software
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -    without specific prior written permission.
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User -
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - SUCH DAMAGE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein-->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- Converted by db4-upgrade version 1.0 -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.nslookup">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <info>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <date>2014-01-24</date>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </info>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <corpname>ISC</corpname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refentryinfo>
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refmeta>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <refentrytitle>nslookup</refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <manvolnum>1</manvolnum>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <refmiscinfo>BIND9</refmiscinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refmeta>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <refname>nslookup</refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <refpurpose>query Internet name servers interactively</refpurpose>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <docinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <copyright>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2004</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2005</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2006</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2007</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2010</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2013</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2014</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2015</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <year>2016</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </copyright>
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater  </docinfo>
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater  <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <cmdsynopsis sepchar=" ">
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater      <command>nslookup</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <arg choice="opt" rep="norepeat"><option>-option</option></arg>
680033ce4d5858bb9016cfa50944eea4ff0111e3Automatic Updater      <arg choice="opt" rep="norepeat">name | -</arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <arg choice="opt" rep="norepeat">server</arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refsynopsisdiv>
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refsection><info><title>DESCRIPTION</title></info>
69f175fc57a578dd85c1548ed3f34284321f9d3aMark Andrews
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <para><command>Nslookup</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      is a program to query Internet domain name servers.  <command>Nslookup</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      has two modes: interactive and non-interactive.  Interactive mode allows
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      the user to query name servers for information about various hosts and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      domains or to print a list of hosts in a domain.  Non-interactive mode
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      used to print just the name and requested information for a host or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      domain.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refsection>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refsection><info><title>ARGUMENTS</title></info>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      Interactive mode is entered in the following cases:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <orderedlist numeration="loweralpha" inheritnum="ignore" continuation="restarts">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            when no arguments are given (the default name server will be used)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            when the first argument is a hyphen (-) and the second argument is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            the host name or Internet address of a name server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </orderedlist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      Non-interactive mode is used when the name or Internet address of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      host to be looked up is given as the first argument. The optional second
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      argument specifies the host name or address of a name server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      Options can also be specified on the command line if they precede the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      arguments and are prefixed with a hyphen.  For example, to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      change the default query type to host information, and the initial
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      timeout to 10 seconds, type:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <!-- <informalexample> produces bad nroff. -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <programlisting>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinnslookup -query=hinfo  -timeout=10
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</programlisting>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <!-- </informalexample> -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      The <option>-version</option> option causes
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <command>nslookup</command> to print the version
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      number and immediately exits.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  </refsection>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein  <refsection><info><title>INTERACTIVE COMMANDS</title></info>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein    <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>host</constant> <optional>server</optional></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            Look up information for host using the current default server or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            using server, if specified.  If host is an Internet address and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            the query type is A or PTR, the name of the host is returned.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            If host is a name and does not have a trailing period, the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            search list is used to qualify the name.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            To look up a host not in the current domain, append a period to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            the name.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para/>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            Change the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            server to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            the current default server.  If an authoritative answer can't be
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            found, the names of servers that might have the answer are
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            returned.
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>root</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews        </listitem>
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>finger</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews
a1b05dea35aa30b152a47115e18bbe679d3fcf19Mark Andrews      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>ls</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>view</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>help</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>?</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            not implemented
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews        <term><constant>exit</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            Exits the program.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <term><constant>set</constant>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <replaceable>keyword<optional>=value</optional></replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            This command is used to change state information that affects
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            the lookups.  Valid keywords are:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein              <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                <term><constant>all</constant></term>
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                <listitem>
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                  <para>
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                    Prints the current values of the frequently used
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                    options to <command>set</command>.
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                    Information about the  current default
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                    server and host is also printed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                  </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein              </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein              <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                <term><constant>class=</constant><replaceable>value</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                  <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                    Change the query class to one of:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                    <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        <term><constant>IN</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                            the Internet class
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        <term><constant>CH</constant></term>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                        <listitem>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                          <para>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                            the Chaos class
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                          </para>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                        </listitem>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                      </varlistentry>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                      <varlistentry>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                        <term><constant>HS</constant></term>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                        <listitem>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                          <para>
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                            the Hesiod class
a057e8e33baa5fa369be28a9680585200ce3ff73Mark Andrews                          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        <term><constant>ANY</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                            wildcard
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User                          </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                        </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                      </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                    </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                    The class specifies the protocol group of the information.
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                  </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein          <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                    (Default = IN; abbreviation = cl)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                  </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein              </varlistentry>
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein              <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                <term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein                  <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            Turn on or off the display of the full response packet and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein            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>