1.5. Deprecated Functions and Replacements

Several functions have been deprecated in the Directory Server plug-in API. The deprecated functions are still supported for backward compatibility. They are, however, no longer documented and should not be used.
Table 1.1, “Deprecated Functions and Suggested Replacements” lists the deprecated functions and the functions to use in their place.

Table 1.1. Deprecated Functions and Suggested Replacements

Deprecated Function Suggested Replacement Function
These functions deal with bervals. These functions are deprecated and their use is not recommended. For each deprecated function, a corresponding function is listed in slapi-plugin.h with an _sv extension that uses Slapi_Values instead of bervals.
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()
slapi_entry_attr_replace() slapi_entry_attr_replace_sv()
slapi_attr_get_values() slapi_attr_value_find()
slapi_attr_get_oid() slapi_attr_get_oid_copy()
slapi_pw_find() slapi_pw_find_sv()
slapi_call_syntax_values2keys() slapi_call_syntax_values2keys_sv()
slapi_call_syntax_assertion2keys_ava() slapi_call_syntax_assertion2keys_ava_sv()
slapi_call_syntax_assertion2keys_sub() slapi_call_syntax_assertion2keys_sub_sv()
slapi_entry_attr_hasvalue() slapi_entry_attr_has_syntax_value()
The following internal-operation calls are deprecated. The new internal operation functions that are defined in slapi-plugin.h take a Slapi_PBlock for extensibility and support the new plug-in configuration capabilities.
slapi_search_internal_callback() slapi_search_internal_callback_pb()
slapi_search_internal() slapi_search_internal_pb()
slapi_modify_internal() slapi_modify_internal_pb()
slapi_add_internal() slapi_add_internal_pb()
slapi_delete_internal() slapi_delete_internal_pb()
slapi_modrdn_internal() slapi_modrdn_internal_pb()
The following functions are not multi-thread safe; they return a pointer to unprotected data. Use the new functions in slapi-plugin.h that end in _copy() instead.
slapi_get_supported_controls() slapi_get_supported_controls_copy()
slapi_get_supported_extended_ops() slapi_get_supported_extended_ops_copy()
slapi_get_supported_saslmechanism() slapi_get_supported_saslmechanisms_copy()
All of these functions are designed to work with entry DNs, but they no longer work with the Slapi_DN structure. These DN functions have been deprecated. New DN management functions, slapi_sdn_*, have been added to slpi-plugin.h.
slapi_dn_isparent() slapi_sdn_isparent()
slapi_dn_issuffix() slapi_sdn_issuffix()
slapi_dn_normalize() slapi_sdn_get_ndn()
slapi_dn_parent() slapi_sdn_get_parent()
slapi_dn_plus_rdn() slapi_sdn_add_rdn()
slapi_isbesuffix() slapi_be_issuffix()
slapi_dn_beparent() slapi_sdn_get_backend_parent()
slapi_dn_ignore_case()
slapi_sdn_get_ndn() (to normalize the case)
slapi_sdn_compare() (to compare DNs, regardless of case)