ldap_compare,  ldap_compare_s  -  Perform  an LDAP compare
       operation


SYNOPSIS

       #include <ldap.h>

       int ldap_compare_s(ld, dn, attr, value)
       LDAP *ld;
       char *dn, *attr, *value;

       int ldap_compare(ld, dn, attr, value)
       LDAP *ld;
       char *dn, *attr, *value;


DESCRIPTION

       The ldap_compare_s() routine is used to  perform  an  LDAP
       compare  operation  synchronously.  It takes dn, the DN of
       the entry upon which to perform the compare, and attr  and
       value,  the  attribute  type and value to compare to those
       found in the entry.  It returns an LDAP error code,  which
       will  be  LDAP_COMPARE_TRUE  if  the  entry  contains  the
       attribute value and LDAP_COMPARE_FALSE  if  it  does  not.
       Otherwise, some error code is returned.

       The ldap_compare() routine is used to perform an LDAP com­
       pare operation asynchronously.  It takes the same  parame­
       ters  as  ldap_compare_s(),  but returns the message id of
       the request it initiated.  The result of the  compare  can
       be obtained by a subsequent call to ldap_result(3).


ERRORS

       ldap_compare_s()  returns  an LDAP error code which can be
       interpreted by calling one of ldap_perror(3) and  friends.
       ldap_compare() returns -1 if something went wrong initiat­
       ing the request.  It returns the non-negative  message  id
       of the request if things went ok.


BUGS

       There is no way to compare binary values, but there should
       be.


SEE ALSO

       ldap(3), ldap_error(3)


ACKNOWLEDGEMENTS

       OpenLDAP is developed and maintained by The OpenLDAP  Pro­
       ject (http://www.openldap.org/).  OpenLDAP is derived from
       University of Michigan LDAP 3.3 Release.


Man(1) output converted with man2html