Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 60 / 612

Working with Entries, Attributes, and Values
60 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
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
Slapi_Entry
datatype to get attribute
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 Functions for Manipulating Entries and Attributes
Front-end function Description
slapi_entry_alloc()
Allocate memory for a new entry
slapi_entry_dup()
Copy an entry
slapi_entry_free()
Free an unused entry from memory
slapi_filter_free()
slapi_str2entry()
Convert an entry to an LDIF string
representation and vice versa
slapi_entry_get_dn()
slapi_entry_set_dn()
Get or set the DN for an entry
slapi_entry_schema_check()
Verify that an entry complies with the schema
slapi_entry_first_attr()
slapi_entry_next_attr()
Get the attributes of an entry
slapi_entry_attr_find()
Find the values for a specified attribute
slapi_entry_attr_merge_sv()
Merge an attribute and its values into an
entry
slapi_entry_add_values_sv()
Add values to an attribute in an entry
slapi_entry_delete_values_sv()
Delete values from an attribute in an entry