ldap_memfree(3ldap) [sunos man page]

ldap_memfree(3LDAP)					      LDAP Library Functions					       ldap_memfree(3LDAP)

NAME

       ldap_memfree - free memory allocated by LDAP API functions

SYNOPSIS

       cc -flag ...  file ...-lldap [-library ...]
       #include < lber.h>
       #include < ldap.h>

       void ldap_memfree(void *p);

DESCRIPTION

       The  ldap_memfree() function frees the memory allocated by certain LDAP API functions that do not have corresponding functions to free mem-
       ory. These functions include ldap_get_dn(3LDAP), ldap_first_attribute(3LDAP), and ldap_next_attribute(3LDAP).

       The ldap_memfree() function takes one parameter, p, which is a pointer to the memory to be freed.

PARAMETERS

       p	A pointer to the memory to be freed.

RETURN VALUES

       There are no return values for the ldap_memfree() function.

ERRORS

       No errors are defined for the ldap_memfree() function.

ATTRIBUTES

       See attributes(5)  for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsl (32-bit)		   |
       +-----------------------------+-----------------------------+
       |			     |SUNWcslx (64-bit) 	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ldap(3LDAP), ldap_first_attribute(3LDAP), ldap_get_dn(3LDAP), ldap_next_attribute(3LDAP), attributes(5)

SunOS 5.10							    6 Jan 2003						       ldap_memfree(3LDAP)

ldap_first_entry(3LDAP) 				      LDAP Library Functions					   ldap_first_entry(3LDAP)

NAME

       ldap_first_entry,  ldap_next_entry, ldap_count_entries, ldap_count_references, ldap_first_reference, ldap_next_reference - LDAP entry pars-
       ing and counting functions

SYNOPSIS

       cc[ flag... ] file... -lldap[ library... ]
       #include <lber.h>
       #include <ldap.h>

       LDAPMessage *ldap_first_entry(LDAP*ld, LDAPMessage *result);

       LDAPMessage *ldap_next_entry(LDAP *ld, LDAPMessage *entry);

       ldap_count_entries(LDAP *ld, LDAPMessage *result);

       LDAPMessage *ldap_first_reference(LDAP *ld, LDAPMessage *res);

       LDAPMessage *ldap_next_reference(LDAP *ld, LDAPMessage *res);

       int ldap_count_references(LDAP *ld, LDAPMessage *res);

DESCRIPTION

       These functions are  used  to  parse  results  received	from  ldap_result(3LDAP)  or  the  synchronous	LDAP  search  operation  functions
       ldap_search_s(3LDAP) and ldap_search_st(3LDAP).

       The  ldap_first_entry()	function  is  used to retrieve the first entry in a chain of search results.  It takes the result as returned by a
       call to ldap_result(3LDAP) or ldap_search_s(3LDAP) or ldap_search_st(3LDAP) and returns a pointer to the first entry in the result.

       This pointer should be supplied on a subsequent call to ldap_next_entry() to get the next entry, the result of which should be supplied	to
       the  next  call	to  ldap_next_entry(), etc. ldap_next_entry() will return  NULL when there are no more entries.  The entries returned from
       these calls are used in calls to the functions described in ldap_get_dn(3LDAP), ldap_first_attribute(3LDAP), ldap_get_values(3LDAP), etc.

       A count of the number of entries in the search result can be obtained by calling ldap_count_entries().

       ldap_first_reference() and   ldap_next_reference() are used to step through and retrieve the list of continuation references from a  search
       result chain.

       The ldap_count_references() function is used to count the number of references that are contained in and remain in a search result chain.

ERRORS

       If an error occurs in ldap_first_entry() or ldap_next_entry(), NULL is returned and the	ld_errno field in the ld parameter is set to indi-
       cate the error.	If an error occurs in ldap_count_entries(), -1 is returned, and ld_errno is set appropriately.	See ldap_error(3LDAP)  for
       a description of possible error codes.

ATTRIBUTES

       See attributes(5) for a description of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWcsl (32-bit)		   |
       |			     |SUNWcslx (64-bit) 	   |
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ldap(3LDAP), ldap_result(3LDAP), ldap_search(3LDAP), ldap_first_attribute(3LDAP), ldap_get_values(3LDAP), ldap_get_dn(3LDAP), attributes(5)

SunOS 5.11							    27 Jan 2002 					   ldap_first_entry(3LDAP)