-is a simple tool to assist migration of files between Lustre OSTs. It
-is simply copying each specified file to a new file, verifying the file
-contents have not changed, and then renaming the new file back to the
-original filename. This allows balancing space usage between OSTs, moving
-files of OSTs that are starting to show hardware problems (though are still
-functional), or OSTs will be discontinued.
-.PP
-Because
-.B lfs_migrate
-is
-.B not
-closely integrated with the MDS, it cannot determine whether a file
-is currently open and/or in-use by other applications or nodes. That makes
-it
-.B
-UNSAFE
-for use on files that might be modified by other applications, since the
-migrated file is only a copy of the current file, and this will result in
-the old file becoming an open-unlinked file and any modifications to that
-file will be lost.
+is a tool to assist migration of files between Lustre OSTs, possibly also
+restriping the files as it goes. It copies each specified file to a new file,
+verifies the file contents have not changed, and then replaces the original
+filename with the new file (either atomically via
+.BR lfs-migrate (1)
+on Lustre 2.5 and later, or
+.BR mv (1)
+on older versions of Lustre). This allows balancing space usage between OSTs,
+moving files off OSTs that are starting to show hardware problems but are still
+functional, or OSTs that will be removed from the filesystem.