NAME | SYNOPSIS | DESCRIPTION | ERRORS | ATTRIBUTES | SEE ALSO
cc[ flag... ] file... -lldap[ library... ] #include <lber.h> #include <ldap.h>int ldap_modrdn(LDAP **ld, char **dn, char **newrdn);
The ldap_modrdn() and ldap_modrdn_s() functions perform an LDAP modify RDN (Relative Distinguished Name) 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 functions is deprecated. Use the versions described below instead.
The ldap_modrdn2() and ldap_modrdn2_s() functions 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.
The ldap_modrdn_s() routine is deprecated and the ldap_rename() and ldap_rename_s() routines are used instead.
The ldap_rename() , ldap_rename_s() routines are used to change the name, that is, the rdn of an entry. These routines deprecate ldap_modrdn() and ldap_modrdn_s() .
The ldap_rename() and ldap_rename_s() functions both support LDAPv3 server controls and client controls.
The synchronous (_s ) versions of these functions return an LDAP error code, either LDAP_SUCCESS or an error (see ldap_error(3LDAP) ).
The asynchronous versions return -1 in case of trouble, setting the ld_errno field of ld . See ldap_error(3LDAP) for more details. Use ldap_result(3LDAP) to determine a particular unsuccessful result.
See attributes(5) for a description of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWlldap (32-bit) |
SUNWldapx (64-bit) | |
Stability Level | Evolving |
NAME | SYNOPSIS | DESCRIPTION | ERRORS | ATTRIBUTES | SEE ALSO