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

This chapter describes what's new in the Directory Server 11g Release 1 (11.1.1.7.0) 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 Plug-In API Reference.

Tip:

Consider working with Oracle 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
New Features Since Directory Server 5.2

2.1 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.

2.1.1 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()`

2.1.2 `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/include/slapi-plugin.h.

2.2 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.

2.2.1 New Distinguished Name Functions

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

slapi_dn_is_besuffix_norm()
slapi_sdn_get_suffix()

2.2.2 New Entry Handling Function

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

2.2.3 New Modification Handling Function

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

2.2.4 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.

2.2.5 New Schema Checking Function

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

2.2.6 New Suffix Functions

The following functions have been added to browse supported suffixes:

slapi_free_suffix_list()
slapi_get_suffix_list()

2.2.7 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()

2.2.8 New Virtual Attributes Function

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

2.2.9 New `attrs` Implementation to Request Attribute List

The attrs parameter is implemented in the slapi_search_internal_set_pb() () function to specify the list of attributes to be returned. Earlier, irrespective of the value of the attrs parameter all the attributes were returned.