LDAP_ADD(3) Library Functions Manual LDAP_ADD(3)
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 rep-
resent 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 in-
dicating 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.
Deprecated interfaces generally remain in the library. The macro
LDAP_DEPRECATED can be defined to a non-zero value (e.g., -DLDAP_DEPRE-
CATED=1) when compiling program designed to use deprecated interfaces.
It is recommended that developers writing new programs, or updating old
programs, avoid use of deprecated interfaces. Over time, it is ex-
pected that documentation (and, eventually, support) for deprecated in-
terfaces to be eliminated.
SEE ALSO
ldap(3), ldap_error(3), ldap_modify(3)
ACKNOWLEDGEMENTS
OpenLDAP Software is developed and maintained by The OpenLDAP Project
<http://www.openldap.org/>. OpenLDAP Software is derived from the Uni-
versity of Michigan LDAP 3.3 Release.
OpenLDAP 2.5.18+dfsg-0ubuntu0.22.02024/05/21 LDAP_ADD(3)
Generated by dwww version 1.14 on Fri Jan 24 06:17:40 CET 2025.