nslookup.html revision 4f6469885c3d66367e3f8fb94e1f3c66115990b0
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - Permission to use, copy, modify, and distribute this software for any
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - purpose with or without fee is hereby granted, provided that the above
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - copyright notice and this permission notice appear in all copies.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews<!-- $Id: nslookup.html,v 1.2 2004/08/21 09:49:57 marka Exp $ -->
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>nslookup</TITLE
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsNAME="GENERATOR"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.73
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFENTRY"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsBGCOLOR="#FFFFFF"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsTEXT="#000000"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsLINK="#0000FF"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsVLINK="#840084"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsALINK="#0000FF"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFNAMEDIV"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>nslookup -- query Internet name servers interactively</DIV
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSYNOPSISDIV"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Synopsis</H2
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="COMMAND"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTION"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>] [name | -] [server]</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>DESCRIPTION</H2
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="COMMAND"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsis a program to query Internet domain name servers. <B
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="COMMAND"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewshas two modes: interactive and non-interactive. Interactive mode allows
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsthe user to query name servers for information about various hosts and
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsdomains or to print a list of hosts in a domain. Non-interactive mode is
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsused to print just the name and requested information for a host or
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>ARGUMENTS</H2
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Interactive mode is entered in the following cases:
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>when no arguments are given (the default name server will be used)</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>when the first argument is a hyphen (-) and the second argument is
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsthe host name or Internet address of a name server.</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Non-interactive mode is used when the name or Internet address of the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewshost to be looked up is given as the first argument. The optional second
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsargument specifies the host name or address of a name server.</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Options can also be specified on the command line if they precede the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsarguments and are prefixed with a hyphen. For example, to
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewschange the default query type to host information, and the initial timeout to 10 seconds, type:
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="INFORMALEXAMPLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="PROGRAMLISTING"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>nslookup -query=hinfo -timeout=10</PRE
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>INTERACTIVE COMMANDS</H2
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="VARIABLELIST"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>server</SPAN
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Look up information for host using the current default server or
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsusing server, if specified. If host is an Internet address and
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsthe query type is A or PTR, the name of the host is returned.
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsIf host is a name and does not have a trailing period, the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewssearch list is used to qualify the name.</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>To look up a host not in the current domain, append a period to
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Change the default server to <TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> uses the initial
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsserver to look up information about <TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsthe current default server. If an authoritative answer can't be
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsfound, the names of servers that might have the answer are
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>not implemented</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Exits the program.</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>keyword[<SPAN
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>=value</SPAN
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>This command is used to change state information that affects
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrewsthe lookups. Valid keywords are:
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="VARIABLELIST"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Prints the current values of the frequently used
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews options to <B
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="COMMAND"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>. Information about the current default
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews server and host is also printed.
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Change the query class to one of:
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="VARIABLELIST"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>the Internet class</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>the Chaos class</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>the Hesiod class</P
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews The class specifies the protocol group of the information.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = IN; abbreviation = cl)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Turn debugging mode on. A lot more information is
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews printed about the packet sent to the server and the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews resulting answer.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = nodebug; abbreviation = [<SPAN
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Turn debugging mode on. A lot more information is
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews printed about the packet sent to the server and the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews resulting answer.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = nod2)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Sets the search list to <TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> If the lookup request contains at least one period but
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews doesn't end with a trailing period, append the domain
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews names in the domain search list to the request until an
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews answer is received.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = search)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Change the default TCP/UDP name server port to <TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = 53; abbreviation = po)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>querytype=</TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Change the top of the information query.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = A; abbreviations = q, ty)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Tell the name server to query other servers if it does not have the
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews information.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = recurse; abbreviation = [no]rec)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Set the number of retries to number.
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>timeout=</TT
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Change the initial timeout interval for waiting for a
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews reply to number seconds.
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CONSTANT"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REPLACEABLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="OPTIONAL"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> Always use a virtual circuit when sending requests to the server.
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews> (Default = novc)
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsNAME="AEN218"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="FILENAME"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsNAME="AEN222"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>SEE ALSO</H2
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CITEREFENTRY"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFENTRYTITLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CITEREFENTRY"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFENTRYTITLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="CITEREFENTRY"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFENTRYTITLE"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsCLASS="REFSECT1"
3eb9ec750c9088869170dda63e8899b2ba462823Mark AndrewsNAME="AEN234"
3eb9ec750c9088869170dda63e8899b2ba462823Mark Andrews>Andrew Cherenson</P