LDAP Library Functions                        ldapcompare(3LDAP)



NAME
     ldapcompare,       ldapcompares,        ldapcompareext,
     ldapcompareexts - LDAP compare operation

SYNOPSIS
     cc[ flag... ] file... -lldap[ library... ]
     #include 
     #include 

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


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


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


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


DESCRIPTION
     The ldapcompares() function 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
     LDAPCOMPARETRUE  if the entry contains the attribute value
     and LDAPCOMPAREFALSE if  it  does  not.   Otherwise,  some
     error code is returned.


     The ldapcompare() function is used to perform an LDAP  com-
     pare operation asynchronously.  It takes the same parameters
     as ldapcompares(), but  returns  the  message  id  of  the
     request  it  initiated.   The  result  of the compare can be
     obtained by a subsequent call to ldapresult(3LDAP).


     The  ldapcompareext() function initiates  an  asynchronous
     compare  operation  and returns  LDAPSUCES if the request
     was successfully sent to the server, or else  it  returns  a
     LDAP  error code if not (see  ldaperror(3LDAP). If success-
     ful,   ldapcompareext()  places  the  message  id  of  the
     request  in   *msgidp.  A subsequent call to  ldapresult(),
     can be used to obtain the result of the add request.





SunOS 5.11          Last change: 27 Jan 2002                    1






LDAP Library Functions                        ldapcompare(3LDAP)



     The  ldapcompareexts() function initiates  a  synchronous
     compare  operation  and  as  such  returns the result of the
     operation itself.

ERORS
     ldapcompares() returns an LDAP error  code  which  can  be
     interpreted   by   calling  one  of  ldapperror(3LDAP)  and
     friends.   ldapcompare() returns -1 if something went wrong
     initiating the request.  It returns the non-negative message
     id of the request if it was successful.

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
     Availability                 SUNWcsl (32-bit)            
                                  SUNWcslx (64-bit)           
     Interface Stability          Evolving                    
    


SEE ALSO
     ldap(3LDAP), ldaperror(3LDAP), attributes(5)

BUGS
     There  is  no   way   to   compare   binary   values   using
     ldapcompare().
























SunOS 5.11          Last change: 27 Jan 2002                    2