NAME

ldap_init, ldap_initialize, ldap_open - Initialize the LDAP library and open a connection to an LDAP server

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
LLDDAAPP **llddaapp__ooppeenn((hhoosstt,, ppoorrtt))
cchhaarr **hhoosstt;;
iinntt ppoorrtt;;
<>
LLDDAAPP **llddaapp__iinniitt((hhoosstt,, ppoorrtt))
cchhaarr **hhoosstt;;
iinntt ppoorrtt;;
<>
iinntt llddaapp__iinniittiiaalliizzee((llddpp,, uurrii))
LLDDAAPP ****llddpp;;
cchhaarr **uurrii;;
<>
##iinncclluuddee <>
<>
iinntt llddaapp__iinniitt__ffdd((ffdd,, pprroottoo,, uurrii,, llddpp))
bbeerr__ssoocckkeett__tt ffdd;;
iinntt pprroottoo;;
cchhaarr **uurrii;;
LLDDAAPP ****llddpp;;
<> DDEESSCCRRIIPPTTIIOONN <>
<>
<>llddaapp__ooppeenn(())<>
ooppeennss aa ccoonnnneeccttiioonn ttoo aann LLDDAAPP sseerrvveerr aanndd aallllooccaatteess aann LLDDAAPP
ssttrruuccttuurree wwhhiicchh iiss uusseedd ttoo iiddeennttiiffyy
tthhee ccoonnnneeccttiioonn aanndd ttoo mmaaiinnttaaiinn ppeerr--ccoonnnneeccttiioonn iinnffoorrmmaattiioonn..
<>llddaapp__iinniitt(())<>
aallllooccaatteess aann LLDDAAPP ssttrruuccttuurree bbuutt ddooeess nnoott ooppeenn aann iinniittiiaall ccoonnnneeccttiioonn..
<>llddaapp__iinniittiiaalliizzee(())<>
aallllooccaatteess aann LLDDAAPP ssttrruuccttuurree bbuutt ddooeess nnoott ooppeenn aann iinniittiiaall ccoonnnneeccttiioonn..
<>llddaapp__iinniitt__ffdd(())<>
aallllooccaatteess aann LLDDAAPP ssttrruuccttuurree uussiinngg aann eexxiissttiinngg ccoonnnneeccttiioonn oonn tthhee
pprroovviiddeedd ssoocckkeett..
OOnnee
ooff tthheessee rroouuttiinneess mmuusstt bbee ccaalllleedd bbeeffoorree aannyy ooppeerraattiioonnss aarree aatttteemmpptteedd..
<>
<>llddaapp__ooppeenn(())<>
ttaakkeess _h_o_s_t,, tthhee hhoossttnnaammee oonn wwhhiicchh tthhee LLDDAAPP sseerrvveerr iiss
rruunnnniinngg,, aanndd _p_o_r_t,, tthhee ppoorrtt nnuummbbeerr ttoo wwhhiicchh ttoo ccoonnnneecctt..  IIff tthhee ddeeffaauulltt
IIAANNAA--aassssiiggnneedd ppoorrtt ooff 338899 iiss ddeessiirreedd,, LLDDAAPP__PPOORRTT sshhoouulldd bbee ssppeecciiffiieedd ffoorr
_p_o_r_t..  TThhee _h_o_s_t ppaarraammeetteerr mmaayy ccoonnttaaiinn aa bbllaannkk--sseeppaarraatteedd lliisstt
ooff hhoossttss ttoo ttrryy ttoo ccoonnnneecctt ttoo,, aanndd eeaacchh hhoosstt mmaayy ooppttiioonnaallllyy bbyy ooff tthhee ffoorrmm
_h_o_s_t_:_p_o_r_t..  IIff pprreesseenntt,, tthhee _:_p_o_r_t oovveerrrriiddeess tthhee _p_o_r_t
ppaarraammeetteerr ttoo
<>llddaapp__ooppeenn(())<>..
UUppoonn ssuucccceessssffuullllyy mmaakkiinngg aa ccoonnnneeccttiioonn ttoo aann
LLDDAAPP sseerrvveerr,,
<>llddaapp__ooppeenn(())<>
rreettuurrnnss aa ppooiinntteerr ttoo aann ooppaaqquuee LLDDAAPP ssttrruuccttuurree,, wwhhiicchh sshhoouulldd bbee ppaasssseedd
ttoo ssuubbsseeqquueenntt ccaallllss ttoo
<>llddaapp__bbiinndd(())<>,,
<>llddaapp__sseeaarrcchh(())<>,,
eettcc.. CCeerrttaaiinn ffiieellddss iinn tthhee LLDDAAPP ssttrruuccttuurree ccaann bbee sseett ttoo iinnddiiccaattee ssiizzee lliimmiitt,,
ttiimmee lliimmiitt,, aanndd hhooww aalliiaasseess aarree hhaannddlleedd dduurriinngg ooppeerraattiioonnss;; rreeaadd aanndd wwrriittee aacccceessss
ttoo tthhoossee ffiieellddss mmuusstt ooccccuurr bbyy ccaalllliinngg
<>llddaapp__ggeett__ooppttiioonn((33))<>
aanndd
<>llddaapp__sseett__ooppttiioonn((33))<>
rreessppeeccttiivveellyy,, wwhheenneevveerr ppoossssiibbllee..
<>
<>
llddaapp__iinniitt(())
<>
aaccttss jjuusstt lliikkee
<>llddaapp__ooppeenn(())<>,,
bbuutt ddooeess nnoott ooppeenn aa ccoonnnneeccttiioonn
ttoo tthhee LLDDAAPP sseerrvveerr..  TThhee aaccttuuaall ccoonnnneeccttiioonn ooppeenn wwiillll ooccccuurr wwhheenn tthhee
ffiirrsstt ooppeerraattiioonn iiss aatttteemmpptteedd..
<>
<>llddaapp__iinniittiiaalliizzee(())<>
aaccttss lliikkee
<>llddaapp__iinniitt(())<>,,
bbuutt iitt rreettuurrnnss aann iinntteeggeerr iinnddiiccaattiinngg eeiitthheerr ssuucccceessss oorr tthhee ffaaiilluurree rreeaassoonn,,
aanndd iitt aalllloowwss ttoo ssppeecciiffyy ddeettaaiillss ffoorr tthhee ccoonnnneeccttiioonn iinn tthhee sscchheemmaa ppoorrttiioonn
ooff tthhee UURRII..
<>
AAtt tthhiiss ttiimmee,,
<>llddaapp__ooppeenn(())<>
aanndd
<>llddaapp__iinniitt(())<>
aarree ddeepprreeccaatteedd iinn ffaavvoorr ooff
<>llddaapp__iinniittiiaalliizzee(())<>,,
eesssseennttiiaallllyy bbeeccaauussee tthhee llaatttteerr aalllloowwss ttoo ssppeecciiffyy aa sscchheemmaa iinn tthhee UURRII
aanndd iitt eexxpplliicciittllyy rreettuurrnnss aann eerrrroorr ccooddee..
<>
<>llddaapp__iinniitt__ffdd(())<>
aalllloowwss aann LLDDAAPP ssttrruuccttuurree ttoo bbee iinniittiiaalliizzeedd uussiinngg aann aallrreeaaddyy--ooppeenneedd
ccoonnnneeccttiioonn.. TThhee
<>pprroottoo<>
ppaarraammeetteerr sshhoouulldd bbee oonnee ooff LLDDAAPP__PPRROOTTOO__TTCCPP,, LLDDAAPP__PPRROOTTOO__UUDDPP,,
oorr LLDDAAPP__PPRROOTTOO__IIPPCC
ffoorr aa ccoonnnneeccttiioonn uussiinngg TTCCPP,, UUDDPP,, oorr IIPPCC,, rreessppeeccttiivveellyy.. TThhee vvaalluuee
LLDDAAPP__PPRROOTTOO__EEXXTT
mmaayy aallssoo bbee ssppeecciiffiieedd iiff uusseerr--ssuupppplliieedd ssoocckkbbuuff hhaannddlleerrss aarree ggooiinngg ttoo
bbee uusseedd.. NNoottee tthhaatt ssuuppppoorrtt ffoorr UUDDPP iiss nnoott iimmpplleemmeenntteedd uunnlleessss lliibbllddaapp
wwaass bbuuiilltt wwiitthh LLDDAAPP__CCOONNNNEECCTTIIOONNLLEESSSS ddeeffiinneedd..
TThhee
<>uurrii<>
ppaarraammeetteerr mmaayy ooppttiioonnaallllyy bbee pprroovviiddeedd ffoorr iinnffoorrmmaattiioonnaall ppuurrppoosseess..
        <>
NNoottee:: tthhee ffiirrsstt ccaallll iinnttoo tthhee LLDDAAPP lliibbrraarryy aallssoo iinniittiiaalliizzeess tthhee gglloobbaall
ooppttiioonnss ffoorr tthhee lliibbrraarryy.. AAss ssuucchh tthhee ffiirrsstt ccaallll sshhoouulldd bbee ssiinnggllee--tthhrreeaaddeedd
oorr ootthheerrwwiissee pprrootteecctteedd ttoo iinnssuurree tthhaatt oonnllyy oonnee ccaallll iiss aaccttiivvee.. IItt iiss
rreeccoommmmeennddeedd tthhaatt
<>llddaapp__ggeett__ooppttiioonn<>(())
oorr
<>llddaapp__sseett__ooppttiioonn<>(())
bbee uusseedd iinn tthhee pprrooggrraamm''ss mmaaiinn tthhrreeaadd bbeeffoorree aannyy aaddddiittiioonnaall tthhrreeaaddss aarree ccrreeaatteedd..
SSeeee
<>llddaapp__ggeett__ooppttiioonn((33))<>
        <>
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss,,
<>llddaapp__ooppeenn(())<>
aanndd
<>llddaapp__iinniitt(())<>
wwiillll rreettuurrnn NNUULLLL aanndd eerrrrnnoo sshhoouulldd bbee sseett aapppprroopprriiaatteellyy..
<>llddaapp__iinniittiiaalliizzee(())<>
aanndd
<>llddaapp__iinniitt__ffdd(())<>
wwiillll ddiirreeccttllyy rreettuurrnn tthhee LLDDAAPP ccooddee aassssoocciiaatteedd ttoo tthhee eerrrroorr ((oorr
<>LLDDAAPP__SSUUCCCCEESSSS<>
iinn ccaassee ooff ssuucccceessss));;
eerrrrnnoo sshhoouulldd bbee sseett aass wweellll wwhheenneevveerr aapppprroopprriiaattee..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__bbiinndd((33))<>
<>llddaapp__ggeett__ooppttiioonn((33))<>
<>llddaapp__sseett__ooppttiioonn((33))<>
<>llbbeerr--ssoocckkbbuuff((33))<>
<>eerrrrnnoo((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>
<>