xref: /netbsd-src/usr.bin/whois/whois.1 (revision e4d7c2e329d54c97e0c0bd3016bbe74f550c3d5e)
1.\"	$NetBSD: whois.1,v 1.12 1999/10/05 11:56:15 matthias Exp $
2.\"
3.\" Copyright (c) 1985, 1990, 1993
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by the University of
17.\"	California, Berkeley and its contributors.
18.\" 4. Neither the name of the University nor the names of its contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"    without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
34.\"     @(#)whois.1	8.2 (Berkeley) 6/20/94
35.\"
36.Dd June 20, 1994
37.Dt WHOIS 1
38.Os
39.Sh NAME
40.Nm whois
41.Nd TCP/IP Internet directory service, RIPE version
42.Sh SYNOPSIS
43.Nm ""
44.Op Fl 46aFSrR
45.Op Fl h Ar host
46.Op Fl p Ar port
47.Op Fl i Ar attributes
48.Op Fl s Ar sources
49.Op Fl T Ns Ar \ types
50.Op Fl L | m | M
51.Ar identifier
52.Nm ""
53.Fl t Ar type
54.Nm ""
55.Fl v Ar type
56.Sh DESCRIPTION
57.Nm
58searches for an object in the RIPE Network Management database.
59The key can be either a name (such as "Karrenberg"),a nic-handle
60(such as "DK58"),
61a network number ("192.87.45.0/24") or a domain name ("ripe.net").
62
63This version of the whois client works with a version of the RIPE
64database whois server that supports classless IP addresses.
65All IP network numbers are considered classless IP network numbers of
66the form prefix/length, like 192.87.45.0/24 for a class C sized network
67number and 128.86.0.0/16 for a class B sized network number. Any
68length can be given. If no length is given, the server assumes a host
69lookup (ie length 32).
70
71By default, the server will return the first less specific network
72number, which can be an exact match if available in the database.
73.Sh OPTIONS
74.Bl -tag -width indent
75.It Fl a
76This causes the server to include information from
77non-RIPE whois databases in the reply. Currently these are the public
78parts of the US NIC and NSFnet databases. Please note that the RIPE
79NCC does not maintain these databases. The information is included for
80for your convenience only.
81.It Fl F
82fast output. Force the whois server to not reformat the output. This
83can save time for large objects. The output of the RIPE whois server
84will be in two letter short form. This option implies -r.
85.It Fl h Ar host
86Select alternate host to direct the query
87.It Fl p Ar port
88Connect to port 'port'
89.It Fl L
90lookup all less specific networks. Has effect only when looking up IP
91network numbers.
92.It Fl m
93lookup first level more specific networks. Has effect only when
94looking up IP network numbers.
95.It Fl M
96lookup all more specific networks. Has effect only when looking up IP
97network numbers.
98.It Fl r
99non-recursive lookup. This will cause the server to not lookup
100referenced objects.
101.It Fl R
102suppress referrals. Forces local copy of a domain object to be shown
103even if it contains referral.
104.It Fl i Ar attributes
105attributes is a comma separated list of attributes.
106the whois server will return all objects that match the search keys
107in one of these attributes.
108.It Fl s Ar sources
109sources is a comma separated list of database sources.
110The whois server will only search the databases that match the
111specified sources.
112.It Fl S
113requests the server to leave out "syntactic sugar" that may normally
114be inserted in some database objects.
115.It Fl t Ar type
116requests the server to send a template for an object with type "type".
117.It Fl v Ar type
118requests the server to send a verbose template for an object with type "type".
119.It Fl T Ar types
120types is a comma separated list of object types.
121requests the server to only send back objects that match one of the "types".
122By default, whois connect to whois server both IPv6 and IPv4. If you want
123to connect IPv4 only, you use
124.It Fl 4
125option, and if you want to connect IPv6 only, you use
126.It Fl 6
127option.
128.El
129.Lp
130.Sh EXAMPLES
131.Bd -literal -offset indent
132$ whois karrenberg
133person:  Daniel Karrenberg
134address: RIPE Network Coordination Centre
135address: Kruislaan 409
136address: NL-1098 SJ Amsterdam
137address: Netherlands
138phone:   +31 20 5925065
139fax-no:  +31 20 5925155
140e-mail:  dfk@ripe.net
141nic-hdl: DK58
142changed: dfk@ripe.net 920407
143changed: ripe-dbm@ripe.net 920407
144source:  RIPE
145$ whois -h whois.ripe.net -r 192.87.45.0/24
146inetnum:     192.87.45.0
147netname:     RIPE-NCC
148descr:       RIPE Network Coordination Centre
149descr:       Amsterdam, Netherlands
150country:     NL
151admin-c:     Daniel Karrenberg
152tech-c:      Marten Terpstra
153connect:     RIPE NSF WCW
154aut-sys:     AS3333
155ias-int:     192.87.45.80  AS1104
156ias-int:     192.87.45.6   AS2122
157ias-int:     192.87.45.254 AS2600
158rev-srv:     ns.ripe.net
159rev-srv:     ns.eu.net
160notify:      ops@ripe.net
161changed:     tony@ripe.net 940110
162source:      RIPE
163.Ed
164.Sh RIPE VERSION
165This is the RIPE version of the whois client program.
166For questions refer
167to <ncc@ripe.net>. For more information about the RIPE database please also
168refer to <ncc@ripe.net>.
169.Lp
170.Sh IPv6 supported
171This whois support the IPv6
172.Pq IP version 6
173whois connections.
174This whois is get the all of host's Information from nameserver, and
175connect order is
176.Pq if exists
177IPv6 addresses of server at first and IPv4 address is later.
178.Lp
179.Sh BUGS
180Most of the extra flags are ONLY supported by the RIPE whois server,
181or copies of the same version of the software. Usage of these flags
182may cause errors on other whois servers.
183.Nm
184depends on
185.Xr getaddrinfo 3
186functions and search order depends on the function.
187.\".Sh SEE ALSO
188.\"RFC 812:  NICNAME/WHOIS
189