1170222Sdougb<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 2170222Sdougb "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 3153816Sdougb [<!ENTITY mdash "—">]> 4135446Strhodes<!-- 5262706Serwin - Copyright (C) 2004-2007, 2010, 2013, 2014 Internet Systems Consortium, Inc. ("ISC") 6135446Strhodes - 7174187Sdougb - Permission to use, copy, modify, and/or distribute this software for any 8135446Strhodes - purpose with or without fee is hereby granted, provided that the above 9135446Strhodes - copyright notice and this permission notice appear in all copies. 10135446Strhodes - 11135446Strhodes - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 12135446Strhodes - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 13135446Strhodes - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 14135446Strhodes - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 15135446Strhodes - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 16135446Strhodes - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 17135446Strhodes - PERFORMANCE OF THIS SOFTWARE. 18135446Strhodes--> 19135446Strhodes 20234010Sdougb<!-- $Id: nslookup.docbook,v 1.18 2010/02/22 23:49:11 tbox Exp $ --> 21135446Strhodes<!-- 22135446Strhodes - Copyright (c) 1985, 1989 23135446Strhodes - The Regents of the University of California. All rights reserved. 24170222Sdougb - 25135446Strhodes - Redistribution and use in source and binary forms, with or without 26135446Strhodes - modification, are permitted provided that the following conditions 27135446Strhodes - are met: 28135446Strhodes - 1. Redistributions of source code must retain the above copyright 29135446Strhodes - notice, this list of conditions and the following disclaimer. 30135446Strhodes - 2. Redistributions in binary form must reproduce the above copyright 31135446Strhodes - notice, this list of conditions and the following disclaimer in the 32135446Strhodes - documentation and/or other materials provided with the distribution. 33262706Serwin - 3. Neither the name of the University nor the names of its contributors 34135446Strhodes - may be used to endorse or promote products derived from this software 35135446Strhodes - without specific prior written permission. 36170222Sdougb - 37135446Strhodes - THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 38135446Strhodes - ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 39135446Strhodes - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 40135446Strhodes - ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 41135446Strhodes - FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 42135446Strhodes - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 43135446Strhodes - OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 44135446Strhodes - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 45135446Strhodes - LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 46135446Strhodes - OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 47135446Strhodes - SUCH DAMAGE. 48135446Strhodes--> 49135446Strhodes<refentry> 50135446Strhodes 51170222Sdougb <refentryinfo> 52170222Sdougb <date>Jun 30, 2000</date> 53170222Sdougb </refentryinfo> 54135446Strhodes 55170222Sdougb <refmeta> 56170222Sdougb <refentrytitle>nslookup</refentrytitle> 57170222Sdougb <manvolnum>1</manvolnum> 58170222Sdougb <refmiscinfo>BIND9</refmiscinfo> 59170222Sdougb </refmeta> 60135446Strhodes 61170222Sdougb <refnamediv> 62170222Sdougb <refname>nslookup</refname> 63170222Sdougb <refpurpose>query Internet name servers interactively</refpurpose> 64170222Sdougb </refnamediv> 65170222Sdougb 66153816Sdougb <docinfo> 67153816Sdougb <copyright> 68153816Sdougb <year>2004</year> 69153816Sdougb <year>2005</year> 70165071Sdougb <year>2006</year> 71170222Sdougb <year>2007</year> 72218384Sdougb <year>2010</year> 73262706Serwin <year>2013</year> 74262706Serwin <year>2014</year> 75153816Sdougb <holder>Internet Systems Consortium, Inc. ("ISC")</holder> 76153816Sdougb </copyright> 77153816Sdougb </docinfo> 78153816Sdougb 79170222Sdougb <refsynopsisdiv> 80170222Sdougb <cmdsynopsis> 81170222Sdougb <command>nslookup</command> 82170222Sdougb <arg><option>-option</option></arg> 83170222Sdougb <arg choice="opt">name | -</arg> 84170222Sdougb <arg choice="opt">server</arg> 85170222Sdougb </cmdsynopsis> 86170222Sdougb </refsynopsisdiv> 87135446Strhodes 88170222Sdougb <refsect1> 89170222Sdougb <title>DESCRIPTION</title> 90170222Sdougb <para><command>Nslookup</command> 91170222Sdougb is a program to query Internet domain name servers. <command>Nslookup</command> 92170222Sdougb has two modes: interactive and non-interactive. Interactive mode allows 93170222Sdougb the user to query name servers for information about various hosts and 94170222Sdougb domains or to print a list of hosts in a domain. Non-interactive mode 95170222Sdougb is 96170222Sdougb used to print just the name and requested information for a host or 97170222Sdougb domain. 98170222Sdougb </para> 99170222Sdougb </refsect1> 100135446Strhodes 101170222Sdougb <refsect1> 102170222Sdougb <title>ARGUMENTS</title> 103170222Sdougb <para> 104170222Sdougb Interactive mode is entered in the following cases: 105170222Sdougb <orderedlist numeration="loweralpha"> 106170222Sdougb <listitem> 107170222Sdougb <para> 108170222Sdougb when no arguments are given (the default name server will be used) 109170222Sdougb </para> 110170222Sdougb </listitem> 111170222Sdougb <listitem> 112170222Sdougb <para> 113170222Sdougb when the first argument is a hyphen (-) and the second argument is 114170222Sdougb the host name or Internet address of a name server. 115170222Sdougb </para> 116170222Sdougb </listitem> 117170222Sdougb </orderedlist> 118170222Sdougb </para> 119135446Strhodes 120170222Sdougb <para> 121170222Sdougb Non-interactive mode is used when the name or Internet address of the 122170222Sdougb host to be looked up is given as the first argument. The optional second 123170222Sdougb argument specifies the host name or address of a name server. 124170222Sdougb </para> 125135446Strhodes 126170222Sdougb <para> 127170222Sdougb Options can also be specified on the command line if they precede the 128170222Sdougb arguments and are prefixed with a hyphen. For example, to 129170222Sdougb change the default query type to host information, and the initial 130170222Sdougb timeout to 10 seconds, type: 131218384Sdougb <!-- <informalexample> produces bad nroff. --> 132170222Sdougb <programlisting> 133135446Strhodesnslookup -query=hinfo -timeout=10 134153816Sdougb</programlisting> 135218384Sdougb <!-- </informalexample> --> 136170222Sdougb </para> 137135446Strhodes 138170222Sdougb </refsect1> 139135446Strhodes 140170222Sdougb <refsect1> 141170222Sdougb <title>INTERACTIVE COMMANDS</title> 142170222Sdougb <variablelist> 143170222Sdougb <varlistentry> 144170222Sdougb <term><constant>host</constant> <optional>server</optional></term> 145170222Sdougb <listitem> 146170222Sdougb <para> 147170222Sdougb Look up information for host using the current default server or 148170222Sdougb using server, if specified. If host is an Internet address and 149170222Sdougb the query type is A or PTR, the name of the host is returned. 150170222Sdougb If host is a name and does not have a trailing period, the 151170222Sdougb search list is used to qualify the name. 152170222Sdougb </para> 153135446Strhodes 154170222Sdougb <para> 155170222Sdougb To look up a host not in the current domain, append a period to 156170222Sdougb the name. 157170222Sdougb </para> 158170222Sdougb </listitem> 159170222Sdougb </varlistentry> 160135446Strhodes 161170222Sdougb <varlistentry> 162170222Sdougb <term><constant>server</constant> <replaceable class="parameter">domain</replaceable></term> 163170222Sdougb <listitem> 164170222Sdougb <para/> 165170222Sdougb </listitem> 166170222Sdougb </varlistentry> 167170222Sdougb <varlistentry> 168170222Sdougb <term><constant>lserver</constant> <replaceable class="parameter">domain</replaceable></term> 169170222Sdougb <listitem> 170170222Sdougb <para> 171170222Sdougb Change the default server to <replaceable>domain</replaceable>; <constant>lserver</constant> uses the initial 172170222Sdougb server to look up information about <replaceable>domain</replaceable>, while <constant>server</constant> uses 173170222Sdougb the current default server. If an authoritative answer can't be 174170222Sdougb found, the names of servers that might have the answer are 175170222Sdougb returned. 176170222Sdougb </para> 177170222Sdougb </listitem> 178170222Sdougb </varlistentry> 179135446Strhodes 180170222Sdougb <varlistentry> 181170222Sdougb <term><constant>root</constant></term> 182170222Sdougb <listitem> 183170222Sdougb <para> 184170222Sdougb not implemented 185170222Sdougb </para> 186170222Sdougb </listitem> 187170222Sdougb </varlistentry> 188135446Strhodes 189170222Sdougb <varlistentry> 190170222Sdougb <term><constant>finger</constant></term> 191170222Sdougb <listitem> 192170222Sdougb <para> 193170222Sdougb not implemented 194170222Sdougb </para> 195170222Sdougb </listitem> 196170222Sdougb </varlistentry> 197135446Strhodes 198170222Sdougb <varlistentry> 199170222Sdougb <term><constant>ls</constant></term> 200170222Sdougb <listitem> 201170222Sdougb <para> 202170222Sdougb not implemented 203170222Sdougb </para> 204170222Sdougb </listitem> 205170222Sdougb </varlistentry> 206135446Strhodes 207170222Sdougb <varlistentry> 208170222Sdougb <term><constant>view</constant></term> 209170222Sdougb <listitem> 210170222Sdougb <para> 211170222Sdougb not implemented 212170222Sdougb </para> 213170222Sdougb </listitem> 214170222Sdougb </varlistentry> 215135446Strhodes 216170222Sdougb <varlistentry> 217170222Sdougb <term><constant>help</constant></term> 218170222Sdougb <listitem> 219170222Sdougb <para> 220170222Sdougb not implemented 221170222Sdougb </para> 222170222Sdougb </listitem> 223170222Sdougb </varlistentry> 224135446Strhodes 225170222Sdougb <varlistentry> 226170222Sdougb <term><constant>?</constant></term> 227170222Sdougb <listitem> 228170222Sdougb <para> 229170222Sdougb not implemented 230170222Sdougb </para> 231170222Sdougb </listitem> 232170222Sdougb </varlistentry> 233135446Strhodes 234170222Sdougb <varlistentry> 235170222Sdougb <term><constant>exit</constant></term> 236170222Sdougb <listitem> 237170222Sdougb <para> 238170222Sdougb Exits the program. 239170222Sdougb </para> 240170222Sdougb </listitem> 241170222Sdougb </varlistentry> 242135446Strhodes 243170222Sdougb <varlistentry> 244170222Sdougb <term><constant>set</constant> 245170222Sdougb <replaceable>keyword<optional>=value</optional></replaceable></term> 246170222Sdougb <listitem> 247170222Sdougb <para> 248170222Sdougb This command is used to change state information that affects 249170222Sdougb the lookups. Valid keywords are: 250170222Sdougb <variablelist> 251170222Sdougb <varlistentry> 252170222Sdougb <term><constant>all</constant></term> 253170222Sdougb <listitem> 254170222Sdougb <para> 255170222Sdougb Prints the current values of the frequently used 256170222Sdougb options to <command>set</command>. 257170222Sdougb Information about the current default 258170222Sdougb server and host is also printed. 259170222Sdougb </para> 260170222Sdougb </listitem> 261170222Sdougb </varlistentry> 262135446Strhodes 263170222Sdougb <varlistentry> 264170222Sdougb <term><constant>class=</constant><replaceable>value</replaceable></term> 265170222Sdougb <listitem> 266170222Sdougb <para> 267170222Sdougb Change the query class to one of: 268170222Sdougb <variablelist> 269170222Sdougb <varlistentry> 270170222Sdougb <term><constant>IN</constant></term> 271170222Sdougb <listitem> 272170222Sdougb <para> 273170222Sdougb the Internet class 274170222Sdougb </para> 275170222Sdougb </listitem> 276170222Sdougb </varlistentry> 277170222Sdougb <varlistentry> 278170222Sdougb <term><constant>CH</constant></term> 279170222Sdougb <listitem> 280170222Sdougb <para> 281170222Sdougb the Chaos class 282170222Sdougb </para> 283170222Sdougb </listitem> 284170222Sdougb </varlistentry> 285170222Sdougb <varlistentry> 286170222Sdougb <term><constant>HS</constant></term> 287170222Sdougb <listitem> 288170222Sdougb <para> 289170222Sdougb the Hesiod class 290170222Sdougb </para> 291170222Sdougb </listitem> 292170222Sdougb </varlistentry> 293170222Sdougb <varlistentry> 294170222Sdougb <term><constant>ANY</constant></term> 295170222Sdougb <listitem> 296170222Sdougb <para> 297170222Sdougb wildcard 298170222Sdougb </para> 299170222Sdougb </listitem> 300170222Sdougb </varlistentry> 301170222Sdougb </variablelist> 302170222Sdougb The class specifies the protocol group of the information. 303135446Strhodes 304170222Sdougb </para> 305170222Sdougb <para> 306170222Sdougb (Default = IN; abbreviation = cl) 307170222Sdougb </para> 308170222Sdougb </listitem> 309170222Sdougb </varlistentry> 310135446Strhodes 311170222Sdougb <varlistentry> 312170222Sdougb <term><constant> 313170222Sdougb <replaceable><optional>no</optional></replaceable>debug</constant></term> 314170222Sdougb <listitem> 315170222Sdougb <para> 316174187Sdougb Turn on or off the display of the full response packet and 317174187Sdougb any intermediate response packets when searching. 318170222Sdougb </para> 319170222Sdougb <para> 320170222Sdougb (Default = nodebug; abbreviation = <optional>no</optional>deb) 321170222Sdougb </para> 322170222Sdougb </listitem> 323170222Sdougb </varlistentry> 324135446Strhodes 325170222Sdougb <varlistentry> 326170222Sdougb <term><constant> 327170222Sdougb <replaceable><optional>no</optional></replaceable>d2</constant></term> 328170222Sdougb <listitem> 329170222Sdougb <para> 330174187Sdougb Turn debugging mode on or off. This displays more about 331174187Sdougb what nslookup is doing. 332170222Sdougb </para> 333170222Sdougb <para> 334170222Sdougb (Default = nod2) 335170222Sdougb </para> 336170222Sdougb </listitem> 337170222Sdougb </varlistentry> 338135446Strhodes 339170222Sdougb <varlistentry> 340170222Sdougb <term><constant>domain=</constant><replaceable>name</replaceable></term> 341170222Sdougb <listitem> 342170222Sdougb <para> 343170222Sdougb Sets the search list to <replaceable>name</replaceable>. 344170222Sdougb </para> 345170222Sdougb </listitem> 346170222Sdougb </varlistentry> 347135446Strhodes 348170222Sdougb <varlistentry> 349170222Sdougb <term><constant> 350170222Sdougb <replaceable><optional>no</optional></replaceable>search</constant></term> 351170222Sdougb <listitem> 352170222Sdougb <para> 353170222Sdougb If the lookup request contains at least one period but 354170222Sdougb doesn't end with a trailing period, append the domain 355170222Sdougb names in the domain search list to the request until an 356170222Sdougb answer is received. 357170222Sdougb </para> 358170222Sdougb <para> 359170222Sdougb (Default = search) 360170222Sdougb </para> 361170222Sdougb </listitem> 362170222Sdougb </varlistentry> 363135446Strhodes 364170222Sdougb <varlistentry> 365170222Sdougb <term><constant>port=</constant><replaceable>value</replaceable></term> 366170222Sdougb <listitem> 367170222Sdougb <para> 368170222Sdougb Change the default TCP/UDP name server port to <replaceable>value</replaceable>. 369170222Sdougb </para> 370170222Sdougb <para> 371170222Sdougb (Default = 53; abbreviation = po) 372170222Sdougb </para> 373170222Sdougb </listitem> 374170222Sdougb </varlistentry> 375135446Strhodes 376170222Sdougb <varlistentry> 377170222Sdougb <term><constant>querytype=</constant><replaceable>value</replaceable></term> 378170222Sdougb <listitem> 379170222Sdougb <para/> 380170222Sdougb </listitem> 381170222Sdougb </varlistentry> 382135446Strhodes 383170222Sdougb <varlistentry> 384170222Sdougb <term><constant>type=</constant><replaceable>value</replaceable></term> 385170222Sdougb <listitem> 386170222Sdougb <para> 387170222Sdougb Change the type of the information query. 388170222Sdougb </para> 389170222Sdougb <para> 390170222Sdougb (Default = A; abbreviations = q, ty) 391170222Sdougb </para> 392170222Sdougb </listitem> 393170222Sdougb </varlistentry> 394135446Strhodes 395170222Sdougb <varlistentry> 396170222Sdougb <term><constant> 397170222Sdougb <replaceable><optional>no</optional></replaceable>recurse</constant></term> 398170222Sdougb <listitem> 399170222Sdougb <para> 400170222Sdougb Tell the name server to query other servers if it does not 401170222Sdougb have the 402170222Sdougb information. 403170222Sdougb </para> 404170222Sdougb <para> 405170222Sdougb (Default = recurse; abbreviation = [no]rec) 406170222Sdougb </para> 407170222Sdougb </listitem> 408170222Sdougb </varlistentry> 409135446Strhodes 410170222Sdougb <varlistentry> 411262706Serwin <term><constant>ndots=</constant><replaceable>number</replaceable></term> 412262706Serwin <listitem> 413262706Serwin <para> 414262706Serwin Set the number of dots (label separators) in a domain 415262706Serwin that will disable searching. Absolute names always 416262706Serwin stop searching. 417262706Serwin </para> 418262706Serwin </listitem> 419262706Serwin </varlistentry> 420262706Serwin 421262706Serwin <varlistentry> 422170222Sdougb <term><constant>retry=</constant><replaceable>number</replaceable></term> 423170222Sdougb <listitem> 424170222Sdougb <para> 425170222Sdougb Set the number of retries to number. 426170222Sdougb </para> 427170222Sdougb </listitem> 428170222Sdougb </varlistentry> 429135446Strhodes 430170222Sdougb <varlistentry> 431170222Sdougb <term><constant>timeout=</constant><replaceable>number</replaceable></term> 432170222Sdougb <listitem> 433170222Sdougb <para> 434170222Sdougb Change the initial timeout interval for waiting for a 435170222Sdougb reply to number seconds. 436170222Sdougb </para> 437170222Sdougb </listitem> 438170222Sdougb </varlistentry> 439135446Strhodes 440170222Sdougb <varlistentry> 441170222Sdougb <term><constant> 442170222Sdougb <replaceable><optional>no</optional></replaceable>vc</constant></term> 443170222Sdougb <listitem> 444170222Sdougb <para> 445170222Sdougb Always use a virtual circuit when sending requests to the 446170222Sdougb server. 447170222Sdougb </para> 448170222Sdougb <para> 449170222Sdougb (Default = novc) 450170222Sdougb </para> 451170222Sdougb </listitem> 452170222Sdougb </varlistentry> 453135446Strhodes 454170222Sdougb <varlistentry> 455170222Sdougb <term><constant> 456170222Sdougb <replaceable><optional>no</optional></replaceable>fail</constant></term> 457170222Sdougb <listitem> 458170222Sdougb <para> 459170222Sdougb Try the next nameserver if a nameserver responds with 460170222Sdougb SERVFAIL or a referral (nofail) or terminate query 461170222Sdougb (fail) on such a response. 462170222Sdougb </para> 463170222Sdougb <para> 464170222Sdougb (Default = nofail) 465170222Sdougb </para> 466170222Sdougb </listitem> 467170222Sdougb </varlistentry> 468135446Strhodes 469170222Sdougb </variablelist> 470170222Sdougb </para> 471170222Sdougb </listitem> 472170222Sdougb </varlistentry> 473170222Sdougb </variablelist> 474170222Sdougb </refsect1> 475135446Strhodes 476170222Sdougb <refsect1> 477170222Sdougb <title>FILES</title> 478170222Sdougb <para><filename>/etc/resolv.conf</filename> 479170222Sdougb </para> 480170222Sdougb </refsect1> 481170222Sdougb 482170222Sdougb <refsect1> 483170222Sdougb <title>SEE ALSO</title> 484170222Sdougb <para><citerefentry> 485170222Sdougb <refentrytitle>dig</refentrytitle><manvolnum>1</manvolnum> 486170222Sdougb </citerefentry>, 487170222Sdougb <citerefentry> 488170222Sdougb <refentrytitle>host</refentrytitle><manvolnum>1</manvolnum> 489170222Sdougb </citerefentry>, 490170222Sdougb <citerefentry> 491170222Sdougb <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum> 492170222Sdougb </citerefentry>. 493170222Sdougb </para> 494170222Sdougb </refsect1> 495170222Sdougb 496170222Sdougb <refsect1> 497170222Sdougb <title>Author</title> 498170222Sdougb <para> 499170222Sdougb Andrew Cherenson 500170222Sdougb </para> 501170222Sdougb </refsect1> 502170222Sdougb</refentry><!-- 503170222Sdougb - Local variables: 504170222Sdougb - mode: sgml 505170222Sdougb - End: 506170222Sdougb--> 507