usr.bin/whois/whois.1

   1 .\"     $NetBSD: whois.1,v 1.24 2007/09/09 18:31:45 christos Exp $
   2 .\"     $OpenBSD: whois.1,v 1.22 2003/09/02 18:50:07 jmc Exp $
   3 .\"
   4 .\" Copyright (c) 1985, 1990, 1993
   5 .\"     The Regents of the University of California.  All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. Neither the name of the University nor the names of its contributors
  16 .\"    may be used to endorse or promote products derived from this software
  17 .\"    without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .\"     @(#)whois.1     8.2 (Berkeley) 6/20/94
  32 .\"
  33 .Dd September 9, 2007
  34 .Dt WHOIS 1
  35 .Os
  36 .Sh NAME
  37 .Nm whois
  38 .Nd Internet domain name and network number directory service
  39 .Sh SYNOPSIS
  40 .Nm whois
  41 .Op Fl 6AadfgilmQRr
  42 .Oo
  43 .Fl c Ar country-code | Fl h Ar host
  44 .Oc
  45 .Op Fl p Ar port
  46 .Ar name Op Ar ...
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 utility looks up records in the databases maintained by several
  51 Network Information Centers
  52 .Pq Tn NICs .
  53 .Pp
  54 The options are as follows:
  55 .Bl -tag -width Ds
  56 .It Fl 6
  57 Use the IPv6 Resource Center
  58 .Pq Tn 6bone
  59 database.
  60 It contains network names and addresses for the IPv6 network.
  61 .It Fl A
  62 Use the Asia/Pacific Network Information Center
  63 .Pq Tn APNIC
  64 database.
  65 It contains network numbers used in East Asia, Australia,
  66 New Zealand, and the Pacific islands.
  67 .It Fl a
  68 Use the American Registry for Internet Numbers
  69 .Pq Tn ARIN
  70 database.
  71 It contains network numbers used in those parts of the world
  72 not covered by
  73 .Tn AfriNIC ,
  74 .Tn APNIC ,
  75 .Tn LACNIC
  76 or by
  77 .Tn RIPE .
  78 .Pp
  79 (Hint: All point of contact handles in the
  80 .Tn ARIN
  81 whois database end with
  82 .Qq Li -ARIN . )
  83 .It Fl c Ar country-code
  84 This is the equivalent of using the
  85 .Fl h
  86 option with an argument of
  87 .Qq Ar country-code Ns Li .whois-servers.net .
  88 .It Fl d
  89 Use the US Department of Defense database.
  90 It contains points of contact for subdomains of
  91 .Tn \&.MIL .
  92 .It Fl f
  93 Use the African Network Information Center
  94 .Pq Tn AfriNIC
  95 database.
  96 It contains network numbers used in Africa.
  97 .It Fl g
  98 Use the US non-military federal government database, which contains points of
  99 contact for subdomains of
 100 .Tn \&.GOV .
 101 .It Fl h Ar host
 102 Use the specified host instead of the default NIC
 103 (whois.crsnic.net).
 104 Either a host name or an IP address may be specified.
 105 .Pp
 106 By default
 107 .Nm
 108 constructs the name of a whois server to use from the top-level domain
 109 .Pq Tn TLD
 110 of the supplied (single) argument, and appending
 111 .Qq Li .whois-servers.net .
 112 This effectively allows a suitable whois server to be selected
 113 automatically for a large number of
 114 .Tn TLDs .
 115 .Pp
 116 In the event that an IP
 117 address is specified, the whois server will default to the American
 118 Registry for Internet Numbers
 119 .Pq Tn ARIN .
 120 If a query to
 121 .Tn ARIN
 122 references
 123 .Tn AfriNIC, APNIC , LACNIC ,
 124 or
 125 .Tn RIPE ,
 126 that server will be queried also, provided that the
 127 .Fl Q
 128 option is not specified.
 129 .Pp
 130 If the query is not a domain name or IP address,
 131 .Nm
 132 will fall back to
 133 .Pa whois.crsnic.net .
 134 .It Fl i
 135 Use the Network Solutions Registry for Internet Numbers
 136 .Pq Tn whois.networksolutions.com
 137 database.
 138 Historically, it contained network numbers and domain contact information
 139 for most of
 140 .Tn \&.COM ,
 141 .Tn \&.NET ,
 142 .Tn \&.ORG
 143 and
 144 .Tn \&.EDU
 145 domains.
 146 However, the registration of these domains is now done by a number of
 147 independent and competing registrars and this database holds no information
 148 on the domains registered by organizations other than Network Solutions, Inc.
 149 Also, note that the
 150 .Tn InterNIC
 151 database
 152 .Pq Pa whois.internic.net
 153 is no longer handled by Network Solutions, Inc.
 154 For details, see
 155 .Pa http://www.internic.net/ .
 156 .Pp
 157 (Hint: Contact information, identified by the term
 158 .Em handle ,
 159 can be looked up by prefixing
 160 .Qq Li \&!
 161 or
 162 .Qq Li handle\ \&
 163 to the
 164 .Tn NIC
 165 handle in the query.)
 166 .It Fl l
 167 Use the Latin American and Caribbean IP address Regional Registry
 168 .Pq Tn LACNIC
 169 database.
 170 It contains network numbers used in much of Latin America and the
 171 Caribbean.
 172 .It Fl m
 173 Use the Route Arbiter Database
 174 .Pq Tn RADB
 175 database.
 176 It contains route policy specifications for a large
 177 number of operators' networks.
 178 .It Fl p Ar port
 179 Connect to the whois server on
 180 .Ar port .
 181 If this option is not specified,
 182 .Nm
 183 defaults to the
 184 .Dq whois
 185 port listed in
 186 .Pa /etc/services
 187 (port 43).
 188 .It Fl Q
 189 Do a quick lookup.
 190 This means that
 191 .Nm
 192 will not attempt to lookup the name in the authoritative whois
 193 server (if one is listed) nor will it contact InterNic if a lookup
 194 fails.
 195 This flag has no effect when combined with any other flag.
 196 .It Fl R
 197 Use the Russia Network Information Center
 198 .Pq Tn RIPN
 199 database.
 200 It contains network numbers and domain contact information
 201 for subdomains of
 202 .Tn \&.RU .
 203 This option is deprecated; use the
 204 .Fl c
 205 option with an argument of
 206 .Qq Li RU
 207 instead.
 208 .It Fl r
 209 Use the R\(aaeseaux IP Europ\(aaeens
 210 .Pq Tn RIPE
 211 database.
 212 It contains network numbers and domain contact information for Europe.
 213 .El
 214 .Pp
 215 The default action, unless directed otherwise with a special
 216 .Ar name ,
 217 is to do a very broad search, looking for matches to
 218 .Ar name
 219 in all types of records and most fields (name, nicknames, hostname, net
 220 address, etc.) in the database.
 221 For more information as to what
 222 .Ar name
 223 operands have special meaning, and how to guide the search, use
 224 the special name
 225 .Dq help .
 226 .Ss Special cases
 227 Queries beginning with an exclamation point
 228 .Ql \&!
 229 are assumed to be
 230 .Tn NSI
 231 contact handles.
 232 Unless a host or domain is specified on the command line,
 233 .Pq Tn whois.networksolutions.com
 234 will be used as the
 235 .Nm
 236 database.
 237 .Pp
 238 Similarly, queries beginning with
 239 .Dq COCO-
 240 are assumed to be
 241 .Tn CORE
 242 contact handles.
 243 Unless a host or domain is specified on the command line,
 244 .Pq Tn whois.corenic.net
 245 will be used as the
 246 .Nm
 247 database.
 248 .Sh EXAMPLES
 249 Most types of data, such as domain names and
 250 .Tn IP
 251 addresses, can be used as arguments to
 252 .Nm
 253 without any options, and
 254 .Nm
 255 will choose the correct whois server to query.
 256 Some exceptions, where
 257 .Nm
 258 will not be able to handle data correctly, are detailed below.
 259 .Pp
 260 To obtain contact information about an
 261 administrator located in the Russian
 262 .Tn TLD
 263 domain
 264 .Qq Li RU ,
 265 use the
 266 .Fl c
 267 option as shown in the following example, where
 268 .Ar CONTACT-ID
 269 is substituted with the actual contact identifier.
 270 .Pp
 271 .Dl "whois -c RU CONTACT-ID"
 272 .Pp
 273 (Note: This example is specific to the
 274 .Tn TLD
 275 .Qq Li RU ,
 276 but other
 277 .Tn TLDs
 278 can be queried by using a similar syntax.)
 279 .Pp
 280 The following example demonstrates how to obtain information about an
 281 .Tn IPv6
 282 address or hostname using the
 283 .Fl 6
 284 option, which directs the query to
 285 .Tn 6bone .
 286 .Pp
 287 .Dl "whois -6 IPv6-IP-Address"
 288 .Pp
 289 The following example demonstrates how to query
 290 a whois server using a non-standard port, where
 291 .Dq Li query-data
 292 is the query to be sent to
 293 .Dq Li whois.example.com
 294 on port
 295 .Dq Li rwhois
 296 (written numerically as 4321).
 297 .Pp
 298 .Dl "whois -h whois.example.com -p rwhois query-data"
 299 .Sh SEE ALSO
 300 .Rs
 301 .%A Ken Harrenstien
 302 .%A Vic White
 303 .%T NICNAME/WHOIS
 304 .%D 1 March 1982
 305 .%O RFC 812
 306 .Re
 307 .Sh HISTORY
 308 The
 309 .Nm
 310 command appeared in
 311 .Bx 4.3 .