Home | History | Annotate | Line # | Download | only in man3 
 LDAP_ADD 3 "RELEASEDATE" "OpenLDAP LDVERSION"
 $OpenLDAP$
 Copyright 1998-2024 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