NAME

ldap_add_ext, ldap_add_ext_s - Perform an LDAP add operation

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS

##iinncclluuddee <> <> <> <> iinntt llddaapp__aadddd__eexxtt(( LLDDAAPP **_l_d_, _c_o_n_s_t _c_h_a_r _*_d_n,, LLDDAAPPMMoodd ****_a_t_t_r_s,, LLDDAAPPCCoonnttrrooll ****_s_c_t_r_l_s,, LLDDAAPPCCoonnttrrooll ****_c_c_t_r_l_s,, iinntt **_m_s_g_i_d_p ));; <> <> <> <> iinntt llddaapp__aadddd__eexxtt__ss(( LLDDAAPP **_l_d,, ccoonnsstt cchhaarr **_d_n,, LLDDAAPPMMoodd ****_a_t_t_r_s,, LLDDAAPPCCoonnttrrooll **_s_c_t_r_l_s,, LLDDAAPPCCoonnttrrooll **_c_c_t_r_l_s ));; <> <> DDEESSCCRRIIPPTTIIOONN <> TThhee <>llddaapp__aadddd__eexxtt__ss(())<> rroouuttiinnee iiss uusseedd ttoo ppeerrffoorrmm aann LLDDAAPP aadddd ooppeerraattiioonn.. IItt ttaakkeess _d_n,, tthhee DDNN ooff tthhee eennttrryy ttoo aadddd,, aanndd _a_t_t_r_s,, aa nnuullll--tteerrmmiinnaatteedd aarrrraayy ooff tthhee eennttrryy''ss aattttrriibbuutteess.. TThhee LLDDAAPPMMoodd ssttrruuccttuurree iiss uusseedd ttoo rreepprreesseenntt aattttrriibbuutteess,, wwiitthh tthhee _m_o_d___t_y_p_e aanndd _m_o_d___v_a_l_u_e_s ffiieellddss bbeeiinngg uusseedd aass ddeessccrriibbeedd uunnddeerr <>llddaapp__mmooddiiffyy__eexxtt((33))<> aanndd tthhee _l_d_a_p___o_p ffiieelldd bbeeiinngg uusseedd oonnllyy iiff yyoouu nneeeedd ttoo ssppeecciiffyy tthhee LLDDAAPP__MMOODD__BBVVAALLUUEESS ooppttiioonn.. OOtthheerrwwiissee,, iitt sshhoouulldd bbee sseett ttoo zzeerroo.. <> NNoottee tthhaatt aallll eennttrriieess eexxcceepptt tthhaatt ssppeecciiffiieedd bbyy tthhee llaasstt ccoommppoonneenntt iinn tthhee ggiivveenn DDNN mmuusstt aallrreeaaddyy eexxiisstt.. <>llddaapp__aadddd__eexxtt__ss(())<> rreettuurrnnss aann ccooddee iinnddiiccaattiinngg ssuucccceessss oorr,, iinn tthhee ccaassee ooff ffaaiilluurree,, iinnddiiccaattiinngg tthhee nnaattuurree ooff ffaaiilluurree ooff tthhee ooppeerraattiioonn.. SSeeee <>llddaapp__eerrrroorr((33))<> ffoorr mmoorree ddeettaaiillss.. <> TThhee <>llddaapp__aadddd__eexxtt(())<> rroouuttiinnee wwoorrkkss jjuusstt lliikkee <>llddaapp__aadddd__eexxtt__ss(())<>,, bbuutt iitt iiss aassyynncchhrroonnoouuss.. IItt rreettuurrnnss tthhee mmeessssaaggee iidd ooff tthhee rreeqquueesstt iitt iinniittiiaatteedd.. TThhee rreessuulltt ooff tthhiiss ooppeerraattiioonn ccaann bbee oobbttaaiinneedd bbyy ccaalllliinngg <>llddaapp__rreessuulltt((33))<> <> DDEEPPRREECCAATTEEDD IINNTTEERRFFAACCEESS <> TThhee <>llddaapp__aadddd<>(()) aanndd <>llddaapp__aadddd__ss<>(()) rroouuttiinneess aarree ddeepprreeccaatteedd iinn ffaavvoorr ooff tthhee <>llddaapp__aadddd__eexxtt<>(()) aanndd <>llddaapp__aadddd__eexxtt__ss<>(()) rroouuttiinneess,, 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))<> <>llddaapp__mmooddiiffyy((33))<> <> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <> <>OOppeennLLDDAAPP SSooffttwwaarree<> iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>.. <>OOppeennLLDDAAPP SSooffttwwaarree<> iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee.. <> <>