ldap_add
NAME
ldap_add, ldap_add_s, ldap_add_ext, ldap_add_ext_s - Perform an LDAP add operation
LIBRARY
OpenLDAP LDAP (libldap, -lldap)
SYNOPSIS
#include <ldap.h>
I int ldap_add(LDAP * ld , const char * dn , LDAPMod * attrs []);
I int ldap_add_s(LDAP * ld , const char * dn , LDAPMod * attrs []);
I int ldap_add_ext(LDAP * ld , const char * dn , LDAPMod * attrs [],
I LDAPControl * sctrls [], LDAPControl * cctrls [], int * msgidp );
I int ldap_add_ext_s(LDAP * ld , const char * dn , LDAPMod * attrs [],
I LDAPControl * sctrls [], LDAPControl * cctrls []);
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_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_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
R 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).
The
ldap_add_ext()
routine allows server and client controls to be specified to extend
the add request. This routine is asynchronous like
R ldap_add() ,
but its return value is an LDAP error code. It stores the message id
of the request in the integer pointed to
by
R msgidp .
The
ldap_add_ext_s()
routine is the synchronous version of
R ldap_add_ext() .
It also returns an LDAP error code indicating success or failure
of the operation.
ERRORS
ldap_add()
returns -1 in case of error initiating the request, and
will set the ld_errno field in the ld parameter
to indicate the error.
ldap_add_s()
will return an LDAP error code
directly (LDAP_SUCCESS if everything went ok, some error otherwise).
ldap_add_ext()
and
ldap_add_ext_s()
also directly return LDAP error codes.
SEE ALSO
ACKNOWLEDGEMENTS
OpenLDAP
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
OpenLDAP
is derived from University of Michigan LDAP 3.3 Release.
ČLÁNKY DO MAILU