NAME

ldap_perror, ld_errno, ldap_result2error, ldap_errlist, ldap_err2string - LDAP protocol error handling routines

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
cchhaarr **llddaapp__eerrrr22ssttrriinngg(( iinntt _e_r_r ));;
<> DDEESSCCRRIIPPTTIIOONN <>
TThhee
<>llddaapp__eerrrr22ssttrriinngg(())<>
rroouuttiinnee pprroovviiddeess sshhoorrtt ddeessccrriippttiioonn ooff tthhee vvaarriioouuss ccooddeess rreettuurrnneedd bbyy
rroouuttiinneess iinn tthhiiss lliibbrraarryy..  TThhee rreettuurrnneedd ssttrriinngg iiss aa ppooiinntteerr ttoo aa
ssttaattiicc aarreeaa tthhaatt sshhoouulldd nnoott bbee mmooddiiffiieedd..
        <>
TThheessee ccooddeess aarree eeiitthheerr nneeggaattiivvee,,
iinnddiiccaattiinngg aann AAPPII eerrrroorr ccooddee;; ppoossiittiivvee,, iinnddiiccaattiinngg aann LLDDAAPP rreessuullttCCooddee
ootthheerr tthhaann ´´ssuucccceessss'' ((00)),, oorr -- zzeerroo,, iinnddiiccaattiinngg bbootthh ssuucccceessssffuull uussee
ooff tthhee AAPPII aanndd tthhee LLDDAAPP rreessuullttCCooddee ´´ssuucccceessss'' ((00))..
        <>
TThhee ccooddee aassssoocciiaatteedd wwiitthh aann LLDDAAPP sseessssiioonn iiss aacccceessssiibbllee uussiinngg
<>llddaapp__ggeett__ooppttiioonn((33))<>
aanndd
<>llddaapp__sseett__ooppttiioonn((33))<>
wwiitthh tthhee
<>LLDDAAPP__OOPPTT__RREESSUULLTT__CCOODDEE<>
ooppttiioonn ((pprreevviioouussllyy ccaalllleedd
<>LLDDAAPP__OOPPTT__EERRRROORR__NNUUMMBBEERR<>))..
        <>
<> PPRROOTTOOCCOOLL RREESSUULLTT CCOODDEESS <>
        <>
TThhiiss sseeccttiioonn pprroovviiddeess aa ppaarrttiiaall lliisstt ooff pprroottooccooll ccooddeess rreeccooggnniizzeedd
bbyy tthhee lliibbrraarryy..  AAss LLDDAAPP iiss eexxtteennssiibbllee,, aaddddiittiioonnaall vvaalluueess mmaayy bbee
rreettuurrnneedd..  AA ccoommpplleettee lliissttiinngg ooff _r_e_g_i_s_t_e_r_e_d LLDDAAPP rreessuulltt ccooddeess
ccaann bbee oobbttaaiinneedd ffrroomm tthhee _I_n_t_e_r_n_e_t _A_s_s_i_g_n_e_d _N_u_m_b_e_r_s _A_u_t_h_o_r_i_t_y
<>..
        <>
<>
<>
<>
<>
<>
LLDDAAPP__SSUUCCCCEESSSS
<>
TThhee rreeqquueesstt wwaass ssuucccceessssffuull..
<>
<>
<>
LLDDAAPP__OOPPEERRAATTIIOONNSS__EERRRROORR
<>
AAnn ooppeerraattiioonnss eerrrroorr ooccccuurrrreedd..
<>
<>
<>
LLDDAAPP__PPRROOTTOOCCOOLL__EERRRROORR
<>
AA pprroottooccooll vviioollaattiioonn wwaass ddeetteecctteedd..
<>
<>
<>
LLDDAAPP__TTIIMMEELLIIMMIITT__EEXXCCEEEEDDEEDD
<>
AAnn LLDDAAPP ttiimmee lliimmiitt wwaass eexxcceeeeddeedd..
<>
<>
<>
LLDDAAPP__SSIIZZEELLIIMMIITT__EEXXCCEEEEDDEEDD
<>
AAnn LLDDAAPP ssiizzee lliimmiitt wwaass eexxcceeeeddeedd..
<>
<>
<>
LLDDAAPP__CCOOMMPPAARREE__FFAALLSSEE
<>
AA ccoommppaarree ooppeerraattiioonn rreettuurrnneedd ffaallssee..
<>
<>
<>
LLDDAAPP__CCOOMMPPAARREE__TTRRUUEE
<>
AA ccoommppaarree ooppeerraattiioonn rreettuurrnneedd ttrruuee..
<>
<>
<>
LLDDAAPP__SSTTRROONNGG__AAUUTTHH__NNOOTT__SSUUPPPPOORRTTEEDD
<>
TThhee LLDDAAPP sseerrvveerr ddooeess nnoott ssuuppppoorrtt ssttrroonngg aauutthheennttiiccaattiioonn..
<>
<>
<>
LLDDAAPP__SSTTRROONNGG__AAUUTTHH__RREEQQUUIIRREEDD
<>
SSttrroonngg aauutthheennttiiccaattiioonn iiss rreeqquuiirreedd ffoorr tthhee ooppeerraattiioonn..
<>
<>
<>
LLDDAAPP__PPAARRTTIIAALL__RREESSUULLTTSS
<>
PPaarrttiiaall rreessuullttss oonnllyy rreettuurrnneedd..
<>
<>
<>
LLDDAAPP__NNOO__SSUUCCHH__AATTTTRRIIBBUUTTEE
<>
TThhee aattttrriibbuuttee ttyyppee ssppeecciiffiieedd ddooeess nnoott eexxiisstt iinn tthhee eennttrryy..
<>
<>
<>
LLDDAAPP__UUNNDDEEFFIINNEEDD__TTYYPPEE
<>
TThhee aattttrriibbuuttee ttyyppee ssppeecciiffiieedd iiss iinnvvaalliidd..
<>
<>
<>
LLDDAAPP__IINNAAPPPPRROOPPRRIIAATTEE__MMAATTCCHHIINNGG
<>
FFiilltteerr ttyyppee nnoott ssuuppppoorrtteedd ffoorr tthhee ssppeecciiffiieedd aattttrriibbuuttee..
<>
<>
<>
LLDDAAPP__CCOONNSSTTRRAAIINNTT__VVIIOOLLAATTIIOONN
<>
AAnn aattttrriibbuuttee vvaalluuee ssppeecciiffiieedd vviioollaatteess ssoommee ccoonnssttrraaiinntt ((ee..gg..,, aa ppoossttaallAAddddrreessss
hhaass ttoooo mmaannyy lliinneess,, oorr aa lliinnee tthhaatt iiss ttoooo lloonngg))..
<>
<>
<>
LLDDAAPP__TTYYPPEE__OORR__VVAALLUUEE__EEXXIISSTTSS
<>
AAnn aattttrriibbuuttee ttyyppee oorr aattttrriibbuuttee vvaalluuee ssppeecciiffiieedd aallrreeaaddyy eexxiissttss iinn tthhee eennttrryy..
<>
<>
<>
LLDDAAPP__IINNVVAALLIIDD__SSYYNNTTAAXX
<>
AAnn iinnvvaalliidd aattttrriibbuuttee vvaalluuee wwaass ssppeecciiffiieedd..
<>
<>
<>
LLDDAAPP__NNOO__SSUUCCHH__OOBBJJEECCTT
<>
TThhee ssppeecciiffiieedd oobbjjeecctt ddooeess nnoott eexxiisstt iinn TThhee DDiirreeccttoorryy..
<>
<>
<>
LLDDAAPP__AALLIIAASS__PPRROOBBLLEEMM
<>
AAnn aalliiaass iinn TThhee DDiirreeccttoorryy ppooiinnttss ttoo aa nnoonneexxiisstteenntt eennttrryy..
<>
<>
<>
LLDDAAPP__IINNVVAALLIIDD__DDNN__SSYYNNTTAAXX
<>
AA ssyynnttaaccttiiccaallllyy iinnvvaalliidd DDNN wwaass ssppeecciiffiieedd..
<>
<>
<>
LLDDAAPP__IISS__LLEEAAFF
<>
TThhee oobbjjeecctt ssppeecciiffiieedd iiss aa lleeaaff..
<>
<>
<>
LLDDAAPP__AALLIIAASS__DDEERREEFF__PPRROOBBLLEEMM
<>
AA pprroobblleemm wwaass eennccoouunntteerreedd wwhheenn ddeerreeffeerreenncciinngg aann aalliiaass..
<>
<>
<>
LLDDAAPP__IINNAAPPPPRROOPPRRIIAATTEE__AAUUTTHH
<>
IInnaapppprroopprriiaattee aauutthheennttiiccaattiioonn wwaass ssppeecciiffiieedd ((ee..gg..,, LLDDAAPP__AAUUTTHH__SSIIMMPPLLEE wwaass
ssppeecciiffiieedd aanndd tthhee eennttrryy ddooeess nnoott hhaavvee aa uusseerrPPaasssswwoorrdd aattttrriibbuuttee))..
<>
<>
<>
LLDDAAPP__IINNVVAALLIIDD__CCRREEDDEENNTTIIAALLSS
<>
IInnvvaalliidd ccrreeddeennttiiaallss wweerree pprreesseenntteedd ((ee..gg..,, tthhee wwrroonngg ppaasssswwoorrdd))..
<>
<>
<>
LLDDAAPP__IINNSSUUFFFFIICCIIEENNTT__AACCCCEESSSS
<>
TThhee uusseerr hhaass iinnssuuffffiicciieenntt aacccceessss ttoo ppeerrffoorrmm tthhee ooppeerraattiioonn..
<>
<>
<>
LLDDAAPP__BBUUSSYY
<>
TThhee DDSSAA iiss bbuussyy..
<>
<>
<>
LLDDAAPP__UUNNAAVVAAIILLAABBLLEE
<>
TThhee DDSSAA iiss uunnaavvaaiillaabbllee..
<>
<>
<>
LLDDAAPP__UUNNWWIILLLLIINNGG__TTOO__PPEERRFFOORRMM
<>
TThhee DDSSAA iiss uunnwwiilllliinngg ttoo ppeerrffoorrmm tthhee ooppeerraattiioonn..
<>
<>
<>
LLDDAAPP__LLOOOOPP__DDEETTEECCTT
<>
AA lloooopp wwaass ddeetteecctteedd..
<>
<>
<>
LLDDAAPP__NNAAMMIINNGG__VVIIOOLLAATTIIOONN
<>
AA nnaammiinngg vviioollaattiioonn ooccccuurrrreedd..
<>
<>
<>
LLDDAAPP__OOBBJJEECCTT__CCLLAASSSS__VVIIOOLLAATTIIOONN
<>
AAnn oobbjjeecctt ccllaassss vviioollaattiioonn ooccccuurrrreedd ((ee..gg..,, aa ""mmuusstt"" aattttrriibbuuttee wwaass mmiissssiinngg
ffrroomm tthhee eennttrryy))..
<>
<>
<>
LLDDAAPP__NNOOTT__AALLLLOOWWEEDD__OONN__NNOONNLLEEAAFF
<>
TThhee ooppeerraattiioonn iiss nnoott aalllloowweedd oonn aa nnoonnlleeaaff oobbjjeecctt..
<>
<>
<>
LLDDAAPP__NNOOTT__AALLLLOOWWEEDD__OONN__RRDDNN
<>
TThhee ooppeerraattiioonn iiss nnoott aalllloowweedd oonn aann RRDDNN..
<>
<>
<>
LLDDAAPP__AALLRREEAADDYY__EEXXIISSTTSS
<>
TThhee eennttrryy aallrreeaaddyy eexxiissttss..
<>
<>
<>
LLDDAAPP__NNOO__OOBBJJEECCTT__CCLLAASSSS__MMOODDSS
<>
OObbjjeecctt ccllaassss mmooddiiffiiccaattiioonnss aarree nnoott aalllloowweedd..
<>
<>
<>
LLDDAAPP__OOTTHHEERR
<>
AAnn uunnkknnoowwnn eerrrroorr ooccccuurrrreedd..
        <>
<>
<> AAPPII EERRRROORR CCOODDEESS <>
        <>
TThhiiss sseeccttiioonn pprroovviiddeess aa ccoommpplleettee lliisstt ooff AAPPII eerrrroorr ccooddeess rreeccooggnniizzeedd
bbyy tthhee lliibbrraarryy..   NNoottee tthhaatt LLDDAAPP__SSUUCCCCEESSSS iinnddiiccaatteess ssuucccceessss ooff aann
AAPPII ccaallll iinn aaddddiittiioonn ttoo rreepprreesseennttiinngg tthhee rreettuurrnn ooff tthhee LLDDAAPP
´´ssuucccceessss'' rreessuullttCCooddee..
        <>
        <>
<>
<>
<>
<>
<>
LLDDAAPP__SSEERRVVEERR__DDOOWWNN
<>
TThhee LLDDAAPP lliibbrraarryy ccaann''tt ccoonnttaacctt tthhee LLDDAAPP sseerrvveerr..
<>
<>
<>
LLDDAAPP__LLOOCCAALL__EERRRROORR
<>
SSoommee llooccaall eerrrroorr ooccccuurrrreedd..  TThhiiss iiss uussuuaallllyy aa ffaaiilleedd ddyynnaammiicc mmeemmoorryy aallllooccaattiioonn..
<>
<>
<>
LLDDAAPP__EENNCCOODDIINNGG__EERRRROORR
<>
AAnn eerrrroorr wwaass eennccoouunntteerreedd eennccooddiinngg ppaarraammeetteerrss ttoo sseenndd ttoo tthhee LLDDAAPP sseerrvveerr..
<>
<>
<>
LLDDAAPP__DDEECCOODDIINNGG__EERRRROORR
<>
AAnn eerrrroorr wwaass eennccoouunntteerreedd ddeeccooddiinngg aa rreessuulltt ffrroomm tthhee LLDDAAPP sseerrvveerr..
<>
<>
<>
LLDDAAPP__TTIIMMEEOOUUTT
<>
AA ttiimmeelliimmiitt wwaass eexxcceeeeddeedd wwhhiillee wwaaiittiinngg ffoorr aa rreessuulltt..
<>
<>
<>
LLDDAAPP__AAUUTTHH__UUNNKKNNOOWWNN
<>
TThhee aauutthheennttiiccaattiioonn mmeetthhoodd ssppeecciiffiieedd ttoo llddaapp__bbiinndd(()) iiss nnoott kknnoowwnn..
<>
<>
<>
LLDDAAPP__FFIILLTTEERR__EERRRROORR
<>
AAnn iinnvvaalliidd ffiilltteerr wwaass ssuupppplliieedd ttoo llddaapp__sseeaarrcchh(()) ((ee..gg..,, uunnbbaallaanncceedd
ppaarreenntthheesseess))..
<>
<>
<>
LLDDAAPP__PPAARRAAMM__EERRRROORR
<>
AAnn llddaapp rroouuttiinnee wwaass ccaalllleedd wwiitthh aa bbaadd ppaarraammeetteerr..
<>
<>
<>
LLDDAAPP__NNOO__MMEEMMOORRYY
<>
AAnn mmeemmoorryy aallllooccaattiioonn ((ee..gg..,, mmaalllloocc((33)) oorr ootthheerr ddyynnaammiicc mmeemmoorryy
aallllooccaattoorr)) ccaallll ffaaiilleedd iinn aann llddaapp lliibbrraarryy rroouuttiinnee..
<>
<>
<>
LLDDAAPP__UUSSEERR__CCAANNCCEELLEEDD
<>
IInnddiiccaatteess tthhee uusseerr ccaanncceelllleedd tthhee ooppeerraattiioonn..
<>
<>
<>
LLDDAAPP__CCOONNNNEECCTT__EERRRROORR
<>
IInnddiiccaatteess aa ccoonnnneeccttiioonn pprroobblleemm..
<>
<>
<>
LLDDAAPP__NNOOTT__SSUUPPPPOORRTTEEDD
<>
IInnddiiccaatteess tthhee rroouuttiinnee wwaass ccaalllleedd iinn aa mmaannnneerr nnoott ssuuppppoorrtteedd bbyy tthhee lliibbrraarryy..
<>
<>
<>
LLDDAAPP__CCOONNTTRROOLL__NNOOTT__FFOOUUNNDD
<>
IInnddiiccaatteess tthhee ccoonnttrrooll pprroovviiddeedd iiss uunnkknnoowwnn ttoo tthhee cclliieenntt lliibbrraarryy..
<>
<>
<>
LLDDAAPP__NNOO__RREESSUULLTTSS__RREETTUURRNNEEDD
<>
IInnddiiccaatteess nnoo rreessuullttss rreettuurrnneedd..
<>
<>
<>
LLDDAAPP__MMOORREE__RREESSUULLTTSS__TTOO__RREETTUURRNN
<>
IInnddiiccaatteess mmoorree rreessuullttss ccoouulldd bbee rreettuurrnneedd..
<>
<>
<>
LLDDAAPP__CCLLIIEENNTT__LLOOOOPP
<>
IInnddiiccaatteess tthhee lliibbrraarryy hhaass ddeetteecctteedd aa lloooopp iinn iittss pprroocceessssiinngg..
<>
<>
<>
LLDDAAPP__RREEFFEERRRRAALL__LLIIMMIITT__EEXXCCEEEEDDEEDD
<>
IInnddiiccaatteess tthhee rreeffeerrrraall lliimmiitt hhaass bbeeeenn eexxcceeeeddeedd..
        <>
<>
<> DDEEPPRREECCAATTEEDD <>
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))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>