Back to main site | Back to man page index

LDAP_ADD(3)                                    Library Functions Manual                                   LDAP_ADD(3)



NAME
       ldap_add_ext, ldap_add_ext_s - Perform an LDAP add operation

LIBRARY
       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS
       #include <ldap.h>

       int ldap_add_ext(
              LDAP *ld,
              const char *dn,
              LDAPMod **attrs,
              LDAPControl **sctrls,
              LDAPControl **cctrls,
              int *msgidp );

       int ldap_add_ext_s(
              LDAP *ld,
              const char *dn,
              LDAPMod **attrs,
              LDAPControl *sctrls,
              LDAPControl *cctrls );

DESCRIPTION
       The  ldap_add_ext_s()  routine  is used to perform an LDAP add operation.  It takes dn, the DN of the entry to
       add, and attrs, a null-terminated array of the entry's attributes.  The LDAPMod structure is used to represent
       attributes,  with the mod_type and mod_values fields being used as described under ldap_modify_ext(3), and the
       ldap_op field being used only if you need to specify the LDAP_MOD_BVALUES option. Otherwise, it should be  set
       to zero.

       Note  that  all  entries  except  that  specified  by  the  last component in the given DN must already exist.
       ldap_add_ext_s() returns an code indicating success or, in the case of failure, indicating the nature of fail‐
       ure of the operation.  See ldap_error(3) for more details.

       The  ldap_add_ext()  routine works just like ldap_add_ext_s(), but it is asynchronous.  It returns the message
       id of the request it initiated.  The result of this operation can be obtained by calling ldap_result(3).

DEPRECATED INTERFACES
       The ldap_add() and ldap_add_s() routines are deprecated in favor of the  ldap_add_ext()  and  ldap_add_ext_s()
       routines, respectively.

       Deprecated interfaces generally remain in the library.  The macro LDAP_DEPRECATED can be defined to a non-zero
       value (e.g., -DLDAP_DEPRECATED=1) when compiling program designed to use deprecated interfaces.  It is  recom‐
       mended  that  developers  writing  new programs, or updating old programs, avoid use of deprecated interfaces.
       Over time, it is expected that documentation (and, eventually, support) for deprecated interfaces to be elimi‐
       nated.

SEE ALSO
       ldap(3), ldap_error(3), ldap_modify(3)

ACKNOWLEDGEMENTS
       OpenLDAP  Software  is  developed and maintained by The OpenLDAP Project <http://www.openldap.org/>.  OpenLDAP
       Software is derived from University of Michigan LDAP 3.3 Release.