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  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_BVAL­
       UES 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  asynchronous.   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 parame­
       ter  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 Pro­
       ject (http://www.openldap.org/).  OpenLDAP is derived from
       University of Michigan LDAP 3.3 Release.


Man(1) output converted with man2html