Sun Directory Server Enterprise Edition 7.0 Developer's Guide

Returns

This function returns the new DN for the entry whose previous DN was dn_olddn.