usr.bin/whois/whois.1

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