ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahy_5.4.0.1/rzahymatchrules.htm

223 lines
9.3 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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>