Working With Entries, Attributes, And Values - Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual

Working with Entries, Attributes, and Values

Working with Entries, Attributes, and Values
This section discusses how to create new entries in the directory and how to
convert them to LDIF and back.
In certain situations, you will need to pass directory entries between the front-end
and the client. For example, it you create a custom add function, the front-end
passes to your function an entry in the parameter block. When you perform a
search operation, you return each matching search entry to the client.
When working with entries, you use the
value pairs. The front-end routines listed in Table 5-1 are designed to help you
manipulate entries passed in parameter blocks. These functions are described in
more detail in the sections that follow the table.
Table 5-1
Front-end function
slapi_entry_alloc()
slapi_entry_dup()
slapi_entry_free()
slapi_filter_free()
slapi_str2entry()
slapi_entry_get_dn()
slapi_entry_set_dn()
slapi_entry_schema_check()
slapi_entry_first_attr()
slapi_entry_next_attr()
slapi_entry_attr_find()
slapi_entry_attr_merge_sv()
slapi_entry_add_values_sv()
slapi_entry_delete_values_sv()
60 Netscape Directory Server Plug-In Programmer's Guide • December 2003
Front-End Functions for Manipulating Entries and Attributes
datatype to get attribute
Slapi_Entry
Description
Allocate memory for a new entry
Copy an entry
Free an unused entry from memory
Convert an entry to an LDIF string
representation and vice versa
Get or set the DN for an entry
Verify that an entry complies with the schema
Get the attributes of an entry
Find the values for a specified attribute
Merge an attribute and its values into an
entry
Add values to an attribute in an entry
Delete values from an attribute in an entry