LDAP_ADD(3) OpenLDAP LDVERSION LDAP_ADD(3)
RELEASEDATE
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.
- 1 - Formatted: March 14, 2025
