git.sur5r.net Git - openldap/blob - doc/drafts/draft-rharrison-ldap-extpartresp-xx.txt

   1 Individual Submission to LDAPExt Working Group              R. Harrison
   2 Internet Draft                                             Novell, Inc.
   3 Document: draft-rharrison-ldap-extpartresp-00.txt         October, 1999
   4 Category: Proposed Standard
   5
   6
   7                        Extended Partial Response
   8                     Protocol Enhancement to LDAP v3
   9
  10
  11 Status of this Memo
  12
  13    This document is an Internet-Draft and is in full conformance with
  14    all provisions of Section 10 of RFC2026 [1].
  15
  16    Internet-Drafts are working documents of the Internet Engineering
  17    Task Force (IETF), its areas, and its working groups. Note that
  18    other groups may also distribute working documents as Internet-
  19    Drafts. Internet-Drafts are draft documents valid for a maximum of
  20    six months and may be updated, replaced, or obsoleted by other
  21    documents at any time. It is inappropriate to use Internet- Drafts
  22    as reference material or to cite them other than as "work in
  23    progress."
  24    The list of current Internet-Drafts can be accessed at
  25    http://www.ietf.org/ietf/1id-abstracts.txt
  26    The list of Internet-Draft Shadow Directories can be accessed at
  27    http://www.ietf.org/shadow.html.
  28
  29
  30 1. Abstract
  31
  32    This document describes the ExtendedPartialResponse, an element of
  33    LDAP v3 protocol which allows multiple responses to LDAP v3 extended
  34    requests.  Extended partial responses are backward compatible with
  35    the existing LDAP v3 Extended Operation defined in [LDAPv3].
  36
  37 2. Conventions used in this document
  38
  39    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  40    "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in
  41    this document are to be interpreted as described in [RFC2119].
  42
  43
  44 3. Motivation for the Extended Partial Response
  45
  46    The Extended Operation ([LDAPv3] Section 4.12) was defined in LDAP
  47    v3 to allow additional operations to be defined as part of the
  48    protocol without requiring a new revision of the protocol.
  49
  50    The LDAP v3 Extended Operation allows for a single extended response
  51    to each extended request, but this paradigm may not be efficient
  52    enough for some directory operations.  For instance, the LDAP search
  53    operation is a directory operation that is much more efficient when
  54    multiple partial responses are used to service a single request. The
  55
  56 Harrison    Individual Submission û Expires April 14, 2000           1
  57 \f
  58                   LDAP v3 Extended Partial Response     October, 1999
  59
  60
  61    extended partial response generalizes the current extended operation
  62    definition to give LDAP server implementers the ability to make use
  63    of a single-request-multiple-response paradigm for extended LDAP
  64    operations that would benefit from it.
  65
  66 4. Element of Protocol
  67
  68    The ExtendedPartialResponse is defined as
  69
  70    ExtendedPartialResponse ::= [APPLICATION 25] SEQUENCE {
  71            responseName     [0] LDAPOID,
  72            response         [1] OCTET STRING OPTIONAL }
  73
  74    An LDAP server responds to an LDAP v3 ExtendedRequest with zero or
  75    more ExtendedPartialResponses followed by one ExtendedResponse. This
  76    ensures backward compatibility with existing LDAP extensions which
  77    do not make use of the ExtendedPartialResponse.  As with all LDAP
  78    extensions, LDAP extensions that make use of the
  79    ExtendedPartialResponse have predefined syntax and semantics that
  80    are defined in RFCs or are private to a particular implementation.
  81
  82 5. Security Considerations
  83
  84    This draft describes an enhancement to the LDAP v3 protocol
  85    [LDAPv3].  All security considerations of [LDAPv3] apply to this
  86    draft, however it does not introduce any new security considerations
  87    to the LDAP v3 protocol.
  88
  89 6. References
  90
  91     [LDAPv3]
  92         Wahl, M., Howes, T., and S. Kille, "Lightweight Directory
  93         Access Protocol (v3)", RFC 2251, December 1997.
  94
  95    [ReqsKeywords]
  96         Scott Bradner. "Key Words for use in RFCs to Indicate
  97         Requirement Levels". RFC 2119.
  98
  99
 100 7. Acknowledgments
 101
 102    The author would like to acknowledge the readers of the LDAP
 103    Extensions working group mail list who responded to the suggestion
 104    that a multiple-response paradigm might be useful for LDAP extended
 105    requests.  Special thanks go to two individuals: David Wilbur who
 106    first introduced the idea on the working group list, and Thomas
 107    Salter, who succinctly summarized the discussion and suggested the
 108    name ExtendedPartialResponse in his summary.
 109
 110 8. Author's Addresses
 111
 112    Roger Harrison
 113    Novell, Inc.
 114
 115 Harrison    Individual Submission û Expires April 14, 2000           2
 116 \f
 117                   LDAP v3 Extended Partial Response     October, 1999
 118
 119
 120    122 E. 1700 S.
 121    Provo, UT 84606
 122    +1 801 861 2642
 123    roger_harrison@novell.com
 124
 125 Full Copyright Statement
 126
 127    "Copyright (C) The Internet Society (date). All Rights Reserved.
 128    This document and translations of it may be copied and furnished to
 129    others, and derivative works that comment on or otherwise explain it
 130    or assist in its implmentation may be prepared, copied, published
 131    and distributed, in whole or in part, without restriction of any
 132    kind, provided that the above copyright notice and this paragraph
 133    are included on all such copies and derivative works. However, this
 134    document itself may not be modified in any way, such as by removing
 135    the copyright notice or references to the Internet Society or other
 136    Internet organizations, except as needed for the purpose of
 137    developing Internet standards in which case the procedures for
 138    copyrights defined in the Internet Standards process must be
 139    followed, or as required to translate it into languages other than
 140    English.
 141
 142    The limited permissions granted above are perpetual and will not be
 143    revoked by the Internet Society or its successors or assigns.
 144
 145    This document and the information contained herein is provided on an
 146    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
 147    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
 148    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
 149    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
 150    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 151
 152
 153
 154
 155
 156
 157
 158
 159
 160
 161
 162
 163
 164
 165
 166
 167
 168
 169
 170
 171
 172
 173
 174
 175 Harrison    Individual Submission û Expires April 14, 2000           3
 176 \f