LU-11776 utils: add support lfs find with mdt hash flag

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

diff --git a/lustre/doc/lfs-setquota.1 b/lustre/doc/lfs-setquota.1
index 1bd6ca6..42542d2 100644 (file)
--- a/lustre/doc/lfs-setquota.1
+++ b/lustre/doc/lfs-setquota.1
@@ -3,12 +3,14 @@
 lfs setquota \- set quota limits or grace time for users, groups or projects.
 .SH SYNOPSIS
 .B lfs setquota {\fB-u|--user|-g|--group|-p|--projid\fR} <\fIuname|uid|gname|gid|projid\fR>
+       [\fB--pool\fR <\fIpname\fR>]
        [\fB--block-softlimit|-b\fR <\fIblock-softlimit\fR>[kMGTPE]]
        [\fB--block-hardlimit|-B\fR <\fIblock-hardlimit\fR>[kMGTPE]]
        [\fB--inode-softlimit|-i\fR <\fIinode-softlimit\fR>[kMGTPE]]
        [\fB--inode-hardlimit|-I\fR <\fIinode-hardlimit\fR>[kMGTPE]] <\fIfilesystem\fR>
 .TP
 .B lfs setquota \fB-t\fR {\fB-u|-g|-p\fR}
+       [\fB--pool\fR <\fIpname\fR>]
        [\fB--block-grace|-b\fR <\fIblock-grace\fR>]
        [\fB--inode-grace|-i\fR <\fIinode-grace\fR>] <\fIfilesystem\fR>
 .TP
@@ -42,6 +44,9 @@ Set group quota for name \fIgname\fR or \fIgid\fR.
 .B -p|--project <\fIprojid\fR>
 Set project quota for \fIprojid\fR.
 .TP
+.B --pool <\fIpname\fR>
+Set quota per OST pool \fIpname\fR.
+.TP
 .B -d|--default
 Set user/group/project to use the default quota limits.
 .TP
@@ -62,14 +67,18 @@ greater than inode softlimit when it's being specified.
 .BR "lfs setquota -t "
 .TP
 Command sets the filesystem quota grace time for users, groups, or projects. \
-This is a global value that indicates the amount of time, in seconds, that the \
-soft quota limit can be exceeded before users are prevented from creating \
-new files or consuming more space.  This is intended to allow users to exceed \
-the quota limit for a short time to complete their work, without having to \
-grant each user a larger hard quota limit.  The soft quota limit is reset once \
-the user, group, or project reduces their space usage below the soft quota \
-limit. Grace time is specified in "XXwXXdXXhXXmXXs" format or as an integer \
-seconds value, and the maximum is 2^48 - 1 seconds.
+This is a global value that can take two forms: an amount of time or the word \
+\'\fBnotify\fR'.  Traditionally, this indicates the amount of time in seconds \
+that the soft quota limit can be exceeded before users are prevented from \
+creating new files or consuming more space.  This is intended to allow users \
+to exceed the quota limit for a short time to complete their work without \
+having to grant each user a larger hard quota limit. The alternative value of \
+\'\fBnotify\fR' informs users with an '\fB*\fR' in the quota output that they \
+are nearing their hard quota limit but does not block new writes until the hard \
+quota limit is reached.  The soft quota state is reset once the user, group, \
+or project reduces their space usage or file count below the soft quota limit. \
+Grace time is specified in "XXwXXdXXhXXmXXs" format or as an integer seconds \
+value.  The maximum is 2^48 - 1 seconds.
 .TP
 .B -t
 Set quota grace times.
@@ -83,11 +92,14 @@ Set grace time for group.
 .B -p
 Set grace time for project.
 .TP
-.B -b|--block-grace <\fIblock-grace\fR>
+.B -b|--block-grace 'notify'|<\fIblock-grace\fR>
 Specify grace time for block quota.
 .TP
-.B -i|--inode-grace <\fIindoe-grace\fR>
+.B -i|--inode-grace 'notify'|<\fIinode-grace\fR>
 Specify grace time for inode quota.
+.TP
+.B --pool <\fIpname\fR>
+Set grace time for user, group or project per OST pool \fIpname\fR.
 .PP
 .BR "lfs setquota " {\fB-U|--default-usr|-G|--default-grp|-P|--default-prj\fR}
 .TP
@@ -119,5 +131,12 @@ Set system default user quota: 1 GB block softlimit and 2 GB block hardlimit
 .B $ lfs setquota -t -u --block-grace 1000 --inode-grace 1w4d /mnt/lustre
 Set grace times for user quotas: 1000 seconds for block quotas, 1 week and 4 \
 days for inode quotas
+.TP
+.B $ lfs setquota -u ivan --pool flash_pool -B 1G /mnt/lustre
+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'
 .SH SEE ALSO
-.BR lfs (1)
+.BR lfs (1),
+.BR lfs-quota(1)