nslookup(1m)

1nslookup(1M)            System Administration Commands            nslookup(1M)
2
3
4

NAME

6       nslookup - query Internet name servers interactively
7

SYNOPSIS

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

DESCRIPTION

13       The  nslookup  utility  is  a  program  to  query  Internet domain name
14       servers. It has two modes: interactive and non-interactive. Interactive
15       mode  allows the user to query name servers for information about vari‐
16       ous hosts and domains or to print a list of hosts  in  a  domain.  Non-
17       interactive  mode is used to print just the name and requested informa‐
18       tion for a host or domain.
19

PARAMETERS

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

INTERACTIVE COMMANDS

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

FILES

210       /etc/resolv.conf
211
212           resolver configuration file
213
214

ATTRIBUTES

216       See attributes(5) for descriptions of the following attributes:
217
218
219
220
221       ┌─────────────────────────────┬─────────────────────────────┐
222       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
223       ├─────────────────────────────┼─────────────────────────────┤
224       │Availability                 │SUNWbind                     │
225       ├─────────────────────────────┼─────────────────────────────┤
226       │Interface Stability          │External                     │
227       └─────────────────────────────┴─────────────────────────────┘
228

NOTES

233       nslookup and dig(1M) now report "Not Implemented" as NOTIMP rather than
234       NOTIMPL. This will have impact on scripts that are looking for NOTIMPL.
235
236
237       BIND  9  nslookup  is deprecated and not as full featured as its former
238       BIND 8 version. For more features and functionality refer to dig(1M).
239
240
241
242SunOS 5.11                        24 Dec 2008                     nslookup(1M)