From: Keguang Xu <squalfof@gmail.com>
Date: Thu, 14 Nov 2024 07:20:25 +0000 (+0800)
Subject: LU-18244 docs: update lfs mkdir description
X-Git-Tag: 2.16.55~126
X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;h=9c0f4c7cb3c04ebc94d3b528a54dd091b0af0370;p=fs%2Flustre-release.git

LU-18244 docs: update lfs mkdir description

Accompany with the patch 56925 where "lfs mkdir -C -N" is
supported aiming to align the behavior of OSTs, this patch
adds related description.

Test-Parameters: trivial
Signed-off-by: Keguang Xu <squalfof@gmail.com>
Change-Id: I17f8aa3d5fa7df2c2b419320a0bedd0686ebaee0
Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/57011
Tested-by: Maloo <maloo@whamcloud.com>
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Reviewed-by: Lai Siyao <lai.siyao@whamcloud.com>
Reviewed-by: Oleg Drokin <green@whamcloud.com>
---

diff --git a/lustre/doc/lfs-setdirstripe.1 b/lustre/doc/lfs-setdirstripe.1
index 209fe37..5f7119a 100644
--- a/lustre/doc/lfs-setdirstripe.1
+++ b/lustre/doc/lfs-setdirstripe.1
@@ -28,8 +28,10 @@ MDTs.
 .B -C\fR, \fB--overstripe-count \fISTRIPE_COUNT\fR
 The number of stripes to create, creating > 1 stripe MDT if \fISTRIPE_COUNT\fR
 exceeds the number of MDTs in the file system. \fB0 \fRmeans to use the
-filesystem-wide default stripe count (default 1), and \fB-1 \fRmeans to stripe
-over all available MDTs.  Max of 5 stripes/MDT.
+filesystem-wide default stripe count (default 1). While negative value \fB-N \fR
+means \fBN \fRstripes per available MDT. \fB-1 \fRallocates one stripe per MDT,
+values of -2, -3, -4, and -5 allocate 2, 3, 4, and 5 stripes per MDT,
+respectively. The maximum allowable multiplier is currently \fB-5\fR.
 .TP
 .BR \-h ", " \-\-help
 Print usage message.