ldap_add

LDAP_ADD(3)                                                        LDAP_ADD(3)



NAME
       ldap_add, ldap_add_s - Perform an LDAP add operation

SYNOPSIS
       #include <ldap.h>

       int ldap_add(ld, dn, attrs)
       LDAP *ld;
       char *dn;
       LDAPMod *attrs[];

       int ldap_add_s(ld, dn, attrs)
       LDAP *ld;
       char *dn;
       LDAPMod *attrs[];

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 rep-
       resent 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. 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_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  asyn-
       chronous.   It returns the message id of the request it initiated.  The
       result of this operation can be obtained by calling ldap_result(3).

ERRORS
       ldap_add() returns -1 in case of error initiating the 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).

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 2.0.27-Release        22 September 1998                   LDAP_ADD(3)