Sun Java System Directory Server Enterprise Edition 6.1 Developer's Guide

Chapter 2 Changes to the Plug-In API Since Directory Server 5.2

This chapter describes what's new in the Directory Server 6.1 release, that is, the changes to the plug-in API since the Directory Server 5.2 release. If you maintain Directory Server plug-ins originally developed for a previous release, consider upgrade such plug-ins to use the new and updated features.

For reference information, see Part II, Directory Server Plug-In API Reference.

Tip –

Consider working with Sun Services consultants to develop and to maintain your Directory Server plug-ins.

This chapter covers the following topics:

Deprecated and Changed Features Since Directory Server 5.2

This section addresses features deprecated or changed since the Directory Server5.2 release. Where possible, use the replacement functionality.

Attribute Value Handling Changes

The following table shows deprecated functions and their replacements for handling attribute values.

Table 2–1 Replacement Functions for Handling Attribute Values


Deprecated Function	Replacement Function
`slapi_attr_first_value()`	`slapi_attr_first_value_const()`
`slapi_attr_next_value()`	`slapi_attr_next_value_const()`
`slapi_valueset_add_value()`	`slapi_valueset_add_value_optimised()`
`slapi_valueset_first_value()`	`slapi_valueset_first_value_const()`
`slapi_valueset_next_value()`	`slapi_valueset_next_value_const()`
`slapi_valueset_set_valueset()`	`slapi_valueset_set_valueset_optimised()`
`slapi_valueset_find()`	`slapi_valueset_find_const()`

`const` Correct Code Changes

The following functions now apply const correctness:

slapi_build_control()
slapi_build_control_from_berval()
slapi_control_present()
slapi_dup_control()
slapi_entry2str()
slapi_entry2str_with_options()
slapi_get_account_availability()
slapi_log_error_ex()
slapi_log_info_ex()
slapi_log_warning_ex()
slapi_register_supported_control()
slapi_search_internal_get_entry()

The following callback data types also now apply const correctness:

slapi_pwd_storage_scheme_cmp_fn
slapi_pwd_storage_scheme_dec_fn
slapi_pwd_storage_scheme_enc_fn

For updated prototypes, see install-path/ds6/include/slapi-plugin.h.

New Features Since Directory Server 5.2

This section summarizes features that have been added since the Directory Server 5.2 release. This section does not include features that are reserved for internal use.

New Distinguished Name Functions

The following functions have been added to handle distinguished names (DNs):

slapi_dn_is_besuffix_norm()
slapi_sdn_get_suffix()

New Entry Handling Function

The slapi_entry_isroot() function has been added to handle entries.

New Modification Handling Function

The slapi_mods_remove_at() function has been added to handle modifications.

New Plug-In Call Ordering Mechanism

Directory Server now includes a mechanism for setting the order in which plug-ins are called by the server. See Ordering Plug-In Calls for details.

New Schema Checking Function

The slapi_entry_schema_check_ext() function has been added to handle schema checking.

New Suffix Functions

The following functions have been added to browse supported suffixes:

slapi_free_suffix_list()
slapi_get_suffix_list()

New Syntax Checking Functions

The following functions have been added to handle syntax checking:

slapi_entry_syntax_check()
slapi_ldapmods_syntax_check()
slapi_rdn_syntax_check()

New Virtual Attributes Function

The slapi_vattr_is_virtual() function has been added to handle virtual attributes.