Working With Search Filters - Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual

Working with Search Filters

Normalizing a DN
You can use the following front-end function to normalize and convert the case of
a DN:
• Use
• Use
• Use
characters in the DN to lowercase.
NOTE
To compare DNs (for example, to search the database for a particular DN), use
the
slapi_sdn_compare()
DNs using string functions.
Working with Search Filters
When a client requests an LDAP search operation, the front-end passes the search
filter to the backend as part of the parameter block. (The filter is passed through
the
SLAPI_SEARCH_FILTER
available in the
To manipulate search filters, call the following front-end routines:
Table 5-3 Front-End Functions for Manipulating Filters
Function
slapi_filter_test()
slapi_filter_get_choice()
slapi_filter_get_ava()
74 Red Hat Directory Server Plug-in Programmer's Guide • May 2005
slapi_dn_normalize()
slapi_dn_ignore_case()
slapi_dn_normalize_case()
These functions operate on the actual DN specified in the
argument, not a copy of the DN. If you want to modify a copy of the
DN, call
slapi_ch_strdup()
function instead of normalizing and comparing the
parameter. A string representation of the filter is also
SLAPI_SEARCH_STRFILTER
to normalize a DN.
to convert all characters in a DN to lowercase.
to both normalize the DN and convert all
to make a copy of the DN.
parameter.)
Description
Determine if an entry matches a filter's criteria.
Get the filter type.
Get the attribute type and value used for
comparison in an attribute-value assertion
filter (only applicable to the following searches:
LDAP_FILTER_EQUALITY,
LDAP_FILTER_GE, LDAP_FILTER_LE, and
LDAP_FILTER_APPROX).