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)

ldap_first_attribute(3LDAP)				      LDAP Library Functions				       ldap_first_attribute(3LDAP)

NAME

       ldap_first_attribute, ldap_next_attribute - step through LDAP entry attributes

SYNOPSIS

       cc [ flag...] file... -lldap[ library...]

       #include <lber.h>
       #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() function gets the value of the first attribute in an entry.

       The ldap_first_attribute() function returns the name of the first attribute in the entry. To get the value of the first attribute, pass the
       attribute name to the ldap_get_values() function or to the ldap_get_values_len() function.

       The ldap_next_attribute() function gets the value of the next attribute in an entry.

       After stepping through the attributes, the  application	should	call  ber_free()  to  free  the  BerElement  structure	allocated  by  the
       ldap_first_attribute() function if the structure is other than NULL.

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(3LDAP) for a
       description of possible error codes.

ATTRIBUTES

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

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

SEE ALSO

       ldap(3LDAP), ldap_first_entry(3LDAP), ldap_get_values(3LDAP), ldap_error(3LDAP), attributes(5)

NOTES

       The ldap_first_attribute() function alllocates memory that might need to be freed by the caller by means of ber_free(3LDAP).

SunOS 5.10							    16 Dec 2003 				       ldap_first_attribute(3LDAP)