LDAP_ADD 3 "RELEASEDATE" "OpenLDAP LDVERSION"
$OpenLDAP$
Copyright 1998-2011 The OpenLDAP Foundation All Rights Reserved.
Copying restrictions apply. See COPYRIGHT/LICENSE.
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 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.

.so Deprecated

SEE ALSO
ldap (3), ldap_error (3), ldap_modify (3)
ACKNOWLEDGEMENTS
.so ../Project