223 lines
9.3 KiB
HTML
223 lines
9.3 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow"/>
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<title>Directory Server (LDAP) - Matching rules</title>
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
|
</head>
|
|
<body>
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
|
|
<a name="rzahymatchrules"></a>
|
|
<h4 id="rzahymatchrules">Matching rules</h4>
|
|
<p>A matching rule provides guidelines for string comparison during a search
|
|
operation. These rules are divided into three categories:</p>
|
|
<ul>
|
|
<li>Equality</li>
|
|
<li>Ordering</li>
|
|
<li>Substring</li></ul>
|
|
<p><img src="delta.gif" alt="Start of change" />The directory server supports equality matches for all syntaxes
|
|
except binary. For attributes defined using a binary syntax, the server only
|
|
supports existence searches, for example "(jpegphoto=*)". For the IA5 String
|
|
and Directory String syntaxes, an attribute definition can be further defined
|
|
as case exact or case ignore. For example, the cn attribute uses the caseIgnoreMatch
|
|
matching rule making the values "John Doe" and "john doe" equivalent. For
|
|
case ignore matching rules, comparison is done after converting values to
|
|
uppercase. The uppercase algorithm is not locale-sensitive and may not be
|
|
correct for all locales.<img src="deltaend.gif" alt="End of change" /></p>
|
|
<p><img src="delta.gif" alt="Start of change" />The directory server supports substring matching for Directory
|
|
String, IA5 String, and Distinguished Name syntax attributes. Search filters
|
|
for substring matches use the "*" character to match zero or more characters
|
|
in a string. For example, the search filter "(cn=*smith)" matches all cn
|
|
values ending with the string "smith".<img src="deltaend.gif" alt="End of change" /></p>
|
|
<p><img src="delta.gif" alt="Start of change" />Ordering matches are supported for Integer, Directory String,
|
|
IA5 String and Distinguished Name syntaxes. For string syntaxes, ordering
|
|
is based on a simple byte ordering of the UTF-8 string values. If the attribute
|
|
is defined with a case ignore matching rule, ordering is done using uppercase
|
|
string values. As noted earlier, the uppercase algorithm may not be correct
|
|
for all locales.<img src="deltaend.gif" alt="End of change" /></p>
|
|
<p><img src="delta.gif" alt="Start of change" />In the IBM Directory Server, the substring and ordering matching
|
|
behavior is implied by the matching rule: all syntaxes that support substring
|
|
matching have an implied substring matching rule, and all syntaxes that support
|
|
ordering have an implied ordering rule. For attributes defined using a case
|
|
ignore matching rule, the implied substring and ordering matching rules are
|
|
also case ignore.<img src="deltaend.gif" alt="End of change" /></p>
|
|
<a name="wq11"></a>
|
|
<table id="wq11" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
|
|
<thead valign="bottom">
|
|
<tr class="tablemainheaderbar">
|
|
<th id="wq12" colspan="3" align="center" valign="top">Equality matching
|
|
rules</th>
|
|
</tr>
|
|
<tr class="tablesubheaderbar">
|
|
<th id="wq13" width="43%" align="center" valign="top">Matching Rule</th>
|
|
<th id="wq14" width="30%" align="center" valign="top">OID</th>
|
|
<th id="wq15" width="26%" align="center" valign="top">Syntax</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr>
|
|
<td headers="wq12 wq13">caseExactIA5Match</td>
|
|
<td headers="wq12 wq14">1.3.6.1.4.1.1466.109.114.1</td>
|
|
<td headers="wq12 wq15">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">caseExactMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.5 IA5</td>
|
|
<td headers="wq12 wq15">String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">caseIgnoreIA5Match</td>
|
|
<td headers="wq12 wq14">1.3.6.1.4.1.1466.109.114.2</td>
|
|
<td headers="wq12 wq15">IA5 String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">caseIgnoreMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.2</td>
|
|
<td headers="wq12 wq15">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">distinguishedNameMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.1</td>
|
|
<td headers="wq12 wq15">DN - distinguished name</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">generalizedTimeMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.27</td>
|
|
<td headers="wq12 wq15">Generalized Time syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">ibm-entryUuidMatch</td>
|
|
<td headers="wq12 wq14">1.3.18.0.2.22.2</td>
|
|
<td headers="wq12 wq15">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">integerFirstComponentMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.29</td>
|
|
<td headers="wq12 wq15"> Integer syntax - integral number</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">integerMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.14</td>
|
|
<td headers="wq12 wq15">Integer syntax - integral number</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">objectIdentifierFirstComponentMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.30</td>
|
|
<td headers="wq12 wq15">String for containing OIDs. The OID is a string containing
|
|
digits (0-9) and decimal points (.).</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">objectIdentifierMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.0</td>
|
|
<td headers="wq12 wq15">String for containing OIDs. The OID is a string containing
|
|
digits (0-9) and decimal points (.)</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">octetStringMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.17</td>
|
|
<td headers="wq12 wq15">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13"> telephoneNumberMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.20</td>
|
|
<td headers="wq12 wq15">Telephone Number syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq12 wq13">uTCTimeMatch</td>
|
|
<td headers="wq12 wq14">2.5.13.25</td>
|
|
<td headers="wq12 wq15">UTC Time syntax</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<a name="wq16"></a>
|
|
<table id="wq16" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
|
|
<thead valign="bottom">
|
|
<tr class="tablemainheaderbar">
|
|
<th id="wq17" colspan="3" align="center" valign="top">Ordering matching
|
|
rules</th>
|
|
</tr>
|
|
<tr class="tablesubheaderbar">
|
|
<th id="wq18" width="42%" align="center" valign="top">Matching rule</th>
|
|
<th id="wq19" width="30%" align="center" valign="top">OID</th>
|
|
<th id="wq20" width="26%" align="center" valign="top">Syntax</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr>
|
|
<td headers="wq17 wq18">caseExactOrderingMatch</td>
|
|
<td headers="wq17 wq19"> 2.5.13.6</td>
|
|
<td headers="wq17 wq20">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq17 wq18">caseIgnoreOrderingMatch</td>
|
|
<td headers="wq17 wq19">2.5.13.3</td>
|
|
<td headers="wq17 wq20">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq17 wq18">distinguishedNameOrderingMatch</td>
|
|
<td headers="wq17 wq19">1.3.18.0.2.4.405</td>
|
|
<td headers="wq17 wq20">DN - distinguished name</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq17 wq18">generalizedTimeOrderingMatch</td>
|
|
<td headers="wq17 wq19">2.5.13.28</td>
|
|
<td headers="wq17 wq20">Generalized Time syntax</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<a name="wq21"></a>
|
|
<table id="wq21" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
|
|
<thead valign="bottom">
|
|
<tr class="tablemainheaderbar">
|
|
<th id="wq22" colspan="3" align="center" valign="top">Substring
|
|
matching rules</th>
|
|
</tr>
|
|
<tr class="tablesubheaderbar">
|
|
<th id="wq23" width="42%" align="center" valign="top">Matching rule</th>
|
|
<th id="wq24" width="30%" align="center" valign="top">OID</th>
|
|
<th id="wq25" width="26%" align="center" valign="top">Syntax</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr>
|
|
<td headers="wq22 wq23">caseExactSubstringsMatch</td>
|
|
<td headers="wq22 wq24">2.5.13.7</td>
|
|
<td headers="wq22 wq25">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq22 wq23">caseIgnoreSubstringsMatch</td>
|
|
<td headers="wq22 wq24">2.5.13.4</td>
|
|
<td headers="wq22 wq25">Directory String syntax</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq22 wq23">telephoneNumberSubstringsMatch</td>
|
|
<td headers="wq22 wq24">2.5.13.21</td>
|
|
<td headers="wq22 wq25">Telephone Number syntax</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<a name="wq26"></a>
|
|
<div class="notetitle" id="wq26">Note:</div>
|
|
<div class="notebody">UTC-Time is time string format defined by ASN.1 standards.
|
|
See ISO 8601 and X680. Use this syntax for storing time values in UTC-Time
|
|
format. See <a href="rzahyutctime.htm#rzahyutctime">Generalized and UTC time</a>.</div>
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|