nslookup.docbook revision d63ae51ba337165172a9b50fd5d84805ffe50044
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes<!--
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - Copyright (C) 2004-2007, 2010, 2013-2017 Internet Systems Consortium, Inc. ("ISC")
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes -
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - This Source Code Form is subject to the terms of the Mozilla Public
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - License, v. 2.0. If a copy of the MPL was not distributed with this
70953fb44a7140fe206c3a5f011e24209c8c5c6abnicholes - file, You can obtain one at http://mozilla.org/MPL/2.0/.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes-->
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes<!--
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - Copyright (c) 1985, 1989
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - The Regents of the University of California. All rights reserved.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes -
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - Redistribution and use in source and binary forms, with or without
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - modification, are permitted provided that the following conditions
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - are met:
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - 1. Redistributions of source code must retain the above copyright
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - notice, this list of conditions and the following disclaimer.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - 2. Redistributions in binary form must reproduce the above copyright
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - notice, this list of conditions and the following disclaimer in the
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - documentation and/or other materials provided with the distribution.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - 3. Neither the name of the University nor the names of its contributors
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - may be used to endorse or promote products derived from this software
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - without specific prior written permission.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes -
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
70953fb44a7140fe206c3a5f011e24209c8c5c6abnicholes - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
70953fb44a7140fe206c3a5f011e24209c8c5c6abnicholes - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
f7d723f1ad88ed006c6caf4c2c6604b7c59dd172bnicholes - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes - SUCH DAMAGE.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes-->
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes<!-- Converted by db4-upgrade version 1.0 -->
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.nslookup">
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <info>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <date>2014-01-24</date>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </info>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refentryinfo>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <corpname>ISC</corpname>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
5b0c702735f2049038c50c7dc5dd2606086ee110bnicholes </refentryinfo>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refmeta>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refentrytitle>nslookup</refentrytitle>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <manvolnum>1</manvolnum>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refmiscinfo>BIND9</refmiscinfo>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </refmeta>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refnamediv>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refname>nslookup</refname>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refpurpose>query Internet name servers interactively</refpurpose>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </refnamediv>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <docinfo>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <copyright>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2004</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2005</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2006</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2007</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2010</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2013</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2014</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2015</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2016</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <year>2017</year>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </copyright>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </docinfo>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refsynopsisdiv>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <cmdsynopsis sepchar=" ">
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <command>nslookup</command>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <arg choice="opt" rep="norepeat"><option>-option</option></arg>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <arg choice="opt" rep="norepeat">name | -</arg>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <arg choice="opt" rep="norepeat">server</arg>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </cmdsynopsis>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </refsynopsisdiv>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refsection><info><title>DESCRIPTION</title></info>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para><command>Nslookup</command>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes is a program to query Internet domain name servers. <command>Nslookup</command>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes has two modes: interactive and non-interactive. Interactive mode allows
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the user to query name servers for information about various hosts and
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes domains or to print a list of hosts in a domain. Non-interactive mode
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes is
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes used to print just the name and requested information for a host or
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes domain.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </refsection>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <refsection><info><title>ARGUMENTS</title></info>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Interactive mode is entered in the following cases:
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <orderedlist numeration="loweralpha" inheritnum="ignore" continuation="restarts">
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes when no arguments are given (the default name server will be used)
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes when the first argument is a hyphen (-) and the second argument is
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the host name or Internet address of a name server.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </orderedlist>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Non-interactive mode is used when the name or Internet address of the
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes host to be looked up is given as the first argument. The optional second
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes argument specifies the host name or address of a name server.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Options can also be specified on the command line if they precede the
6c080a25f5991f40225209541c989d7e76c4a39dbnicholes arguments and are prefixed with a hyphen. For example, to
6c080a25f5991f40225209541c989d7e76c4a39dbnicholes change the default query type to host information, and the initial
6c080a25f5991f40225209541c989d7e76c4a39dbnicholes timeout to 10 seconds, type:
6c080a25f5991f40225209541c989d7e76c4a39dbnicholes <!-- <informalexample> produces bad nroff. -->
6c080a25f5991f40225209541c989d7e76c4a39dbnicholes <programlisting>
6c080a25f5991f40225209541c989d7e76c4a39dbnicholesnslookup -query=hinfo -timeout=10
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes</programlisting>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <!-- </informalexample> -->
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes The <option>-version</option> option causes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <command>nslookup</command> to print the version
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes number and immediately exits.
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes </para>
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes </refsection>
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes
036436f4f4cdcd76186c0058891216545967043bbnicholes <refsection><info><title>INTERACTIVE COMMANDS</title></info>
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes
41022996c916eb4ab2ec3204eb491b64779eb100bnicholes <variablelist>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>host</constant> <optional>server</optional></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Look up information for host using the current default server or
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes using server, if specified. If host is an Internet address and
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the query type is A or PTR, the name of the host is returned.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes If host is a name and does not have a trailing period, the
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes search list is used to qualify the name.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes To look up a host not in the current domain, append a period to
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the name.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para/>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Change the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes server to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the current default server. If an authoritative answer can't be
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes found, the names of servers that might have the answer are
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes returned.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>root</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes not implemented
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>finger</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes not implemented
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>ls</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes not implemented
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
56ab8639aed4d3b2f031d9c1160c5f40af01bdebjerenkrantz </listitem>
286fed73f9d1474652034465d4048247c6e7341fbnicholes </varlistentry>
be88e49281c5becee364ab9c6a0576f9b9844e0fbnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>view</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
56ab8639aed4d3b2f031d9c1160c5f40af01bdebjerenkrantz not implemented
56ab8639aed4d3b2f031d9c1160c5f40af01bdebjerenkrantz </para>
56ab8639aed4d3b2f031d9c1160c5f40af01bdebjerenkrantz </listitem>
56ab8639aed4d3b2f031d9c1160c5f40af01bdebjerenkrantz </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>help</constant></term>
f7d723f1ad88ed006c6caf4c2c6604b7c59dd172bnicholes <listitem>
f7d723f1ad88ed006c6caf4c2c6604b7c59dd172bnicholes <para>
f7d723f1ad88ed006c6caf4c2c6604b7c59dd172bnicholes not implemented
f7d723f1ad88ed006c6caf4c2c6604b7c59dd172bnicholes </para>
4f935de4900dc064a1e145be5e48f6af77ac24fcbnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>?</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes not implemented
e961abd49ab1b184b356f63591d37083a5651451bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>exit</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
440cda576ca9ff6476e4a04bdb253c5023da15eejerenkrantz Exits the program.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
6f2fa094a76c27135a9825ca9492f9db0a1a3bc9bnicholes <term><constant>set</constant>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <replaceable>keyword<optional>=value</optional></replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
3163ad7b2076b0f6961dc1a1ddaa06b240eecb7cjorton This command is used to change state information that affects
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the lookups. Valid keywords are:
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <variablelist>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>all</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes Prints the current values of the frequently used
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes options to <command>set</command>.
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes Information about the current default
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes server and host is also printed.
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes </para>
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>class=</constant><replaceable>value</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Change the query class to one of:
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <variablelist>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>IN</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the Internet class
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>CH</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the Chaos class
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>HS</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes the Hesiod class
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>ANY</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes wildcard
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </variablelist>
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes The class specifies the protocol group of the information.
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes </para>
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes <para>
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes (Default = IN; abbreviation = cl)
9558e9fdb620dd6f42ca93beac6c3ab734086706bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Turn on or off the display of the full response packet and
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes any intermediate response packets when searching.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes (Default = nodebug; abbreviation = <optional>no</optional>deb)
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant><replaceable><optional>no</optional></replaceable>d2</constant></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Turn debugging mode on or off. This displays more about
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes what nslookup is doing.
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes (Default = nod2)
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
2e3a086879b1ac9681ea9ccf458096236f500dccbnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>domain=</constant><replaceable>name</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
2e3a086879b1ac9681ea9ccf458096236f500dccbnicholes Sets the search list to <replaceable>name</replaceable>.
084aee5bd4093a1b5e9b51d1ccfafc3948fa4109bnicholes </para>
084aee5bd4093a1b5e9b51d1ccfafc3948fa4109bnicholes </listitem>
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes </varlistentry>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes <varlistentry>
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes <term><constant><replaceable><optional>no</optional></replaceable>search</constant></term>
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes <listitem>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes <para>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes If the lookup request contains at least one period but
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes doesn't end with a trailing period, append the domain
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes names in the domain search list to the request until an
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes answer is received.
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes </para>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes <para>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes (Default = search)
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes </para>
e76fdcdfb8994ad70776526f50fa013b3e9a6033bnicholes </listitem>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes </varlistentry>
509d30fddc88d129f9ba0f6000b802afa021fe52bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>port=</constant><replaceable>value</replaceable></term>
2d25618c79d4f62bbd867a69b6d9c94a261be695bnicholes <listitem>
2e3a086879b1ac9681ea9ccf458096236f500dccbnicholes <para>
0f7cc4b1d3c42262bcdced99f682778963e83ea7bnicholes Change the default TCP/UDP name server port to <replaceable>value</replaceable>.
5a1101aa8bb19d6bafb6c7808a56f49a95b0b769bnicholes </para>
5a1101aa8bb19d6bafb6c7808a56f49a95b0b769bnicholes <para>
5a1101aa8bb19d6bafb6c7808a56f49a95b0b769bnicholes (Default = 53; abbreviation = po)
5a1101aa8bb19d6bafb6c7808a56f49a95b0b769bnicholes </para>
5a1101aa8bb19d6bafb6c7808a56f49a95b0b769bnicholes </listitem>
0f7cc4b1d3c42262bcdced99f682778963e83ea7bnicholes </varlistentry>
233e163ab76ff3d9434939a65c6527f6e80be965bnicholes
0f7cc4b1d3c42262bcdced99f682778963e83ea7bnicholes <varlistentry>
0f7cc4b1d3c42262bcdced99f682778963e83ea7bnicholes <term><constant>querytype=</constant><replaceable>value</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para/>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>type=</constant><replaceable>value</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
a0209387ac93aa84037cf3a48096e75c6c8ce17ebnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Change the type of the information query.
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes </para>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes <para>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes (Default = A; abbreviations = q, ty)
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes </para>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes </listitem>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes </varlistentry>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes <varlistentry>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes <term><constant><replaceable><optional>no</optional></replaceable>recurse</constant></term>
273e1eccdc9e5b94f1e3e13e3ffca7360b6f461fbnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes Tell the name server to query other servers if it does not
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes have the
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes information.
8410c53aaf5e0372a19d5f4d2bc696b9c609ce3cbnicholes </para>
8410c53aaf5e0372a19d5f4d2bc696b9c609ce3cbnicholes <para>
8410c53aaf5e0372a19d5f4d2bc696b9c609ce3cbnicholes (Default = recurse; abbreviation = [no]rec)
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </para>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes </varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <varlistentry>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <term><constant>ndots=</constant><replaceable>number</replaceable></term>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <listitem>
bb2b38cd44b032118359afbc743efbea12f48e61bnicholes <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>