Whamcloud - gitweb
LU-13456 ldlm: fix reprocessing of locks with more bits
[fs/lustre-release.git] / lustre / doc / lfs-migrate.1
index 3e30ccc..fb72541 100644 (file)
@@ -3,8 +3,8 @@
 lfs migrate \- migrate files or directories between MDTs or OSTs.
 .SH SYNOPSIS
 .B lfs migrate
+.RB [ -h "] [" -v ]
 .RI [ SETSTRIPE_OPTIONS " ... ]"
-.RB [ -v ]
 .RI < file "> ..."
 .br
 .B lfs migrate -m \fIstart_mdt_index
@@ -47,6 +47,9 @@ being lost.  This should be used if an OST needs to be completely emptied
 prior to its removal, to ensure all requested files are migrated off the
 OST.
 .TP
+.BR -h , --help
+Print usage message.
+.TP
 .BR -n , --non-block
 Abort migration if concurrent file access is detected.  This can be
 used with OST space balancing migration to avoid interfering with file
@@ -86,7 +89,9 @@ Directory will be migrated to MDTs starting with
 , or specific MDTs if multiple MDTs are specified in a comma-seperated list.
 This is useful if new MDTs have been added to a filesystem and existing user or
 project directories should be migrated off old MDTs to balance the space usage
-and future metadata workload.
+and future metadata workload. If
+.I start_mdt_index
+is set to -1, the MDT will be chosen by space and inode usage.
 .TP
 .BR -c , --mdt-count=\fICOUNT\fR
 Directory will be migrated to
@@ -99,16 +104,21 @@ Use
 for the new layout.
 .RS 1.2i
 .TP
-.B fnv_1a_64
-Fowler-Noll-Vo (FNV-1a) hash algorithm.  This provides
-reasonably uniform, but not cryptographically strong,
-hashing of the filename. (default)
-.TP
-.B all_char
+.B all_char (type 1)
 Sum of ASCII characters modulo number of MDTs. This
 provides weak hashing of the filename, and is suitable
 for only testing or when the input is known to have
 perfectly uniform distribution (e.g. sequential numbers).
+.TP
+.B fnv_1a_64 (type 2)
+Fowler-Noll-Vo (FNV-1a) hash algorithm.  This provides
+reasonably uniform, but not cryptographically strong,
+hashing of the filename. (default)
+.TP
+.B crush (type 3)
+CRUSH hash algorithm.  This is a consistent hash
+algorithm, so minimum sub files need to relocate
+during directory restripe.
 .RE
 .P
 Only the root user can migrate directories.  Files that have been archived by