Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 64 / 612

Working with DNs and RDNs
64 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
• To remove values from an entry, call
slapi_entry_delete_values_sv()
.
• In certain situations, you may want to add an attribute and its values to an
entry while not replacing any attribute values that already exist. To do this, call
the
slapi_entry_attr_merge_sv()
function.
Working with DNs and RDNs
In certain situations, the front-end passes DNs to the back-end through the
parameter block. For example, when calling the add function, the parameter block
includes a parameter that specifies the DN of the new entry to be added.
If you need to manipulate DNs within parameter blocks, you can call the following
front-end routines:
Determining if a DN is the Root DN
To determine if a DN is the root DN, call
slapi_dn_isroot()
. This function
returns
1
if the specified DN is the root DN of the local database. It returns
0
if the
DN is not the root DN.
Table 5-2 Front-End Functions for Manipulating DNs
Function Description
slapi_dn_isroot()
Determines if a DN is the root DN (the DN of the
privileged superuser)
slapi_dn_parent()
slapi_dn_beparent()
Gets a copy of the parent DN
slapi_dn_issuffix()
Determines if a DN is the child of another DN
slapi_dn_isbesuffix()
Determines if a DN is a suffix served by one of
the server’s back-ends
slapi_dn_normalize()
Normalizes a DN
slapi_dn_ignore_case()
Converts all characters in a DN to lowercase
slapi_dn_normalize_case()
Normalizes a DN and converts all characters to
lowercase