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