Manpages

Manpage of LDAP_ADD

LDAP_ADD

Section: C Library Functions (3)
Updated: 22 September 1998
Index
Return to Main Contents
 

NAME

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_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 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 parameter 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

is developed and maintained by The OpenLDAP Project (http://www.openldap.org/). is derived from University of Michigan LDAP 3.3 Release.


 

Index

NAME
SYNOPSIS
DESCRIPTION
ERRORS
SEE ALSO
ACKNOWLEDGEMENTS

This document was created by man2html, using the manual pages.
Time: 12:36:39 GMT, March 29, 2024