ldap_add(3)

LDAP_ADD(3)            C LIBRARY FUNCTIONS            LDAP_ADD(3)

NAME

     ldap_add, ldap_add_s, ldap_add_ext, ldap_add_ext_s - Perform
     an LDAP add operation

LIBRARY

     OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS

     #include <ldap.h>

     int ldap_add(LDAP *ld, const char *dn, LDAPMod *attrs

     int ldap_add_s(LDAP *ld, const char *dn, LDAPMod *attrs

     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_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(3), and the ldap_op field being used only
     if you need to specify the LDAP_MOD_BVALUES  option.  Other-
     wise, it should be set to zero.

     Note that all entries except that specified by the last com-
     ponent  in  the  given  DN must already exist.  ldap_add_s()
     returns an LDAP error code indicating success or failure  of
     the operation.  See ldap_error(3) for more details.

     The ldap_add() routine works just like ldap_add_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).

     The ldap_add_ext() routine allows server and client controls
     to  be  specified to extend the add request. This routine is
     asynchronous like ldap_add(), but its  return  value  is  an
     LDAP error code.  It stores the message id of the request in
     the integer pointed to by msgidp.

     The ldap_add_ext_s() routine is the synchronous  version  of
     ldap_add_ext().  It also returns an LDAP error code indicat-
     ing success or failure of the operation.

ERRORS

     ldap_add() returns  -1  in  case  of  error  initiating  the

OpenLDAP LDVERSION  Last change: RELEASEDATE                    1

LDAP_ADD(3)            C LIBRARY FUNCTIONS            LDAP_ADD(3)

     request, and will set the ld_errno field in the ld parameter
     to indicate the error.  ldap_add_s()  will  return  an  LDAP
     error  code  directly  (LDAP_SUCCESS  if everything went ok,
     some error otherwise).  ldap_add_ext() and  ldap_add_ext_s()
     also directly return LDAP error codes.

SEE ALSO

     ldap(3), ldap_modify(3)

ACKNOWLEDGEMENTS

     OpenLDAP is developed and maintained by The OpenLDAP Project
     (http://www.openldap.org/).    OpenLDAP   is   derived  from
     University of Michigan LDAP 3.3 Release.

OpenLDAP LDVERSION  Last change: RELEASEDATE                    2