NAME

       ldap_compare, ldap_compare_s, ldap_compare_ext, ldap_compare_ext_s - Perform an LDAP compare operation.

LIBRARY

       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS

       #include <ldap.h>

       int ldap_compare_ext(
              LDAP *ld,
              char *dn,
              char *attr,
              const struct berval *bvalue,
              LDAPControl **serverctrls,
              LDAPControl **clientctrls,
              int *msgidp );

       int ldap_compare_ext_s(
              LDAP *ld,
              char *dn,
              char *attr,
              const struct berval *bvalue,
              LDAPControl **serverctrls,
              LDAPControl **clientctrls );

DESCRIPTION

       The  ldap_compare_ext_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  description
       and  value to compare to those found in the entry.  It returns a code, which will be LDAP_COMPARE_TRUE if
       the entry contains the attribute value and LDAP_COMPARE_FALSE if it does not.  Otherwise, an  error  code
       is returned that indicates the nature of the problem.  See ldap(3) for details.

       The ldap_compare_ext() routine is used to perform an LDAP compare operation asynchronously.  It takes the
       same parameters as ldap_compare_ext_s(), but provides the message id of the request it initiated  in  the
       integer  pointed  to  msgidp.   The  result  of  the  compare  can  be  obtained  by a subsequent call to
       ldap_result(3).

       Both routines allow server and client controls to be specified to extend the compare request.

DEPRECATED INTERFACES

       The routines ldap_compare() and ldap_compare_s()  are  deprecated  in  favor  of  ldap_compare_ext()  and
       ldap_compare_ext_s(), respectively.

       Deprecated  interfaces  generally  remain  in the library.  The macro LDAP_DEPRECATED can be defined to a
       non-zero value (e.g., -DLDAP_DEPRECATED=1) when compiling program designed to use deprecated  interfaces.
       It is recommended that developers writing new programs, or updating old programs, avoid use of deprecated
       interfaces.  Over time, it is expected that  documentation  (and,  eventually,  support)  for  deprecated
       interfaces to be eliminated.

SEE ALSO

       ldap(3), ldap_error(3)

ACKNOWLEDGEMENTS

       OpenLDAP  Software  is  developed  and  maintained  by  The  OpenLDAP Project <http://www.openldap.org/>.
       OpenLDAP Software is derived from the University of Michigan LDAP 3.3 Release.