nslookup.1 6.9 KB
Newer Older
Tinderbox User's avatar
Tinderbox User committed
1
.\" Copyright (C) 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
Rob Austein's avatar
regen  
Rob Austein committed
2
.\" 
Tinderbox User's avatar
Tinderbox User committed
3 4 5
.\" This Source Code Form is subject to the terms of the Mozilla Public
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
.\" file, You can obtain one at http://mozilla.org/MPL/2.0/.
Rob Austein's avatar
regen  
Rob Austein committed
6
.\"
Rob Austein's avatar
regen  
Rob Austein committed
7 8
.hy 0
.ad l
Tinderbox User's avatar
Tinderbox User committed
9
'\" t
Mark Andrews's avatar
regen  
Mark Andrews committed
10 11
.\"     Title: nslookup
.\"    Author: 
Tinderbox User's avatar
Tinderbox User committed
12
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
Tinderbox User's avatar
Tinderbox User committed
13
.\"      Date: 2014-01-24
Mark Andrews's avatar
regen  
Mark Andrews committed
14
.\"    Manual: BIND9
Tinderbox User's avatar
Tinderbox User committed
15 16
.\"    Source: ISC
.\"  Language: English
Mark Andrews's avatar
regen  
Mark Andrews committed
17
.\"
Tinderbox User's avatar
Tinderbox User committed
18 19 20 21 22 23 24 25 26 27 28 29 30
.TH "NSLOOKUP" "1" "2014\-01\-24" "ISC" "BIND9"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
Mark Andrews's avatar
regen  
Mark Andrews committed
31 32 33 34
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
Tinderbox User's avatar
Tinderbox User committed
35 36 37
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
Mark Andrews's avatar
regen  
Mark Andrews committed
38
.SH "NAME"
Mark Andrews's avatar
regen  
Mark Andrews committed
39
nslookup \- query Internet name servers interactively
Rob Austein's avatar
regen  
Rob Austein committed
40
.SH "SYNOPSIS"
Tinderbox User's avatar
Tinderbox User committed
41
.HP \w'\fBnslookup\fR\ 'u
Rob Austein's avatar
regen  
Rob Austein committed
42
\fBnslookup\fR [\fB\-option\fR] [name\ |\ \-] [server]
Mark Andrews's avatar
regen  
Mark Andrews committed
43 44
.SH "DESCRIPTION"
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
45
\fBNslookup\fR
Tinderbox User's avatar
Tinderbox User committed
46
is a program to query Internet domain name servers\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
47
\fBNslookup\fR
Tinderbox User's avatar
Tinderbox User committed
48
has two modes: interactive and non\-interactive\&. Interactive mode allows the user to query name servers for information about various hosts and domains or to print a list of hosts in a domain\&. Non\-interactive mode is used to print just the name and requested information for a host or domain\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
49 50
.SH "ARGUMENTS"
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
51
Interactive mode is entered in the following cases:
Tinderbox User's avatar
Tinderbox User committed
52 53 54 55 56 57 58 59 60
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Mark Andrews's avatar
regen  
Mark Andrews committed
61
when no arguments are given (the default name server will be used)
Tinderbox User's avatar
Tinderbox User committed
62
.RE
Mark Andrews's avatar
regen  
Mark Andrews committed
63
.sp
Tinderbox User's avatar
Tinderbox User committed
64 65 66 67 68 69 70 71 72
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
when the first argument is a hyphen (\-) and the second argument is the host name or Internet address of a name server\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
73
.RE
Mark Andrews's avatar
regen  
Mark Andrews committed
74
.PP
Tinderbox User's avatar
Tinderbox User committed
75
Non\-interactive mode is used when the name or Internet address of the host to be looked up is given as the first argument\&. The optional second argument specifies the host name or address of a name server\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
76
.PP
Tinderbox User's avatar
Tinderbox User committed
77
Options can also be specified on the command line if they precede the arguments and are prefixed with a hyphen\&. For example, to change the default query type to host information, and the initial timeout to 10 seconds, type:
Automatic Updater's avatar
Automatic Updater committed
78
.sp
Tinderbox User's avatar
Tinderbox User committed
79
.if n \{\
Automatic Updater's avatar
Automatic Updater committed
80
.RS 4
Tinderbox User's avatar
Tinderbox User committed
81
.\}
Automatic Updater's avatar
Automatic Updater committed
82 83 84
.nf
nslookup \-query=hinfo  \-timeout=10
.fi
Tinderbox User's avatar
Tinderbox User committed
85
.if n \{\
Automatic Updater's avatar
Automatic Updater committed
86
.RE
Tinderbox User's avatar
Tinderbox User committed
87
.\}
Tinderbox User's avatar
Tinderbox User committed
88 89 90 91 92
.PP
The
\fB\-version\fR
option causes
\fBnslookup\fR
Tinderbox User's avatar
Tinderbox User committed
93
to print the version number and immediately exits\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
94
.SH "INTERACTIVE COMMANDS"
Mark Andrews's avatar
regen  
Mark Andrews committed
95
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
96
\fBhost\fR [server]
Mark Andrews's avatar
regen  
Mark Andrews committed
97
.RS 4
Tinderbox User's avatar
Tinderbox User committed
98
Look up information for host using the current default server or using server, if specified\&. If host is an Internet address and the query type is A or PTR, the name of the host is returned\&. If host is a name and does not have a trailing period, the search list is used to qualify the name\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
99
.sp
Tinderbox User's avatar
Tinderbox User committed
100
To look up a host not in the current domain, append a period to the name\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
101 102
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
103
\fBserver\fR \fIdomain\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
104 105 106
.RS 4
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
107
\fBlserver\fR \fIdomain\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
108
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
109 110 111 112 113 114
Change the default server to
\fIdomain\fR;
\fBlserver\fR
uses the initial server to look up information about
\fIdomain\fR, while
\fBserver\fR
Tinderbox User's avatar
Tinderbox User committed
115
uses the current default server\&. If an authoritative answer can\*(Aqt be found, the names of servers that might have the answer are returned\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
116 117
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
118
\fBroot\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
119
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
120
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
121 122
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
123
\fBfinger\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
124
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
125
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
126 127
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
128
\fBls\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
129
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
130
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
131 132
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
133
\fBview\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
134
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
135
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
136 137
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
138
\fBhelp\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
139
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
140
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
141 142
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
143
\fB?\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
144
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
145
not implemented
Mark Andrews's avatar
regen  
Mark Andrews committed
146 147
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
148
\fBexit\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
149
.RS 4
Tinderbox User's avatar
Tinderbox User committed
150
Exits the program\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
151 152
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
153
\fBset\fR \fIkeyword\fR\fI[=value]\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
154
.RS 4
Tinderbox User's avatar
Tinderbox User committed
155
This command is used to change state information that affects the lookups\&. Valid keywords are:
Mark Andrews's avatar
regen  
Mark Andrews committed
156
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
157
\fBall\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
158
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
159
Prints the current values of the frequently used options to
Tinderbox User's avatar
Tinderbox User committed
160
\fBset\fR\&. Information about the current default server and host is also printed\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
161 162
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
163
\fBclass=\fR\fIvalue\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
164
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
165
Change the query class to one of:
Mark Andrews's avatar
regen  
Mark Andrews committed
166
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
167
\fBIN\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
168
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
169
the Internet class
Mark Andrews's avatar
regen  
Mark Andrews committed
170 171
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
172
\fBCH\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
173
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
174
the Chaos class
Mark Andrews's avatar
regen  
Mark Andrews committed
175 176
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
177
\fBHS\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
178
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
179
the Hesiod class
Mark Andrews's avatar
regen  
Mark Andrews committed
180 181
.RE
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
182
\fBANY\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
183
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
184 185
wildcard
.RE
Tinderbox User's avatar
Tinderbox User committed
186 187
.sp
The class specifies the protocol group of the information\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
188
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
189
(Default = IN; abbreviation = cl)
Mark Andrews's avatar
regen  
Mark Andrews committed
190 191
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
192
\fB\fI[no]\fR\fR\fBdebug\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
193
.RS 4
Tinderbox User's avatar
Tinderbox User committed
194
Turn on or off the display of the full response packet and any intermediate response packets when searching\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
195 196 197
.sp
(Default = nodebug; abbreviation =
[no]deb)
Mark Andrews's avatar
regen  
Mark Andrews committed
198 199
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
200
\fB\fI[no]\fR\fR\fBd2\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
201
.RS 4
Tinderbox User's avatar
Tinderbox User committed
202
Turn debugging mode on or off\&. This displays more about what nslookup is doing\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
203
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
204
(Default = nod2)
Mark Andrews's avatar
regen  
Mark Andrews committed
205 206
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
207
\fBdomain=\fR\fIname\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
208
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
209
Sets the search list to
Tinderbox User's avatar
Tinderbox User committed
210
\fIname\fR\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
211 212
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
213
\fB\fI[no]\fR\fR\fBsearch\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
214
.RS 4
Tinderbox User's avatar
Tinderbox User committed
215
If the lookup request contains at least one period but doesn\*(Aqt end with a trailing period, append the domain names in the domain search list to the request until an answer is received\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
216
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
217
(Default = search)
Mark Andrews's avatar
regen  
Mark Andrews committed
218 219
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
220
\fBport=\fR\fIvalue\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
221
.RS 4
Mark Andrews's avatar
regen  
Mark Andrews committed
222
Change the default TCP/UDP name server port to
Tinderbox User's avatar
Tinderbox User committed
223
\fIvalue\fR\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
224
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
225
(Default = 53; abbreviation = po)
Mark Andrews's avatar
regen  
Mark Andrews committed
226 227
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
228
\fBquerytype=\fR\fIvalue\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
229 230 231
.RS 4
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
232
\fBtype=\fR\fIvalue\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
233
.RS 4
Tinderbox User's avatar
Tinderbox User committed
234
Change the type of the information query\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
235
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
236
(Default = A; abbreviations = q, ty)
Mark Andrews's avatar
regen  
Mark Andrews committed
237 238
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
239
\fB\fI[no]\fR\fR\fBrecurse\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
240
.RS 4
Tinderbox User's avatar
Tinderbox User committed
241
Tell the name server to query other servers if it does not have the information\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
242
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
243
(Default = recurse; abbreviation = [no]rec)
Mark Andrews's avatar
regen  
Mark Andrews committed
244 245
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
246 247
\fBndots=\fR\fInumber\fR
.RS 4
Tinderbox User's avatar
Tinderbox User committed
248
Set the number of dots (label separators) in a domain that will disable searching\&. Absolute names always stop searching\&.
Tinderbox User's avatar
Tinderbox User committed
249 250
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
251
\fBretry=\fR\fInumber\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
252
.RS 4
Tinderbox User's avatar
Tinderbox User committed
253
Set the number of retries to number\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
254 255
.RE
.PP
Rob Austein's avatar
regen  
Rob Austein committed
256
\fBtimeout=\fR\fInumber\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
257
.RS 4
Tinderbox User's avatar
Tinderbox User committed
258
Change the initial timeout interval for waiting for a reply to number seconds\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
259 260
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
261
\fB\fI[no]\fR\fR\fBvc\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
262
.RS 4
Tinderbox User's avatar
Tinderbox User committed
263
Always use a virtual circuit when sending requests to the server\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
264
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
265
(Default = novc)
Mark Andrews's avatar
regen  
Mark Andrews committed
266 267
.RE
.PP
Tinderbox User's avatar
Tinderbox User committed
268
\fB\fI[no]\fR\fR\fBfail\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
269
.RS 4
Tinderbox User's avatar
Tinderbox User committed
270
Try the next nameserver if a nameserver responds with SERVFAIL or a referral (nofail) or terminate query (fail) on such a response\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
271
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
272
(Default = nofail)
Mark Andrews's avatar
regen  
Mark Andrews committed
273
.RE
Tinderbox User's avatar
Tinderbox User committed
274
.sp
Mark Andrews's avatar
regen  
Mark Andrews committed
275
.RE
Tinderbox User's avatar
Tinderbox User committed
276 277 278 279
.SH "RETURN VALUES"
.PP
\fBnslookup\fR
returns with an exit status of 1 if any query failed, and 0 otherwise\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
280 281
.SH "FILES"
.PP
Tinderbox User's avatar
Tinderbox User committed
282
/etc/resolv\&.conf
Mark Andrews's avatar
regen  
Mark Andrews committed
283 284
.SH "SEE ALSO"
.PP
Mark Andrews's avatar
regen  
Mark Andrews committed
285 286
\fBdig\fR(1),
\fBhost\fR(1),
Tinderbox User's avatar
Tinderbox User committed
287
\fBnamed\fR(8)\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
288 289
.SH "AUTHOR"
.PP
Tinderbox User's avatar
Tinderbox User committed
290
\fBInternet Systems Consortium, Inc\&.\fR
Mark Andrews's avatar
regen  
Mark Andrews committed
291
.SH "COPYRIGHT"
Tinderbox User's avatar
Tinderbox User committed
292
.br
Tinderbox User's avatar
Tinderbox User committed
293
Copyright \(co 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
Mark Andrews's avatar
regen  
Mark Andrews committed
294
.br