source4/ldap_server/devdocs/draft-armijo-ldap-syntax-00.txt

   1 INTERNET-DRAFT                                                  Michael P. Armijo
   2 Status: Informational                                           Microsoft Corporation
   3 January 1999
   4 Expires July 1999
   5
   6
   7                              Active Directory Syntaxes
   8                         draft-armijo-ldap-syntax-00.txt
   9
  10
  11 1. Status of this Memo
  12
  13
  14 This memo provides information for the Internet community. It does not specify
  15 an Internet standard of any kind. Distribution of this memo is unlimited.
  16
  17 This document is an Internet-Draft. Internet-Drafts are working documents of the
  18 Internet Engineering Task Force (IETF), its areas, and its working groups. Note
  19 that other groups may also distribute working documents as Internet-Drafts.
  20
  21 Internet-Drafts are draft documents valid for a maximum of six months and may be
  22 updated, replaced, or obsoleted by other documents at any time. It is
  23 inappropriate to use Internet- Drafts as reference material or to cite them
  24 other than as "work in progress."
  25
  26 To view the entire list of current Internet-Drafts, please check the "1id-
  27 abstracts.txt" listing contained in the Internet-Drafts Shadow Directories on
  28 ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe), ftp.nis.garr.it
  29 (Southern Europe), munnari.oz.au (Pacific Rim), ftp.ietf.org (US East Coast), or
  30 ftp.isi.edu (US West Coast).
  31
  32 2. Abstract
  33
  34 The purpose of this document is to inform the Internet community of LDAP
  35 syntaxes available in the Windows NT Active Directory.  These syntaxes provide
  36 additional functionality to the Active Directory.
  37
  38
  39 3. RFC Key Words
  40
  41 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
  42 "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this document are to be
  43 interpreted as described in RFC 2119.
  44
  45
  46 4. LDAP Syntaxes
  47
  48 CaseIgnoreString: 1.2.840.113556.1.4.905
  49         Encoded as a Printable String (OID 1.3.6.1.4.1.1466.115.121.1.44)
  50
  51
  52 OR-Name: 1.2.840.113556.1.4.1221
  53         Encoded as:
  54         ORName = DN | "X400:" ORaddress "#X500:" DN | "X400:"ORaddress
  55         DN = normally encoded rfc 1779 name
  56         ORaddress = some string encoding for OR addresses.
  57
  58 Note that an unescaped # character must not be legal in this encoding.
  59 This is necessary to be able to identify where the #X500 starts if the
  60 middle choice of the encoding is chosen.
  61
  62
  63 DNWithOctetString: 1.2.840.113556.1.4.903
  64         Encoded as a :
  65         DNWithOctetString  = OctetTag ':' Count ':' OctetString ':' DN
  66         OctetTag = 'B' | 'b'
  67         Count = positive decimal number, counting number of encoded characters
  68                 in OctetString
  69         OctetString = [EncodedByte]*  // Note: the number of characters in the
  70                 string encoding of the OctetString is Count.
  71         EncodedByte = [0-9 | a-f | A-F] [0-9 | a-f | A-F]
  72         DN = <normal string encoding of a DN>
  73
  74         As an example, the string encoding of the combination of 0x74 0x65 0x73
  75         0x74 and DC=Microsoft,DC=Com is
  76
  77         B:8:74657374:DC=Microsoft,DC=Com
  78
  79
  80 DNWithString: 1.2.840.113556.1.4.904
  81         Encoded as a :
  82         DNWithString  = StringTag ':' Count ':' String ':' DN
  83         OctetTag = 'S' | 's'
  84         Count = positive decimal number, counting number of bytes in String
  85         String = <normally encoded (i.e. UTF8 for V3) string>  // Note: the number
  86         of bytes in the string encoding of the String is Count.
  87
  88         DN = <normal string encoding of a DN>
  89
  90         As an example, the string encoding of the combination of "test" and
  91         DC=Microsoft,DC=Com is
  92
  93         B:4:test:DC=Microsoft,DC=Com
  94
  95         As an example, the string encoding of the combination of XYZ (where X, Y,
  96         and Z all have two byte UTF-8 encodings) and DC=Microsoft,DC=Com is
  97
  98         B:6:XYZ:DC=Microsoft,DC=Com
  99
 100 Note: Characters with multibyte UTF-8 encodings contribute more than one to the count
 101
 102
 103 Large-Integer: 1.2.840.113556.1.4.906
 104         Encoded as an Integer (OID 1.3.6.1.4.1.1466.115.121.1.27), but guaranteed
 105         to support 64 bit numbers.
 106
 107
 108 Object-Security-Descriptor: 1.2.840.113556.1.4.907
 109         Encoded as an Octet-String (OID 1.3.6.1.4.1.1466.115.121.1.40)
 110
 111
 112 5. References
 113
 114 [RFC 2251]
 115     M. Wahl, T. Howes, S. Kille, "Lightweight Directory Access Protocol
 116     (v3)", RFC 2251, December 1997.  1997.
 117
 118 [RFC 2119]
 119     Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels,"
 120     RFC 2119, Harvard University, March 1997.
 121
 122
 123 6. Authors Address
 124
 125  Michael P. Armijo
 126  One Microsoft Way
 127  Redmond, WA
 128  98052
 129  USA
 130
 131  (425)882-8080
 132  micharm@microsoft.com
 133
 134
 135
 136
 137