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