NAME

ldap_is_ldap_url, ldap_url_parse, ldap_free_urldesc - LDAP Uniform Resource Locator routines

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__iiss__llddaapp__uurrll(( ccoonnsstt cchhaarr **uurrll ))
<>
iinntt llddaapp__uurrll__ppaarrssee(( ccoonnsstt cchhaarr **uurrll,, LLDDAAPPUURRLLDDeesscc ****lluuddpppp ))
<>
ttyyppeeddeeff ssttrruucctt llddaapp__uurrll__ddeesscc {{
    cchhaarr **      lluudd__sscchheemmee;;     //** UURRII sscchheemmee **//
    cchhaarr **      lluudd__hhoosstt;;       //** LLDDAAPP hhoosstt ttoo ccoonnttaacctt **//
    iinntt         lluudd__ppoorrtt;;       //** ppoorrtt oonn hhoosstt **//
    cchhaarr **      lluudd__ddnn;;         //** bbaassee ffoorr sseeaarrcchh **//
    cchhaarr ****     lluudd__aattttrrss;;      //** lliisstt ooff aattttrriibbuutteess **//
    iinntt         lluudd__ssccooppee;;      //** aa LLDDAAPP__SSCCOOPPEE__...... vvaalluuee **//
    cchhaarr **      lluudd__ffiilltteerr;;     //** LLDDAAPP sseeaarrcchh ffiilltteerr **//
    cchhaarr ****     lluudd__eexxttss;;       //** LLDDAAPP eexxtteennssiioonnss **//
    iinntt         lluudd__ccrriitt__eexxttss;;  //** ttrruuee iiff aannyy eexxtteennssiioonn iiss ccrriittiiccaall **//
    //** mmaayy ccoonnttaaiinn aaddddiittiioonnaall ffiieellddss ffoorr iinntteerrnnaall uussee **//
}} LLDDAAPPUURRLLDDeesscc;;
<>
vvooiidd llddaapp__ffrreeee__uurrllddeesscc(( LLDDAAPPUURRLLDDeesscc **lluuddpp ));;
<> DDEESSCCRRIIPPTTIIOONN <>
TThheessee rroouuttiinneess ssuuppppoorrtt tthhee uussee ooff LLDDAAPP UURRLLss ((UUnniiffoorrmm RReessoouurrccee LLooccaattoorrss))
aass ddeettaaiilleedd iinn RRFFCC 44551166..  LLDDAAPP UURRLLss llooookk lliikkee tthhiiss::
<>
<>
<>
        <>
  llddaapp::////_h_o_s_t_p_o_r_t//_d_n[[??_a_t_t_r_s[[??_s_c_o_p_e[[??_f_i_l_t_e_r[[??_e_x_t_s]]]]]]]]
        <>
wwhheerree::
  _h_o_s_t_p_o_r_t iiss aa hhoosstt nnaammee wwiitthh aann ooppttiioonnaall ""::ppoorrttnnuummbbeerr""
  _d_n iiss tthhee sseeaarrcchh bbaassee
  _a_t_t_r_s iiss aa ccoommmmaa sseeppaarraatteedd lliisstt ooff aattttrriibbuutteess ttoo rreeqquueesstt
  _s_c_o_p_e iiss oonnee ooff tthheessee tthhrreeee ssttrriinnggss::
    bbaassee oonnee ssuubb ((ddeeffaauulltt==bbaassee))
  _f_i_l_t_e_r iiss ffiilltteerr
  _e_x_t_s aarree rreeccooggnniizzeedd sseett ooff LLDDAAPP aanndd//oorr AAPPII eexxtteennssiioonnss..
        <>
EExxaammppllee::
  llddaapp::////llddaapp..eexxaammppllee..nneett//ddcc==eexxaammppllee,,ddcc==nneett??ccnn,,ssnn??ssuubb??((ccnn==**))
        <>
<>
UURRLLss tthhaatt aarree wwrraappppeedd iinn aannggllee--bbrraacckkeettss aanndd//oorr pprreecceeddeedd bbyy ""UURRLL::"" aarree aallssoo
ttoolleerraatteedd..  AAlltteerrnnaattiivvee LLDDAAPP sscchheemmeess ssuucchh aass llddaappss:://// aanndd llddaappii:://// mmaayy bbee
ppaarrsseedd uussiinngg tthhee bbeellooww rroouuttiinneess aass wweellll..
<>
<>llddaapp__iiss__llddaapp__uurrll(())<>
rreettuurrnnss aa nnoonn--zzeerroo vvaalluuee iiff _u_r_l llooookkss lliikkee aann LLDDAAPP UURRLL ((aass
ooppppoosseedd ttoo ssoommee ootthheerr kkiinndd ooff UURRLL))..  IItt ccaann bbee uusseedd aass aa qquuiicckk cchheecckk
ffoorr aann LLDDAAPP UURRLL;; tthhee
<>llddaapp__uurrll__ppaarrssee(())<>
rroouuttiinnee sshhoouulldd bbee uusseedd iiff aa mmoorree tthhoorroouugghh cchheecckk iiss nneeeeddeedd..
<>
<>llddaapp__uurrll__ppaarrssee(())<>
bbrreeaakkss ddoowwnn aann LLDDAAPP UURRLL ppaasssseedd iinn _u_r_l iinnttoo iittss ccoommppoonneenntt ppiieecceess..
IIff ssuucccceessssffuull,, zzeerroo iiss rreettuurrnneedd,, aann LLDDAAPP UURRLL ddeessccrriippttiioonn iiss
aallllooccaatteedd,, ffiilllleedd iinn,, aanndd _l_u_d_p_p iiss sseett ttoo ppooiinntt ttoo iitt..  IIff aann
eerrrroorr ooccccuurrss,, aa nnoonn--zzeerroo UURRLL eerrrroorr ccooddee iiss rreettuurrnneedd..
<>
<>llddaapp__ffrreeee__uurrllddeesscc(())<>
sshhoouulldd bbee ccaalllleedd ttoo ffrreeee aann LLDDAAPP UURRLL ddeessccrriippttiioonn tthhaatt wwaass oobbttaaiinneedd ffrroomm
aa ccaallll ttoo
<>llddaapp__uurrll__ppaarrssee(())..<>
<> SSEEEE AALLSSOO <>
<>
<>
<>llddaapp((33))<>
<>RRFFCC 44551166<> <>
<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>
<>