NAME

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

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__ccoommppaarree__eexxtt((
LLDDAAPP **_l_d,,
cchhaarr **_d_n,,
cchhaarr **_a_t_t_r,,
ccoonnsstt ssttrruucctt bbeerrvvaall **_b_v_a_l_u_e,,
LLDDAAPPCCoonnttrrooll ****_s_e_r_v_e_r_c_t_r_l_s,,
LLDDAAPPCCoonnttrrooll ****_c_l_i_e_n_t_c_t_r_l_s,,
iinntt **_m_s_g_i_d_p ));;
<>
iinntt llddaapp__ccoommppaarree__eexxtt__ss((
LLDDAAPP **_l_d,,
cchhaarr **_d_n,,
cchhaarr **_a_t_t_r,,
ccoonnsstt ssttrruucctt bbeerrvvaall **_b_v_a_l_u_e,,
LLDDAAPPCCoonnttrrooll ****_s_e_r_v_e_r_c_t_r_l_s,,
LLDDAAPPCCoonnttrrooll ****_c_l_i_e_n_t_c_t_r_l_s ));;
<> DDEESSCCRRIIPPTTIIOONN <>
TThhee
<>llddaapp__ccoommppaarree__eexxtt__ss(())<>
rroouuttiinnee iiss uusseedd ttoo ppeerrffoorrmm aann LLDDAAPP ccoommppaarree ooppeerraattiioonn ssyynncchhrroonnoouussllyy..
IItt ttaakkeess _d_n,, tthhee DDNN ooff tthhee eennttrryy uuppoonn wwhhiicchh ttoo ppeerrffoorrmm tthhee
ccoommppaarree,, aanndd _a_t_t_r aanndd _v_a_l_u_e,, tthhee aattttrriibbuuttee ddeessccrriippttiioonn aanndd
vvaalluuee ttoo ccoommppaarree ttoo tthhoossee ffoouunndd iinn tthhee eennttrryy..  IItt rreettuurrnnss aa ccooddee,, wwhhiicchh
wwiillll bbee LLDDAAPP__CCOOMMPPAARREE__TTRRUUEE iiff tthhee eennttrryy ccoonnttaaiinnss tthhee aattttrriibbuuttee vvaalluuee aanndd
LLDDAAPP__CCOOMMPPAARREE__FFAALLSSEE iiff iitt ddooeess nnoott..  OOtthheerrwwiissee,, aann eerrrroorr ccooddee iiss
rreettuurrnneedd tthhaatt iinnddiiccaatteess tthhee nnaattuurree ooff tthhee pprroobblleemm..  SSeeee
<>llddaapp((33))<>
ffoorr ddeettaaiillss..
<>
TThhee
<>llddaapp__ccoommppaarree__eexxtt(())<>
rroouuttiinnee iiss uusseedd ttoo ppeerrffoorrmm aann LLDDAAPP ccoommppaarree ooppeerraattiioonn
aassyynncchhrroonnoouussllyy..  IItt ttaakkeess tthhee ssaammee ppaarraammeetteerrss aass
<>llddaapp__ccoommppaarree__eexxtt__ss(())<>,,
bbuutt pprroovviiddeess tthhee mmeessssaaggee iidd ooff tthhee rreeqquueesstt iitt iinniittiiaatteedd iinn tthhee
iinntteeggeerr ppooiinntteedd ttoo _m_s_g_i_d_p..  TThhee rreessuulltt ooff
tthhee ccoommppaarree ccaann bbee oobbttaaiinneedd bbyy aa ssuubbsseeqquueenntt ccaallll ttoo
<>llddaapp__rreessuulltt((33))<>
<>
BBootthh rroouuttiinneess aallllooww sseerrvveerr aanndd cclliieenntt ccoonnttrroollss ttoo bbee ssppeecciiffiieedd ttoo
eexxtteenndd tthhee ccoommppaarree rreeqquueesstt..
<> DDEEPPRREECCAATTEEDD IINNTTEERRFFAACCEESS <>
TThhee rroouuttiinneess
<>llddaapp__ccoommppaarree<>(())
aanndd
<>llddaapp__ccoommppaarree__ss<>(())
aarree ddeepprreeccaatteedd iinn ffaavvoorr ooff
<>llddaapp__ccoommppaarree__eexxtt<>(())
aanndd
<>llddaapp__ccoommppaarree__eexxtt__ss<>(()),,
rreessppeeccttiivveellyy..
<>
DDeepprreeccaatteedd iinntteerrffaacceess ggeenneerraallllyy rreemmaaiinn iinn tthhee lliibbrraarryy..  TThhee mmaaccrroo
LLDDAAPP__DDEEPPRREECCAATTEEDD ccaann bbee ddeeffiinneedd ttoo aa nnoonn--zzeerroo vvaalluuee
((ee..gg..,, --DDLLDDAAPP__DDEEPPRREECCAATTEEDD==11)) wwhheenn ccoommppiilliinngg pprrooggrraamm ddeessiiggnneedd ttoo uussee
ddeepprreeccaatteedd iinntteerrffaacceess..  IItt iiss rreeccoommmmeennddeedd tthhaatt ddeevveellooppeerrss wwrriittiinngg nneeww
pprrooggrraammss,, oorr uuppddaattiinngg oolldd pprrooggrraammss,, aavvooiidd uussee ooff ddeepprreeccaatteedd iinntteerrffaacceess..
OOvveerr ttiimmee,, iitt iiss eexxppeecctteedd tthhaatt ddooccuummeennttaattiioonn ((aanndd,, eevveennttuuaallllyy,, ssuuppppoorrtt)) ffoorr
ddeepprreeccaatteedd iinntteerrffaacceess ttoo bbee eelliimmiinnaatteedd..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__eerrrroorr((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>