Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ldap_ber_free(3ldap) [opensolaris man page]

ldap_ber_free(3LDAP)					      LDAP Library Functions					      ldap_ber_free(3LDAP)

NAME
ldap_ber_free - free a BerElement structure from memory SYNOPSIS
cc -flag ... file ...-lldap [ -library ... ] #include <ldap.h> void ldap_ber_free(BerElement *ber, int freebuf DESCRIPTION
You can make a call to the ldap_ber_free() function to free BerElement structures allocated by ldap_first_attribute() and by ldap_next_attribute() function calls. When freeing structures allocated by these functions, specify 0 for the freebuf argument. The ldap_first_attribute() and by ldap_next_attribute() functions do not allocate the extra buffer in the BerElement structure. For example, to retrieve attributes from a search result entry, you need to call the ldap_first_attribute() function. A call to this func- tion allocates a BerElement structure, which is used to help track the current attribute. When you are done working with the attributes, this structure should be freed from memory, if it still exists. This function is deprecated . Use the ber_free() function instead. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsl (32-bit) | +-----------------------------+-----------------------------+ | |SUNWcslx (64-bit) | +-----------------------------+-----------------------------+ |Interface Stability |Obsolete | +-----------------------------+-----------------------------+ SEE ALSO
ber_free(3LDAP), ldap_first_attribute(3LDAP), ldap_next_attribute(3LDAP), attributes(5) SunOS 5.11 25 Oct 2001 ldap_ber_free(3LDAP)

Check Out this Related Man Page

LDAP_FIRST_ATTRIBUTE(3) 				     Library Functions Manual					   LDAP_FIRST_ATTRIBUTE(3)

NAME
ldap_first_attribute, ldap_next_attribute - step through LDAP entry attributes LIBRARY
OpenLDAP LDAP (libldap, -lldap) SYNOPSIS
#include <ldap.h> char *ldap_first_attribute( LDAP *ld, LDAPMessage entry, BerElement **berptr ) char *ldap_next_attribute( LDAP *ld, LDAPMessage entry, BerElement *ber ) DESCRIPTION
The ldap_first_attribute() and ldap_next_attribute() routines are used to step through the attributes in an LDAP entry. ldap_first_attribute() takes an entry as returned by ldap_first_entry(3) or ldap_next_entry(3) and returns a pointer to character string containing the first attribute description in the entry. ldap_next_attribute() returns the next attribute description in the entry. It also returns, in berptr, a pointer to a BerElement it has allocated to keep track of its current position. This pointer should be passed to subsequent calls to ldap_next_attribute() and is used used to effectively step through the entry's attributes. The caller is solely responsible for freeing the BerElement pointed to by berptr when it is no longer needed by calling ber_free(3). When calling ber_free(3) in this instance, be sure the second argument is 0. The attribute names returned are suitable for inclusion in a call to ldap_get_values(3) to retrieve the attribute's values. ERRORS
If an error occurs, NULL is returned and the ld_errno field in the ld parameter is set to indicate the error. See ldap_error(3) for a description of possible error codes. NOTES
The ldap_first_attribute() and ldap_next_attribute() return dynamically allocated memory that must be freed by the caller via ldap_mem- free(3). SEE ALSO
ldap(3), ldap_first_entry(3), ldap_get_values(3), ldap_error(3) ACKNOWLEDGEMENTS
OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/). OpenLDAP is derived from University of Michigan LDAP 3.3 Release. OpenLDAP 2.1.X RELEASEDATE LDAP_FIRST_ATTRIBUTE(3)
Man Page