NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ERRORS | ATTRIBUTES | SEE ALSO
cc[ flag... ] file... -lldap[ library... ] $(OS_DIR)/lib/libldap.a #include <lber.h> #include <ldap.h>int ldap_add(LDAP *ld, char *dn, LDAPMod *attrs []);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
The ldap_add_s() function 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(3LDAP) , 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(3LDAP) for more details.
The ldap_add() function 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(3LDAP) .
The ldap_add_ext() function initiates an asynchronous add operation and returns LDAP_SUCCESS if the request was successfully sent to the server, or else it returns an LDAP error code if not (see ldap_error ). If successful, ldap_add_ext() places the message id of *msgidp . A subsequent call to ldap_result() , can be used to obtain the result of the add request.
The ldap_add_ext_s() function initiates a synchronous add operation and returns the result of the operation itself.
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, an error otherwise).
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ERRORS | ATTRIBUTES | SEE ALSO