LU-10026 csdc: DoM pattern could be a combined value

[fs/lustre-release.git] / lustre / doc / lfs-setquota.1

diff --git a/lustre/doc/lfs-setquota.1 b/lustre/doc/lfs-setquota.1
index fb9eeb6..71349d2 100644 (file)
--- a/lustre/doc/lfs-setquota.1
+++ b/lustre/doc/lfs-setquota.1
@@ -1,6 +1,6 @@
 .TH LFS-SETQUOTA 1 2017-07-21 "Lustre" "Lustre Utilities"
 .SH NAME
-lfs setquota \- set quota limits or grace time for users, groups or projects.
+lfs-setquota \- set quota limits or grace time for users, groups or projects.
 .SH SYNOPSIS
 .BR "lfs setquota " { -u | --user | -g | --group | -p | --projid "} " \fIUID | \fIGID | \fIPROJID
        [\fB--pool \fIPOOLNAME ]
@@ -15,7 +15,7 @@ lfs setquota \- set quota limits or grace time for users, groups or projects.
        [\fB--inode-grace\fR|\fB-i\fR \fIINODE_GRACE_TIME\fR] <\fIfilesystem\fR>
 .TP
 .BR "lfs setquota " { -u | --user | -g | --group | -p | --projid "} " \fIUID\fR|\fIGID\fR|\fIPROJID\fR
-       [\fB--default|-d\fR] <\fIfilesystem\fR>
+       [\fB--default|-D\fR] <\fIfilesystem\fR>
 .TP
 .BR "lfs setquota " { -U | --default-usr | -G | --default-grp | -P | --default-prj }
        [\fB--block-softlimit\fR|\fB-b\fR \fIBLOCK_SOFTLIMIT\fR[\fBkMGTPE\fR]]
@@ -23,6 +23,11 @@ lfs setquota \- set quota limits or grace time for users, groups or projects.
        [\fB--inode-softlimit\fR|\fB-i\fR \fIINODE_SOFTLIMIT\fR[\fBkMGTPE\fR]]
        [\fB--inode-hardlimit\fR|\fB-I\fR \fIINODE_HARDLIMIT\fR[\fBkMGTPE\fR]] <\fIfilesystem\fR>
 .TP
+.BR "lfs setquota " { -u | --user | -g | --group | -p | --projid "} " \fIUID\fR|\fIGID\fR|\fIPROJID\fR
+       [\fB--delete\fR] <\fIfilesystem\fR>
+.BR "lfs setquota " { -u | --user | -g | --group | -p | --projid "} " \fIUID\fR|\fIGID\fR|\fIPROJID\fR
+       [\fB-r\fR] <\fIfilesystem\fR>
+.TP
 .SH DESCRIPTION
 .TP
 .BR "lfs setquota " {\fB-u|-g|-p\fR}
@@ -41,7 +46,10 @@ Specify block softlimit, zero means unlimited.
 Specify block hardlimit, zero means unlimited. The block hardlimit should be
 greater than block softlimit when it's being specified.
 .TP
-.BR -d|--default
+.BR --delete
+Delete the unused UID|GID|PROJID.
+.TP
+.BR -D|--default
 Set user/group/project to use the default quota limits.
 .TP
 .BR -g | --group \fIGROUPNAME\fR|\fIGID
@@ -63,6 +71,10 @@ Set project quota for \fIPROJID\fR.
 .B --pool \fIPOOL_NAME\fR
 Set quota per OST pool \fIPOOL_NAME\fR.
 .TP
+.BR -r
+Reset the internal quota data of the user|group|project quota. It can be used
+to fix the quota containing corrupted internal data (such as, the quota grant).
+.TP
 .BR -u | --user \fIUSERNAME\fR|\fBUID
 Set user quota for \fIUNAME\fR or \fIUID\fR.
 .PP
@@ -127,7 +139,7 @@ Set default project quota limit.
 .B $ lfs setquota -u bob --block-softlimit 2G --block-hardlimit 1G /mnt/lustre
 Set quotas of user `bob': 1GB block hardlimit and 2 GB block softlimit
 .TP
-.B $ lfs setquota -u bob -d /mnt/lustre
+.B $ lfs setquota -u bob -D /mnt/lustre
 Set quotas of user `bob' to use default quota setting
 .TP
 .B $ lfs setquota -U --block-softlimit 1G --block-hardlimit 2G /mnt/lustre
@@ -142,6 +154,18 @@ Set hard block limit 1G for user 'ivan' per pool 'flash_pool'
 .TP
 .B $ lfs setquota -t -u --block-grace 1000 --pool flash_pool /mnt/lustre
 Set grace time 1000 seconds for block quotas per pool 'flash_pool'
+.TP
+.BR "lfs setquota " { -u | -g | -p "} " \fIUID\fR|\fIGID\fR|\fIPROJID\fR " " [\fB--delete\fR] " " <\fIfilesystem\fR>
+Command deletes the unused UID|GID|PROJID from Quota settings.
+.TP
+.PP
+.SH EXAMPLES
+.TP
+.B $ lfs setquota -u bob --delete /mnt/lustre
+Delete unused user 'bob'.
+.TP
+.B $ lfs setquota -u bob -r /mnt/lustre
+Reset the user 'bob'.
 .SH SEE ALSO
 .BR lfs (1),
 .BR lfs-quota(1)