Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 12 / 612

Using Directory Server Plug-In APIs
12 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
• The main header file is located here:
<server_root>/plugins/slapd/slapi/include/slapi-plugin.h
• The location and syntax for the plug-in directives have changed. In the
Directory Server 4.x release, the
plugin
directives were in the database section
of the
slapd.ldbm.conf
file. In this release of Directory Server, you must add
your
plugin
directives to the
dse.ldif
file, which is located in the
<server_root>/slapd-<instance_id>/config
directory. For guidelines,
refer to the Readme file located here:
<server_root>/plugins/slapd/slapi/examples/
• Database plug-ins are not supported in this version of Directory Server. Be sure
to use the pre-operation, post-operation, and/or extended operation API to
register plug-in functions. Note that some code examples in this book are yet to
be updated to reflect this change.
• To comply with Internet Protocol version 6, Directory Server plug-ins can now
use the
SLAPI_CONN_CLIENTEDADDR
and
SLAPI_CONNSERVERADDR
parameters
to allow plug-ins to recognize the IP address of the LDAP client and server.
These new parameters use the Netscape Portable Runtime (NSPR)
PRNetADDr
structure for storing the IP addresses. Because of this, the NSPR files are
shipped with Directory Server.
The NSPR API allows compliant applications to use system facilities such as
threads, thread synchronization, I/O, interval timing, atomic operations, and
several other low-level services in a platform-independent manner.
• Several functions have been deprecated in this release of the Directory Server
Plug-in API. The deprecated functions are still supported for backward
compatibility. They are, however, not documented in this release. The table
below lists the deprecated functions and the functions you should use in their
place. If you need additional information on functions that have been
deprecated, check this file:
<server_root>/plugins/slapd/slapi/include/slapi-plugin-compat4.h
Table 0-1 Deprecated Functions and Their Suggested Replacements
Deprecated Function Suggested Replacement Function
The following functions that deal with
bervals
are deprecated and their use is not recommended. For each
deprecated function, you will find in
slapi-plugin.h
a corresponding function with a
_sv
extension that
uses
Slapi_Values
instead of
bervals
. The new functions are more efficient than the old ones.
slapi_entry_attr_merge() slapi_entry_attr_merge_sv()
slapi_entry_add_values() slapi_entry_add_values_sv()
slapi_entry_delete_values() slapi_entry_delete_values_sv()