]> git.sur5r.net Git - openldap/blobdiff - doc/guide/admin/schema.sdf
Happy new year!
[openldap] / doc / guide / admin / schema.sdf
index 771c14d315fa0f127c9f47ec16b792d2babe059e..a2d519ac785001352a83c6f35d9fb0001f7ad673 100644 (file)
@@ -1,10 +1,13 @@
 # $OpenLDAP$
-# Copyright 1999-2003, The OpenLDAP Foundation, All Rights Reserved.
+# Copyright 1999-2006 The OpenLDAP Foundation, All Rights Reserved.
 # COPYING RESTRICTIONS APPLY, see COPYRIGHT.
 
 H1: Schema Specification
 
-This chapter describes how to extend the user schema used by {{slapd}}(8).
+This chapter describes how to extend the user schema used by
+{{slapd}}(8).  The chapter assumes the reader is familar with the
+{{TERM:LDAP}}/{{TERM:X.500}} information model.
+
 The first section, {{SECT:Distributed Schema Files}} details optional
 schema definitions provided in the distribution and where to obtain
 other definitions.
@@ -78,15 +81,13 @@ There are five steps to defining new schema:
 
 H3: Object Identifiers
 
-Each schema element is identified by a globally unique
-{{TERM[expand]OID}} (OID).  OIDs are also used to identify
-other objects.
-They are commonly found in protocols described by {{TERM:ASN.1}}.  In
+Each schema element is identified by a globally unique {{TERM[expand]OID}}
+(OID).  OIDs are also used to identify other objects.  They are
+commonly found in protocols described by {{TERM:ASN.1}}.  In
 particular, they are heavily used by the {{TERM[expand]SNMP}} (SNMP).
-As OIDs are hierarchical, your organization
-can obtain one OID and branch it as needed.  For example,
-if your organization were assigned OID {{EX:1.1}}, you could branch
-the tree as follows:
+As OIDs are hierarchical, your organization can obtain one OID and
+branch it as needed.  For example, if your organization were assigned
+OID {{EX:1.1}}, you could branch the tree as follows:
 
 !block table; colaligns="LR"; coltags="EX,N"; align=Center; \
        title="Table 8.2: Example OID hierarchy"
@@ -126,10 +127,7 @@ you.  OIDs obtained using this form may be used for any purpose
 including identifying LDAP schema elements.
 
 Alternatively, OID name space may be available from a national
-authority (e.g., ANSI, BSI).
-
-For private experiments, OIDs under {{EX:1.1}} may be used.  The
-OID {{EX:1.1}} arc is regarded as dead name space.
+authority (e.g., {{ORG:ANSI}}, {{ORG:BSI}}).
 
 
 H3: Name Prefix
@@ -243,42 +241,36 @@ matching rules (OpenLDAP supports these and many more).
        title="Table 8.3: Commonly Used Syntaxes"
 Name                   OID                             Description
 boolean                        1.3.6.1.4.1.1466.115.121.1.7    boolean value
-distinguishedName      1.3.6.1.4.1.1466.115.121.1.12   DN
-directoryString                1.3.6.1.4.1.1466.115.121.1.15   UTF-8 string
-IA5String              1.3.6.1.4.1.1466.115.121.1.26   ASCII string
-Integer                        1.3.6.1.4.1.1466.115.121.1.27   integer
-Name and Optional UID  1.3.6.1.4.1.1466.115.121.1.34   DN plus UID
-Numeric String         1.3.6.1.4.1.1466.115.121.1.36   numeric string
+directoryString                1.3.6.1.4.1.1466.115.121.1.15   Unicode (UTF-8) string
+distinguishedName      1.3.6.1.4.1.1466.115.121.1.12   LDAP DN
+integer                        1.3.6.1.4.1.1466.115.121.1.27   integer
+numericString          1.3.6.1.4.1.1466.115.121.1.36   numeric string
 OID                    1.3.6.1.4.1.1466.115.121.1.38   object identifier
-Octet String           1.3.6.1.4.1.1466.115.121.1.40   arbitary octets
-Printable String       1.3.6.1.4.1.1466.115.121.1.44   printable string
+octetString            1.3.6.1.4.1.1466.115.121.1.40   arbitary octets
 !endblock
 
 > 
 
 !block table; align=Center; coltags="EX,N"; \
        title="Table 8.4: Commonly Used Matching Rules"
-Name                           Type            Description
-booleanMatch                   equality        boolean
-octetStringMatch               equality        octet string
-objectIdentiferMatch           equality        OID
-distinguishedNameMatch         equality        DN
-uniqueMemberMatch              equality        Name with optional UID
-numericStringMatch             equality        numerical
-numericStringOrderingMatch     ordering        numerical
-numericStringSubstringsMatch   substrings      numerical
-caseIgnoreMatch                        equality        case insensitive, space insensitive
-caseIgnoreOrderingMatch                ordering        case insensitive, space insensitive
-caseIgnoreSubstringsMatch      substrings      case insensitive, space insensitive
-caseExactMatch                 equality        case sensitive, space insensitive
-caseExactOrderingMatch         ordering        case sensitive, space insensitive
-caseExactSubstringsMatch       substrings      case sensitive, space insensitive
-caseIgnoreIA5Match             equality        case insensitive, space insensitive
-caseIgnoreIA5OrderingMatch     ordering        case insensitive, space insensitive
-caseIgnoreIA5SubstringsMatch   substrings      case insensitive, space insensitive
-caseExactIA5Match              equality        case sensitive, space insensitive
-caseExactIA5OrderingMatch      ordering        case sensitive, space insensitive
-caseExactIA5SubstringsMatch    substrings      case sensitive, space insensitive
+Name                                   Type            Description
+booleanMatch                           equality        boolean
+caseIgnoreMatch                                equality        case insensitive, space insensitive
+caseIgnoreOrderingMatch                        ordering        case insensitive, space insensitive
+caseIgnoreSubstringsMatch              substrings      case insensitive, space insensitive
+caseExactMatch                         equality        case sensitive, space insensitive
+caseExactOrderingMatch                 ordering        case sensitive, space insensitive
+caseExactSubstringsMatch               substrings      case sensitive, space insensitive
+distinguishedNameMatch                 equality        distinguished name
+integerMatch                           equality        integer
+integerOrderingMatch                   ordering        integer
+numericStringMatch                     equality        numerical
+numericStringOrderingMatch             ordering        numerical
+numericStringSubstringsMatch           substrings      numerical
+octetStringMatch                       equality        octet string
+octetStringOrderingStringMatch         ordering        octet string
+octetStringSubstringsStringMatch       ordering        octet string
+objectIdentiferMatch                   equality        object identifier
 !endblock
 
 The second attribute, {{EX:cn}}, is a subtype of {{EX:name}} hence