Internet DRAFT - draft-daigle-wppquery
draft-daigle-wppquery
Internet-Draft Leslie L. Daigle
Expires: December 12, 2000 Thinking Cat Enterprises
draft-daigle-wppquery-02.txt Patrik Faltstrom
Tele2/Swipnet
June 12, 2000
The application/whoispp-query Content-Type
Status of this Memo
This document is an Internet-Draft and is in full conformance
with all provisions of Section 10 of RFC2026.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as
Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six
months and may be updated, replaced, or obsoleted by other
documents at any time. It is inappropriate to use Internet-
Drafts as reference material or to cite them other than as
"work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
Abstract
This document defines the expression of Whois++ protocol [RFC1835]
queries within MIME [RFC2046] media types. The intention of this
document, in conjunction with RFCXXXX is to enable MIME-enabled
mail software, and other systems using Internet media types, to
carry out Whois++ transactions.
1. MIME Registration Information
To: iana@isi.edu
Subject: Registration of MIME media type application/whoispp-query
MIME Type name: Application
MIME subtype name: whoispp-query
Required parameters: none
Optional parameters: none
Encoding considerations: Any valid MIME encodings may be used
Security considerations: This content-type contains purely descriptive
information (i.e., no directives). There are security considerations
with regards to the appropriateness (privacy) of information provided
through the use of this content-type, and the authenticity of the
information so-provided. This content-type provides no native
mechanisms for authentication.
Published specification: this document
Person & email address to contact for further information:
Leslie L. Daigle
leslie@thinkingcat.com
Intended usage: common
2. whoispp-query Syntax
The following grammar, which uses BNF-like notation as defined in
[RFC2234] defines the set of acceptable input to a Whois++ server.
As such, it describes the expected structure of a whoispp-query media
type object.
N.B.: As outlined in the ABNF definition, rule names and string
literals are in the US-ASCII character set, and are case-insensitive.
whois-command = ( system-command
/ terms [":" globalcnstrnts] ) nl
system-command = "constraints"
/ "describe"
/ "commands"
/ "polled-by"
/ "polled-for"
/ "version"
/ "list"
/ "show" [1*sp bytestring]
/ "help" [1*sp bytestring]
/ "?" [bytestring]
terms = and-expr *("or" and-expr)
and-expr = not-expr *("and" not-expr)
not-expr = ["not"] (term / ( "(" terms ")" ))
term = ( generalterm / specificterm
/ combinedterm ) localcnstrnts
generalterm = bytestring
specificterm = specificname "=" bytestring
specificname = "handle" / "value" / "template"
combinedterm = attributename "=" bytestring
globalcnstrnts = globalcnstrnt *(";" globalcnstrnt)
globalcnstrnt = "format" "=" format
/ "maxfull" "=" 1*digit
/ "maxhits" "=" 1*digit
/ "case" "=" casevalue
/ "search" "=" searchvalue
/ opt-globalcnst
opt-globalcnst = "authenticate" "=" auth-method
/ "language" "=" language
/ "incharset" "=" characterset
/ "outcharset" "=" characterset
/ "ignore" "=" attriblist
/ "include" "=" attriblist
localcnstrnts = 0*(";" localcnstrnt)
localcnstrnt = "case" "=" casevalue
/ "search" "=" searchvalue
format = "full" / "abridged" / "handle" / "summary"
/ "server-to-ask"
auth-method = bytestring
language = <The language code defined in RFC1766 [ALVE95]>
characterset = "us-ascii" / "iso-8859-1" / "iso-8859-2" /
"iso-8859-3" / "iso-8859-4" / "iso-8859-5" /
"iso-8859-6" / "iso-8859-7" / "iso-8859-8" /
"iso-8859-9" / "iso-8859-10" /
"UNICODE-1-1-UTF-8" / "UNICODE-2-0-UTF-8"
"UTF-8"
;"UTF-8" is as defined in [RFC2279]. This is
;the character set label that should be used
;for UTF encoded information; the labels
;"UNICODE-2-0-UTF-8" and "UNICODE-1-1-UTF-8"
;are retained primarily for compatibility with
;older Whois++ servers (and as outlined in
;[RFC2279]).
searchvalue = "exact" / "substring" / "regex" / "fuzzy"
/ "lstring"
casevalue = "ignore" / "consider"
bytestring = 0*charbyte
attributename = 1*attrbyte
attriblist = attributename 0*("," attributename)
charbyte = "\" specialbyte / normalbyte
normalbyte = <%d33-255, except specialbyte>
attrbyte = <%d33-127 except specialbyte> /
"\" <specialbyte except ":" " " tab nl>
specialbyte = " " / tab / "=" / "," / ":" / ";" / "\" /
"*" / "." / "(" / ")" / "[" / "]" / "^" /
"$" / "!" / "?"
tab = %d09
sp = %d32 ; space
digit = "0" / "1" / "2" / "3" / "4" /
"5" / "6" / "7" / "8" / "9"
nl = %d13 %d10 ; CR LF
NOTE: Blanks that are significant to a query must be escaped. The
following characters, when significant to the query, may be preceded
and/or followed by a single blank:
: ; , ( ) = !
3. References
[ALVE95] Alvestrand H., "Tags for the Identification of
Languages", RFC 1766, UNINETT, March 1995.
[RFC2234] Crocker, D., and P. Overell, "Augmented BNF for
Syntax Specifications: ABNF", RFC 2234, November
1997.
[RFCXXXX] Daigle, L. and P. Faltstrom, "The
application/whoispp-response Content-type",
[currently draft-daigle-wppresp-02.txt]
[RFC1835] Deutsch, P., R. Schoultz, P. Faltstrom and C.
Weider. "Architecture of the WHOIS++ service",
RFC 1835. August 1995.
[RFC2046] Freed, N., and N. Borenstein, "Multipurpose Internet
Mail Extensions (MIME) Part Two: Media Types",
RFC 2046, November 1996.
[HARR85] Harrenstein K., Stahl M., and E. Feinler,
"NICNAME/WHOIS", RFC 954, SRI, October 1985.
[POST82] Postel J., "Simple Mail Transfer Protocol", STD 10,
RFC 821, USC/Information Sciences Institute,
August 1982.
[IIIR] Weider C., and P. Deutsch, "A Vision of an
Integrated Internet Information Service", RFC 1727
Bunyip Information Systems, Inc., December 1994.
[WINDX] Weider, C., J. Fullton, and S. Spero, "Architecture
of the Whois++ Index Service", RFC 1913, February
1996.
[RFC2279] F. Yergeau, " UTF-8, a transformation format of ISO
10646", RFC 2279, January 1998.
4. Authors Addresses
Leslie L. Daigle
Thinking Cat Enterprises
Email: leslie@thinkingcat.com
Patrik Faltstrom
Tele2
Borgarfjordsgatan 16
BOX 62
194 64 Kista
SWEDEN
Email: paf@swip.net
