LDAP-UX Client Services B.04.10 Administrator's Guide (edition 7)
Mapping Unsupported Matching Rules and LDAP Syntaxes
If matching rules and/or LDAP syntaxes used in attribute type definitions in the schema definition
file are not supported on the LDAP directory server, the ldapschema tool maps them to alternate
matching rules and syntaxes the LDAP server supports. LDAP-UX provides the
/etc/opt/ldapux/schema/map-rules.xml file which defines a list of default substitution
matching rules and syntaxes, and alternate matching rules and syntaxes.
The matching rules are specified in <equality>, <ordering> or <substr> in the attribute
type definition. The LDAP syntax is specified in the <syntax> tag of the attribute type definition.
The purpose of the mapping rules file is to allow an LDAP schema to be installed on an LDAP
directory server even if some of matching rules and LDAP syntaxes used in the definition of that
schema are not supported by the directory server. The
/etc/opt/ldapux/schema/map-rules.xml file uses the following mapping rules guideline:
• Map more restrictive syntaxes to less restrictive syntaxes.
• Map more specific matching rules to less specific matching rules.
For example, the Integer syntax contains a subset of characters of the IA5 string syntax. Therefore,
it is acceptable to map the Integer syntax to the IA5 string syntax, since the IA5 string syntax is
a super-set of the integer syntax.
Examples of Alternate Matching Rules and Syntaxes in /etc/opt/ldapux/map-rules.xml
The following shows examples of alternate matching rules and syntaxes defined in the
/etc/opt/ldapux/map-rules.xml:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mappingPolicies SYSTEM "/etc/opt/ldapux/schema/schema.dtd">
<mappingPolicies>
<defaultMatchingRulesReplacements>
<defaultMatchingRule>
<matchingRule>caseIgnoreMatch</matchingRule>
</defaultMatchingRule>
</defaultMatchingRulesReplacements>
<defaultSyntaxesReplacements>
<defaultSyntax only="ads">
<syntax>2.5.5.12</syntax>
<desc>Active Directory String syntax.</desc>
<oMSyntax>64</oMSyntax>
</defaultSyntax>
<defaultSyntax not="ads">
<syntax>1.3.6.1.4.1.1466.115.121.1.15</syntax>
<desc>Directory String syntax.</desc>
</defaultSyntax>
</defaultSyntaxesReplacements>
<matchingRulesReplacements>
<matchingRules>
<matchingRule>IntegerMatch</matchingRule>
<subRule>
<matchingRule>numericStringMatch</matchingRule>
</subRule>
</matchingRules>
</matchingRulesReplacements>
<syntaxesReplacements>
<syntaxes>
<syntax>1.3.6.1.4.1.1466.115.121.1.26</syntax>
<desc> IA5 String Syntax.</desc>
<equivSyntax>
Schema Extension Utility 159