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