kadm5_ret_t kadm5_rename_principal(void *server_handle, krb5_principal source, krb5_principal target);
AUTHORIZATION REQUIRED: add and delete
Note that since the principal name may have been used as the salt for the principal's key, renaming the principal may render the principal's current password useless; with the new salt, the key generated by string-to-key on the password will suddenly be different. Therefore, an application that renames a principal must also require the user to specify a new password for the principal (and administrators should notify the affected party).
Note also that, by the same argument, renaming a principal will invalidate that principal's password history information; since the salt will be different, a user will be able to select a previous password without error.
RETURN CODES: