summaryrefslogtreecommitdiff
path: root/usr.bin/whois
diff options
context:
space:
mode:
authorTony Finch <fanf@FreeBSD.org>2016-04-25 15:46:42 +0000
committerTony Finch <fanf@FreeBSD.org>2016-04-25 15:46:42 +0000
commitc37dc1fb0b29feba4c9c2392f1eb6ce6aeeb5cbf (patch)
tree4cbd512437b59cc3ff8a7f6545110768f710d16b /usr.bin/whois
parent02a371289a3766de9d06a7791357921aba4606a9 (diff)
downloadsrc-test-c37dc1fb0b29feba4c9c2392f1eb6ce6aeeb5cbf.tar.gz
src-test-c37dc1fb0b29feba4c9c2392f1eb6ce6aeeb5cbf.zip
Example RIPE whois query with options and spaces.
Since it is used in the example, mention the -- option in the synopsis even though it is a universal standard, and tweak to fit it on one line.
Notes
Notes: svn path=/head/; revision=298581
Diffstat (limited to 'usr.bin/whois')
-rw-r--r--usr.bin/whois/whois.132
1 files changed, 26 insertions, 6 deletions
diff --git a/usr.bin/whois/whois.1 b/usr.bin/whois/whois.1
index 0b74cc5bcf781..0fe70a16f9033 100644
--- a/usr.bin/whois/whois.1
+++ b/usr.bin/whois/whois.1
@@ -28,7 +28,7 @@
.\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$
.\"
-.Dd January 23, 2016
+.Dd April 25, 2016
.Dt WHOIS 1
.Os
.Sh NAME
@@ -37,8 +37,9 @@
.Sh SYNOPSIS
.Nm
.Op Fl aAbfgiIklmPQrRS
-.Op Fl c Ar country-code | Fl h Ar host
+.Op Fl c Ar TLD | Fl h Ar host
.Op Fl p Ar port
+.Op Fl -
.Ar name ...
.Sh DESCRIPTION
The
@@ -90,11 +91,12 @@ Get query syntax documentation using
Use the Network Abuse Clearinghouse database.
It contains addresses to which network abuse should be reported,
indexed by domain name.
-.It Fl c Ar country-code
+.It Fl c Ar TLD
This is the equivalent of using the
.Fl h
option with an argument of
-.Qq Ar country-code Ns Li .whois-servers.net .
+.Qq Ar TLD Ns Li .whois-servers.net .
+This can be helpful for locating country-class TLD whois servers.
.It Fl f
Use the African Network Information Centre
.Pq Tn AfriNIC
@@ -233,7 +235,7 @@ 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"
+.Dl Ic whois -c RU CONTACT-ID
.Pp
(Note: This example is specific to the
.Tn TLD
@@ -251,7 +253,25 @@ on port
.Dq Li rwhois
(written numerically as 4321).
.Pp
-.Dl "whois -h whois.example.com -p rwhois query-data"
+.Dl Ic whois -h whois.example.com -p rwhois query-data
+.Pp
+Some whois servers support complex queries
+with dash-letter options.
+You can use the
+.Fl -
+option to separate
+.Nm
+command options from whois server query options.
+A query containing spaces must be quoted as one
+argument to the
+.Nm
+command.
+The following example asks the RIPE whois server
+to return a brief description of its
+.Dq Li domain
+object type:
+.Pp
+.Dl Ic whois -r -- '-t domain'
.Sh SEE ALSO
.Rs
.%A Ken Harrenstien