aqs.org/rfcs/rfc2251.html">RFC 2251 has to say about it:
4.9. Modify Dn Operation The Modify Dn Operation allows a client to change the leftmost (least significant) component of the name of an entry in the directory, or to move a subtree of entries to a new location in the directory. The Modify Dn Request is defined as follows: ModifyDNRequest ::= [APPLICATION 12] SEQUENCE { entry LDAPDN, newrdn RelativeLDAPDN, deleteoldrdn BOOLEAN, newSuperior [0] LDAPDN OPTIONAL } Parameters of the Modify Dn Request are: - entry: the Distinguished Name of the entry to be changed. This entry may or may not have subordinate entries. - newrdn: the Rdn that will form the leftmost component of the new name of the entry. - deleteoldrdn: a boolean parameter that controls whether the old Rdn attribute values are to be retained as attributes of the entry, or deleted from the entry. - newSuperior: if present, this is the Distinguished Name of the entry which becomes the immediate superior of the existing entry.
Note that this operation can move an entry and change its Rdn at the same time in fact it might have no choice to comply with name forms.
@author
Apache Directory Project