ldap_add_ext_s

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 rep-
       resent 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  in-
       dicating  success  or, in the case of failure, indicating the nature of
       failure 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_DEPRE-
       CATED=1)  when compiling program designed to use deprecated interfaces.
       It is recommended that developers writing new programs, or updating old
       programs,  avoid  use  of  deprecated interfaces.  Over time, it is ex-
       pected that documentation (and, eventually, support) for deprecated in-
       terfaces to be eliminated.

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 the Uni-
       versity of Michigan LDAP 3.3 Release.

OpenLDAP                          2020/01/30                       LDAP_ADD(3)