ldap_abandon(3ldap) [opensolaris man page]

ldap_abandon(3LDAP)					      LDAP Library Functions					       ldap_abandon(3LDAP)

NAME

       ldap_abandon - abandon an LDAP operation in progress

SYNOPSIS

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

       int ldap_abandon(LDAP *ld, int msgid);

DESCRIPTION

       The  ldap_abandon()  function  is used to abandon or cancel an LDAP operation in progress.  The msgid passed should be the message id of an
       outstanding LDAP operation, as returned by ldap_search(3LDAP), ldap_modify(3LDAP), etc.

       ldap_abandon() checks to see if the result of the operation has already come in.  If it has, it deletes it from the queue of  pending  mes-
       sages.  If not, it sends an LDAP abandon operation to the the LDAP server.

       The caller can expect that the result of an abandoned operation will not be returned from a future call to ldap_result(3LDAP).

ERRORS

       ldap_abandon() returns  0 if successful or -1otherwise and setting ld_errno appropriately. See ldap_error(3LDAP) for details.

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_error(3LDAP), attributes(5)

SunOS 5.11							    27 Jan 2002 					       ldap_abandon(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)