NAME

ldap_first_attribute, ldap_next_attribute - step through LDAP entry attributes

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
cchhaarr **llddaapp__ffiirrsstt__aattttrriibbuuttee((
        LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **eennttrryy,, BBeerrEElleemmeenntt ****bbeerrppttrr ))
<>
cchhaarr **llddaapp__nneexxtt__aattttrriibbuuttee((
        LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **eennttrryy,, BBeerrEElleemmeenntt **bbeerr ))
<> DDEESSCCRRIIPPTTIIOONN <>
TThhee
<>llddaapp__ffiirrsstt__aattttrriibbuuttee(())<>
aanndd
<>llddaapp__nneexxtt__aattttrriibbuuttee(())<>
rroouuttiinneess aarree uusseedd
ttoo sstteepp tthhrroouugghh tthhee aattttrriibbuutteess iinn aann LLDDAAPP eennttrryy..
<>llddaapp__ffiirrsstt__aattttrriibbuuttee(())<>
ttaakkeess aann _e_n_t_r_y aass rreettuurrnneedd bbyy
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
oorr
<>llddaapp__nneexxtt__eennttrryy((33))<>
aanndd rreettuurrnnss aa ppooiinntteerr ttoo cchhaarraacctteerr ssttrriinngg
ccoonnttaaiinniinngg tthhee ffiirrsstt aattttrriibbuuttee ddeessccrriippttiioonn iinn tthhee eennttrryy..
<>llddaapp__nneexxtt__aattttrriibbuuttee(())<>
rreettuurrnnss tthhee nneexxtt aattttrriibbuuttee ddeessccrriippttiioonn iinn tthhee eennttrryy..
<>
IItt aallssoo rreettuurrnnss,, iinn _b_e_r_p_t_r,, aa ppooiinntteerr ttoo aa BBeerrEElleemmeenntt iitt hhaass
aallllooccaatteedd ttoo kkeeeepp ttrraacckk ooff iittss ccuurrrreenntt ppoossiittiioonn..  TThhiiss ppooiinntteerr sshhoouulldd
bbee ppaasssseedd ttoo ssuubbsseeqquueenntt ccaallllss ttoo
<>llddaapp__nneexxtt__aattttrriibbuuttee(())<>
aanndd iiss uusseedd
ttoo eeffffeeccttiivveellyy sstteepp tthhrroouugghh tthhee eennttrryy''ss aattttrriibbuutteess..  TThhee ccaalllleerr iiss
ssoolleellyy rreessppoonnssiibbllee ffoorr ffrreeeeiinngg tthhee BBeerrEElleemmeenntt ppooiinntteedd ttoo bbyy _b_e_r_p_t_r
wwhheenn iitt iiss nnoo lloonnggeerr nneeeeddeedd bbyy ccaalllliinngg
<>bbeerr__ffrreeee((33))<>
WWhheenn ccaalllliinngg
<>bbeerr__ffrreeee((33))<>
iinn tthhiiss iinnssttaannccee,, bbee ssuurree tthhee sseeccoonndd aarrgguummeenntt iiss 00..
<>
TThhee aattttrriibbuuttee nnaammeess rreettuurrnneedd aarree ssuuiittaabbllee ffoorr iinncclluussiioonn iinn aa ccaallll
ttoo
<>llddaapp__ggeett__vvaalluueess((33))<>
ttoo rreettrriieevvee tthhee aattttrriibbuuttee''ss vvaalluueess..
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss,, NNUULLLL iiss rreettuurrnneedd aanndd tthhee lldd__eerrrrnnoo ffiieelldd iinn tthhee
_l_d ppaarraammeetteerr iiss sseett ttoo iinnddiiccaattee tthhee eerrrroorr..  SSeeee
<>llddaapp__eerrrroorr((33))<>
ffoorr aa ddeessccrriippttiioonn ooff ppoossssiibbllee eerrrroorr ccooddeess..
<> NNOOTTEESS <>
TThhee
<>llddaapp__ffiirrsstt__aattttrriibbuuttee(())<>
aanndd
<>llddaapp__nneexxtt__aattttrriibbuuttee(())<>
rreettuurrnn ddyynnaammiiccaallllyy aallllooccaatteedd mmeemmoorryy tthhaatt mmuusstt bbee ffrreeeedd bbyy tthhee ccaalllleerr vviiaa
<>llddaapp__mmeemmffrreeee((33))<>
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
<>llddaapp__ggeett__vvaalluueess((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..
<>