1NSLOOKUP(1)                          BIND9                         NSLOOKUP(1)
2
3
4

NAME

6       nslookup - query Internet name servers interactively
7

SYNOPSIS

9       nslookup [-option] [name | -] [server]
10

DESCRIPTION

12       Nslookup is a program to query Internet domain name servers.  Nslookup
13       has two modes: interactive and non-interactive. Interactive mode allows
14       the user to query name servers for information about various hosts and
15       domains or to print a list of hosts in a domain. Non-interactive mode
16       is used to print just the name and requested information for a host or
17       domain.
18

ARGUMENTS

20       Interactive mode is entered in the following cases:
21
22       1.  when no arguments are given (the default name server will be used)
23
24       2.  when the first argument is a hyphen (-) and the second argument is
25           the host name or Internet address of a name server.
26
27
28Non-interactive mode is used when the name or Internet address of the host to
29be looked up is given as the first argument. The optional second argument
30specifies the host name or address of a name server.
31
32Options can also be specified on the command line if they precede the
33arguments and are prefixed with a hyphen. For example, to change the default
34query type to host information, and the initial timeout to 10 seconds, type:
35
36    nslookup -query=hinfo  -timeout=10
37
38

INTERACTIVE COMMANDS

40       host [server]
41           Look up information for host using the current default server or
42           using server, if specified. If host is an Internet address and the
43           query type is A or PTR, the name of the host is returned. If host
44           is a name and does not have a trailing period, the search list is
45           used to qualify the name.
46
47           To look up a host not in the current domain, append a period to the
48           name.
49
50       server domain
51
52       lserver domain
53           Change the default server to domain; lserver uses the initial
54           server to look up information about domain, while server uses the
55           current default server. If an authoritative answer can't be found,
56           the names of servers that might have the answer are returned.
57
58       root
59           not implemented
60
61       finger
62           not implemented
63
64       ls
65           not implemented
66
67       view
68           not implemented
69
70       help
71           not implemented
72
73       ?
74           not implemented
75
76       exit
77           Exits the program.
78
79       set keyword[=value]
80           This command is used to change state information that affects the
81           lookups. Valid keywords are:
82
83               all
84                   Prints the current values of the frequently used options to
85                   set. Information about the current default server and host
86                   is also printed.
87
88               class=value
89                   Change the query class to one of:
90
91                       IN
92                           the Internet class
93
94                       CH
95                           the Chaos class
96
97                       HS
98                           the Hesiod class
99
100                       ANY
101                           wildcard
102
103                       The class specifies the protocol group of the
104                       information.
105
106                       (Default = IN; abbreviation = cl)
107
108                [no]debug
109                   Turn on or off the display of the full response packet and
110                   any intermediate response packets when searching.
111
112                   (Default = nodebug; abbreviation = [no]deb)
113
114                [no]d2
115                   Turn debugging mode on or off. This displays more about
116                   what nslookup is doing.
117
118                   (Default = nod2)
119
120               domain=name
121                   Sets the search list to name.
122
123                [no]search
124                   If the lookup request contains at least one period but
125                   doesn't end with a trailing period, append the domain names
126                   in the domain search list to the request until an answer is
127                   received.
128
129                   (Default = search)
130
131               port=value
132                   Change the default TCP/UDP name server port to value.
133
134                   (Default = 53; abbreviation = po)
135
136               querytype=value
137
138               type=value
139                   Change the type of the information query.
140
141                   (Default = A; abbreviations = q, ty)
142
143                [no]recurse
144                   Tell the name server to query other servers if it does not
145                   have the information.
146
147                   (Default = recurse; abbreviation = [no]rec)
148
149               retry=number
150                   Set the number of retries to number.
151
152               timeout=number
153                   Change the initial timeout interval for waiting for a reply
154                   to number seconds.
155
156                [no]vc
157                   Always use a virtual circuit when sending requests to the
158                   server.
159
160                   (Default = novc)
161
162                [no]fail
163                   Try the next nameserver if a nameserver responds with
164                   SERVFAIL or a referral (nofail) or terminate query (fail)
165                   on such a response.
166
167                   (Default = nofail)
168
169
170

FILES

172       /etc/resolv.conf
173

SEE ALSO

175       dig(1), host(1), named(8).
176

AUTHOR

178       Andrew Cherenson
179

181       Copyright © 2004-2007, 2010 Internet Systems Consortium, Inc. ("ISC")
182
183
184
185BIND9                            Jun 30, 2000                      NSLOOKUP(1)
Impressum