ldap_modrdn(3ldap)
ldap_modrdn, ldap_modrdn_s, ldap_modrdn2, ldap_modrdn2_s --
perform an LDAP modify RDN operation
Synopsis
#include <lber.h>
#include <ldap.h>
int ldap_modrdn(LDAP
ld, char
dn, char
newrdn);
int ldap_modrdn_s(LDAP
ld, char
dn, char
newrdn);
int ldap_modrdn2(LDAP
ld, char
dn, char
newrdn, int deleteoldrdn);
int ldap_modrdn2_s(LDAP
ld, char
dn, char
newrdn, int deleteoldrdn);
Description
The superceded (see below) ldap_modrdn and
ldap_modrdn_s routines perform an LDAP modify
RDN operation. They both take dn, the DN of
the entry whose RDN is to be changed, and newrdn, the
new RDN to give the entry. The old RDN of the entry
is never kept as an attribute of the entry. ldap_modrdn is
asynchronous, returning the message ID of the operation it
initiates. ldap_modrdn_s is synchronous, returning the
LDAP error code indicating the success or failure of the
operation. Use of these routines is deprecated. Use the versions
described below instead.
The ldap_modrdn2 and ldap_modrdn2_s routines also
perform an LDAP modify RDN operation, taking the same
parameters as above. In addition, they both take the deleteoldrdn
parameter which is used as a boolean value to indicate whether the old
RDN values should be deleted from the entry or not.
Return values
The synchronous (
_s) versions of these routines return an
LDAP error code, either LDAP_SUCCESS or an error.
The asynchronous versions return -1 on error, setting the
ld_errno
field of ld. See the
ldap_perror(3ldap)
manual page for more details.
References
Intro(3ldap),
ldap_perror(3ldap)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.