as the master/starting MDT for the directory. If multiple
.I MDT_INDEX
values are given, then the stripes will be allocated on the specified
-MDT indices. If index -1 (default) is used, it will prefer to select
+MDT indices. If
+.B -1
+(default) is used, the client will round-robin subdirectory creation
+across all MDTs if their free space is within
+.B lod.*.mdt_qos_threshold_rr
+percent of each other, otherwise the client will prefer to select
.B COUNT
-MDTs proportional to the free space and inodes on each.
+MDT(s) proportional to the free space and inodes on each.
.TP
.BR \-H ", " \-\-mdt-hash =\fIHASH_TYPE\fR
Use
sub-directories will use the new default striping pattern,
but existing sub-directories will not be affected. The newly
created sub-directories will also inherit the specified default
-striping pattern. Only default stripe count is supported for now.
+striping pattern.
Note that striping all directories across all MDTs by default is
.B not
recommended at this time, as the clients will have to do more RPCs to
create and access each directory, hurting performance rather than
-improving it. Default striped directories are preferred for parent
-directories
-where large subdirectories will be created (e.g. file-per-process
-job output directories).
+improving it. Default striped directories are preferred only for
+parent directories where large subdirectories will be created
+(e.g. file-per-process job output directories). Instead, using
+.B -c 1 -i -1
+on top-level directories balances mkdir therein over MDTs automatically
+without causing all subdirectories to be remote by default.
.TP
.BR \-o ", " \-\-mode =\fIMODE\fR
Set the file access permissions of the new directory to the specified
.B "0"
to limit remote/striped directories to only the root user.
-The root directory of the file system is on MDT0000, and directories and
-files inherit the MDT of their parent directory unless a different MDT is
-specified with this command.
+The root directory of the file system is on MDT0000, and a filesystem-wide
+default directory layout is set on it by default:
+.B lfs setdirstripe -D -i -1 -c 1 --max-inherit -1 --max-inherit-rr 3
+, which is a space balanced directory layout, therefore new directories will be
+created on all MDTs by inode and space usage, and the top three level of new
+directories will be created in roundrobin mode if system is balanced. If user
+doesn't want automatic space balance, deleting this default directory layout
+won't work, because it will be recreated if not set, instead user can run
+.B lfs setdirstripe -D -i -1 -c 1 --max-inherit 1 <mountpoint>
+to limit space balance in the top level, or run
+.B lfs setdirstripe -D -i 0 -c 1 --max-inherit 1 <mountpoint>
+to disable it.
-By default, only directories on MDT0000 can contain directories that are not on
-the same MDT. However, if
-.B "mdt.*.enable_remote_dir"
-is set non-zero on an MDT (the default)
-then it will allow creating remote directories that have parents other than
-MDT0000. This is restricted to avoid creating directory trees that have
-intermediate path components on a series different MDTs and become unavailable
-if any of the intermediate MDTs are offline.
.SH EXAMPLES
.TP
.B $ lfs setdirstripe -c 2 -i 1 -H all_char /mnt/lustre/dir1