Debian Codegraph @

upstream/debian-unstable/man1/whois.1

raw
1 .TH "WHOIS" "1" "2019-12-30" "Marco d'Itri" "Debian GNU/Linux"
2 .SH NAME
3 whois \- client for the whois directory service
4 .SH SYNOPSIS
5 .B whois
6 [
7 .RB {\~ \-h \~|\~ \-\-host \~}
8 .I HOST
9 ] [
10 .RB {\~ \-p \~|\~ \-\-port \~}
11 .I PORT
12 ]
13 .RB [\~ \-abBcdGHIKlLmMrRx
14 ]
15 .RB [\~ \-g \fI\~SOURCE:FIRST\-LAST\fR
16 ]
17 .RB [\~ \-i
18 .IR ATTR [, ATTR ]...\~]
19 .RB [\~ \-s
20 .IR SOURCE [, SOURCE ]...\~]
21 .RB [\~ \-T
22 .IR TYPE [, TYPE ]...\~]
23 .RB [\~ \-\-verbose \~]
24 .RB [\~ \-\-no\-recursion \~]
25 .I OBJECT
26
27 .B whois
28 .B \-q
29 .I KEYWORD
30
31 .B whois
32 .B \-t
33 .I TYPE
34
35 .B whois
36 .B \-v
37 .I TYPE
38
39 .B whois \-\-help
40
41 .B whois \-\-version
42
43 .SH DESCRIPTION
44 .B whois
45 searches for an object in a
46 .I RFC 3912
47 database.
48 .P
49 This version of the whois client tries to guess the right server to
50 ask for the specified object.
51 If no guess can be made it will connect to
52 .I whois.networksolutions.com
53 for NIC handles or
54 .I whois.arin.net
55 for IPv4 addresses and network names.
56 .SH OPTIONS
57 .TP 8
58 .B \-h
59 .IR HOST ,
60 .BI \-\-host= HOST
61 Connect to
62 .IR HOST .
63 .TP 8
64 .B \-H
65 Do not display the legal disclaimers that some registries like to show you.
66 .TP 8
67 .B \-p
68 .IR PORT ,
69 .BI \-\-port= PORT
70 Connect to
71 .IR PORT .
72 .TP 8
73 .B \-I
74 First query
75 .I whois.iana.org
76 and then follow its referral to the
77 whois server authoritative for that request.
78 This works for IP addresses,
79 AS numbers and domains.
80 .BR BEWARE :
81 this implies that the IANA server will receive your complete query.
82 .TP 8
83 .B \-\-no\-recursion
84 Disable recursion from registry to registrar servers.
85 .TP 8
86 .B \-\-verbose
87 Be verbose.
88 .TP 8
89 .B \-\-help
90 Display online help.
91 .TP 8
92 .B \-\-version
93 Display the program version.
94 .P
95 Other options are flags understood by
96 .I whois.ripe.net
97 and some other
98 RIPE-like servers:
99 .TP 8
100 .B \-a
101 Also search all the mirrored databases.
102 .TP 8
103 .B \-b
104 Return brief IP address ranges with abuse contact.
105 .TP 8
106 .B \-B
107 Disable objects filtering.
108 (Show the e-mail addresses.)
109 .TP 8
110 .B \-c
111 Return the smallest IP address range with a reference to an irt object.
112 .TP 8
113 .B \-d
114 Return the reverse DNS delegation object too.
115 .TP 8
116 .B \-g
117 .I SOURCE:FIRST\-LAST
118 Search updates from
119 .I SOURCE
120 database between
121 .I FIRST
122 and
123 .I LAST
124 update serial number.
125 It is useful to obtain Near Real Time Mirroring stream.
126 .TP 8
127 .B \-G
128 Disable grouping of associated objects.
129 .TP 8
130 .B \-i
131 .IR ATTR [, ATTR ]...
132 Inverse-search objects having associated attributes.
133 .I ATTR
134 is the attribute name, while the positional
135 .I OBJECT
136 argument is the attribute value.
137 .TP 8
138 .B \-K
139 Return primary key attributes only.
140 An exception is the
141 .I members
142 attribute of
143 .I set
144 objects, which is always returned.
145 Another exception are all
146 attributes of the objects
147 .IR organisation ,
148 .I person
149 and
150 .IR role ,
151 that are never returned.
152 .TP 8
153 .B \-l
154 Return the one level less specific object.
155 .TP 8
156 .B \-L
157 Return all levels of less specific objects.
158 .TP 8
159 .B \-m
160 Return all one level more specific objects.
161 .TP 8
162 .B \-M
163 Return all levels of more specific objects.
164 .TP 8
165 .B \-q
166 .I KEYWORD
167 Return information about the server.
168 .I KEYWORD
169 can be
170 .I version
171 for the server version,
172 .I sources
173 for the list of database sources or
174 .I types
175 for the list of supported object types.
176 .TP 8
177 .B \-r
178 Disable recursive lookups for contact information.
179 .TP 8
180 .B \-R
181 Disable following referrals and force showing the object from the local copy
182 in the server.
183 .TP 8
184 .B \-s
185 .IR SOURCE [, SOURCE ]...
186 Request the server to search for objects mirrored from
187 .IR SOURCE .
188 Sources are delimited by comma, and the order is significant.
189 Use the
190 .I \-q sources
191 parameter to obtain a list of valid sources.
192 .TP 8
193 .B \-t
194 .I TYPE
195 Return the template for a object of
196 .IR TYPE .
197 .TP 8
198 .B \-T
199 .IR TYPE [, TYPE ]...
200 Restrict the search to objects of
201 .IR TYPE .
202 Multiple types are separated by a comma.
203 .TP 8
204 .B \-v
205 .I TYPE
206 Return the verbose template for a object of
207 .IR TYPE .
208 .TP 8
209 .B \-x
210 Search for only exact match on network address prefix.
211 .SH NOTES
212 When querying the Verisign gTLDs
213 (e.g.\& \&.com, \&.net...\&)
214 thin registry servers
215 for a domain, the program will automatically prepend the
216 .I domain
217 keyword to only show domain records. The
218 .I nameserver
219 or
220 .I registrar
221 keywords must be used to show other kinds of records.
222 .P
223 When querying
224 .I whois.arin.net
225 for IPv4 or IPv6 networks, the CIDR
226 netmask length will be automatically removed from the query string.
227 .P
228 When querying
229 .I whois.nic.ad.jp
230 for AS numbers, the program will automatically convert the request
231 in the appropriate format, inserting a space after the string
232 .IR AS .
233 .P
234 When querying
235 .I whois.denic.de
236 for domain names and no other
237 flags have been specified, the program will automatically add the flag
238 .IR "\-T dn" .
239 .P
240 When querying
241 .I whois.dk\-hostmaster.dk
242 for domain names and no other
243 flags have been specified, the program will automatically add the flag
244 .IR "\-\-show\-handles" .
245 .P
246 RIPE-specific command line options are ignored when querying non-RIPE
247 servers.
248 This may or may not be the behaviour intended by the user.
249 When using non-standard query parameters then the command line options
250 which are not to be interpreted by the client must follow the
251 .I \-\-
252 separator (which marks the beginning of the query string).
253 .P
254 If the
255 .I /etc/whois.conf
256 configuration file exists, it will be consulted
257 to find a server before applying the normal rules.
258 Each line of the
259 file should contain a regular expression to be matched against the query
260 text and the whois server to use, separated by white space.
261 IDN domains must use the ACE format.
262 .P
263 The whois protocol does not specify an encoding for characters which
264 cannot be represented by ASCII and implementations vary wildly.
265 If the program knows that a specific server uses a certain encoding,
266 if needed it will transcode the server output to the encoding specified
267 by the current system locale.
268 .P
269 Command line arguments will always be interpreted accordingly to the
270 current system locale and converted to the IDN ASCII Compatible Encoding.
271 .SH "FILES"
272 /etc/whois.conf
273 .SH "ENVIRONMENT"
274 .IP LANG
275 When querying
276 .I whois.nic.ad.jp
277 and
278 .I whois.jprs.jp
279 English text is requested unless the
280 .I LANG
281 or
282 .I LC_MESSAGES
283 environment variables specify a Japanese locale.
284 .IP "WHOIS_OPTIONS"
285 A list of options which will be evaluated before the ones specified on the
286 command line.
287 .IP "WHOIS_SERVER"
288 This server will be queried if the program cannot guess where some kind
289 of objects are located.
290 If the variable does not exist then
291 .I whois.arin.net
292 will be queried.
293 .SH "SEE ALSO"
294 .IR whois.conf (5).
295 .P
296 .IR "RFC 3912" :
297 WHOIS Protocol Specification.
298 .P
299 .IR "RIPE Database Query Reference Manual" :
300 .RI < https://www.ripe.net/\:data\-tools/\:support/\:documentation/\:ripe\-database\-query\-reference\-manual >
301 .SH BUGS
302 The program may have buffer overflows in the command line parser:
303 be sure to not pass untrusted data to it.
304 It should be rewritten to use a dynamic strings library.
305 .SH HISTORY
306 This program closely tracks the user interface of the whois client
307 developed at RIPE by Ambrose Magee and others on the base of the
308 original BSD client.
309 .SH AUTHOR
310 .B Whois
311 and this man page were written by Marco d'Itri
312 .RI < [email protected] >
313 and are licensed under the terms of the GNU General Public License,
314 version 2 or later.
315 .\" SPDX-License-Identifier: GPL-2.0-or-later