From owner-svn-src-all@freebsd.org Mon Apr 25 15:46:44 2016 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0E26FB1CC54; Mon, 25 Apr 2016 15:46:44 +0000 (UTC) (envelope-from fanf@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id B41C9145E; Mon, 25 Apr 2016 15:46:43 +0000 (UTC) (envelope-from fanf@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u3PFkg4v003572; Mon, 25 Apr 2016 15:46:42 GMT (envelope-from fanf@FreeBSD.org) Received: (from fanf@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u3PFkgXN003571; Mon, 25 Apr 2016 15:46:42 GMT (envelope-from fanf@FreeBSD.org) Message-Id: <201604251546.u3PFkgXN003571@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: fanf set sender to fanf@FreeBSD.org using -f From: Tony Finch Date: Mon, 25 Apr 2016 15:46:42 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r298581 - head/usr.bin/whois X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 25 Apr 2016 15:46:44 -0000 Author: fanf Date: Mon Apr 25 15:46:42 2016 New Revision: 298581 URL: https://svnweb.freebsd.org/changeset/base/298581 Log: 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. Modified: head/usr.bin/whois/whois.1 Modified: head/usr.bin/whois/whois.1 ============================================================================== --- head/usr.bin/whois/whois.1 Mon Apr 25 14:47:51 2016 (r298580) +++ head/usr.bin/whois/whois.1 Mon Apr 25 15:46:42 2016 (r298581) @@ -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 .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