Working With Dn Suffixes; Server Suffixes; Getting The Parent Dn Of A Dn; Normalizing A Dn - Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual

Working with DN Suffixes

A suffix of a DN identifies a subtree in the directory tree where the DN is located.
For example, consider the following DN:
cn=Babs Jensen, ou=Product Development, o=Example Corporation, c=US
In this case, one of the suffixes is:
o=Example Corporation, c=US
This suffix indicates that the
subtree in the directory tree.
Corporation
To determine if a value is a suffix for a DN, call
determine if a DN is one of the suffixes served by the back-end, call the
slapi_dn_isbesuffix()

Server Suffixes

The directive in the server configuration file specifies which DNs are
suffix
served by a particular back-end. For example, suppose the suffix directive is
configured to the following:
suffix "o=Example Corporation, c=US"
Here, all entries within the "o=Example Corporation, c=US" subtree are served by
this back-end.

Getting the Parent DN of a DN

To get a copy of the parent DN for a DN, call the
the
slapi_dn_beparent()
These functions return the parent DN of
slapi_dn_beparent()
When you are done working with the parent DN, you should free it from memory
by calling .
free()

Normalizing a DN

If you need to compare DNs (for example, if you are searching your database for a
particular DN), you should normalize the DNs that you are comparing to ensure
that they are properly compared.
entry is located in the
Babs Jensen
function.
function.
. If
dn
will return .
NULL
Working with DNs and RDNs
Example
slapi_dn_issuffix()
slapi_dn_parent()
is a suffix served by the back-end,
dn
Chapter 5 Front-End API Functions
. To
function or
65