LU-14071 doc: lfs setquota/quota doc for PQ

Add description of key --pool for lfs setquota
and lfs quota.

Change-Id: Ie6bfb3240f7eb8b4239d95aac29989103f009578
Test-Parameters: trivial
HPE-bug-id: LUS-9341
Signed-off-by: Sergey Cheremencev <sergey.cheremencev@hpe.com>
Reviewed-on: https://review.whamcloud.com/40384
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: Maloo <maloo@whamcloud.com>

diff --git a/lustre/doc/lfs-quota.1 b/lustre/doc/lfs-quota.1
index 0e74700..e8abe6b 100644 (file)
--- a/lustre/doc/lfs-quota.1
+++ b/lustre/doc/lfs-quota.1
@@ -6,6 +6,7 @@ lfs quota \- display quota limits and status for users, groups, or projects.
        [\fB-o <\fIobd_uuid\fR>|\fB-I <\fIost_idx\fR>|\fB-i <\fImdt_idx\fR>]
        [\fB-u <\fIuname\fR|\fIuid\fR>|\fB-g <\fIgname\fR|\fIgid\fR>\
 |\fB-p <\fIprojid\fR>]
        [\fB-o <\fIobd_uuid\fR>|\fB-I <\fIost_idx\fR>|\fB-i <\fImdt_idx\fR>]
        [\fB-u <\fIuname\fR|\fIuid\fR>|\fB-g <\fIgname\fR|\fIgid\fR>\
 |\fB-p <\fIprojid\fR>]

+       [\fB--pool\fR <\fIpname\fR>]

        <\fIfilesystem\fR>\fR
 
 .br
        <\fIfilesystem\fR>\fR
 
 .br


@@ -67,6 +68,9 @@ Display project quota information for \fImdt_idx\fR.
 .B -I <\fIost_idx\fR>
 Display project quota information for \fIost_idx\fR.
 .TP
 .B -I <\fIost_idx\fR>
 Display project quota information for \fIost_idx\fR.
 .TP

+.B --pool <\fIpname\fR>
+Display quota information per OST pool \fIpname\fR.
+.TP

 .B lfs quota \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
 .TP
 Display default quota values for users, groups, or projects. \
 .B lfs quota \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
 .TP
 Display default quota values for users, groups, or projects. \


@@ -81,7 +85,7 @@ Display default group quota information for name <\fIfilesystem\fR>.
 .B -P <\fIprojid\fR>
 Display default project quota information for <\fIfilesystem\fR>.
 .TP
 .B -P <\fIprojid\fR>
 Display default project quota information for <\fIfilesystem\fR>.
 .TP

-.B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
+.B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> [\fB--pool\fR <\fIpname\fR>] <\fIfilesystem\fR>

 .TP
 Display grace times for users, groups, or projects. \
 The format is always "XXwXXdXXhXXmXXs".
 .TP
 Display grace times for users, groups, or projects. \
 The format is always "XXwXXdXXhXXmXXs".


@@ -95,6 +99,9 @@ Display default group grace times for name <\fIfilesystem\fR>.
 .B -p <\fIprojid\fR>
 Display default project grace times for <\fIfilesystem\fR>.
 .TP
 .B -p <\fIprojid\fR>
 Display default project grace times for <\fIfilesystem\fR>.
 .TP

+.B --pool <\fIpname\fR>
+Display user, group or project grace times per OST pool \fIpname\fR.
+.TP

 .SH EXAMPLES
 .TP
 .B $ lfs quota /mnt/lustre
 .SH EXAMPLES
 .TP
 .B $ lfs quota /mnt/lustre


@@ -109,6 +116,12 @@ Display default user quotas
 .B $ lfs quota -t -u /mnt/lustre
 Display grace times for user quotas on /mnt/lustre
 .TP
 .B $ lfs quota -t -u /mnt/lustre
 Display grace times for user quotas on /mnt/lustre
 .TP

+.B $ lfs quota -u ivan --pool flash_pool /mnt/lustre
+Display quotas and usage for user 'ivan' per 'flash_pool"
+.TP
+.B $ lfs quota -t -g --pool flash_pool /mnt/lustre
+Display grace times for group quotas per 'flash_pool"
+.TP

 .SH SEE ALSO
 .BR lfs (1),
 .BR lfs-setquota(1)
 .SH SEE ALSO
 .BR lfs (1),
 .BR lfs-setquota(1)

diff --git a/lustre/doc/lfs-setquota.1 b/lustre/doc/lfs-setquota.1
index 620c841..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>
 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--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
        [\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 -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
 .B -d|--default
 Set user/group/project to use the default quota limits.
 .TP


@@ -92,6 +97,9 @@ Specify grace time for block quota.
 .TP
 .B -i|--inode-grace 'notify'|<\fIinode-grace\fR>
 Specify grace time for inode quota.
 .TP
 .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
 .PP
 .BR "lfs setquota " {\fB-U|--default-usr|-G|--default-grp|-P|--default-prj\fR}
 .TP


@@ -123,6 +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
 .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-quota(1)
 .SH SEE ALSO
 .BR lfs (1),
 .BR lfs-quota(1)