diff --git a/usr.bin/whois/whois.1 b/usr.bin/whois/whois.1 index 52d65168a384..f7eef3c7bc8a 100644 --- a/usr.bin/whois/whois.1 +++ b/usr.bin/whois/whois.1 @@ -32,7 +32,7 @@ .\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd August 5, 2001 +.Dd September 4, 2001 .Dt WHOIS 1 .Os .Sh NAME @@ -60,11 +60,11 @@ It contains network numbers used in those parts of the world covered neither by .Tn APNIC nor by .Tn RIPE . -Contact (handle) information should be looked up by appending -.Qq Li -ARIN -to the NIC handle: .Pp -.Dl "$ whois -a foo3-ARIN" +(Hint: All point of contact handles in the +.Tn ARIN +whois database end with +.Qq Li -ARIN . ) .Pp .It Fl A Use the Asia/Pacific Network Information Center @@ -97,7 +97,8 @@ constructs the name of a whois server to use from the top-level domain of the supplied (single) argument, and appending .Qq Li .whois-servers.net . This effectively allows a suitable whois server to be selected -automatically for a large number of TLDs. +automatically for a large number of +.Tn TLDs . .Pp In the event that an IP address is specified, the whois server will default to the American @@ -139,11 +140,13 @@ is no longer handled by Network Solutions, Inc. For details, see .Pa http://www.internic.net/ . .Pp -Contact (handle) information should be looked up by prefixing +(Hint: Contact information, identified by the term +.Em handle , +can be looked up by prefixing .Qq Li "handle " -to the NIC handle in the querry: -.Pp -.Dl "$ whois -i 'handle foo3'" +to the +.Tn NIC +handle in the query.) .Pp .It Fl m Use the Route Arbiter Database @@ -181,7 +184,7 @@ for subdomains of This option is deprecated; use the .Fl c option with an argument of -.Qq ru +.Qq Li RU instead. .It Fl 6 Use the IPv6 Resource Center @@ -208,6 +211,57 @@ For more information as to what operands have special meaning, and how to guide the search, use the special name .Dq Li help . +.Sh EXAMPLES +Most types of data, such as domain names and +.Tn IP +addresses, can be used as arguments to +.Nm +without any options, and +.Nm +will choose the correct whois server to query. +Some exceptions, where +.Nm +will not be able to handled data correctly, are detailed below. +.Pp +To obtain contact information about an +administrator located in the Russian +.Tn TLD +domain +.Qq Li RU , +use the +.Fl c +option as shown in the following example, where +.Ar CONTACT-ID +is substituted with the actual contact identifier. +.Pp +.Dl "whois -c RU CONTACT-ID" +.Pp +(Note: This example is specific to the +.Tn TLD +.Qq Li RU , +but other +.Tn TLDs +can be queried by using a similar syntax.) +.Pp +The following example demonstrates how to obtain information about an +.Tn IPv6 +address or hostname using the +.Fl 6 +option, which directs the query to +.Tn 6bone . +.Pp +.Dl "whois -6 IPv6-IP-Address" +.Pp +The following example demonstrates how to query +a whois server using a non-standard port, where +.Dq Li query-data +is the query to be sent to +.Dq Li non-existent.host +on port +.Dq Li rwhois +(written numerically as 4321). +.Pp +.Dl "whois -h non-existent.host -p rwhois query-data" .Sh SEE ALSO .Rs .%A Ken Harrenstien