lustre/doc/lfs-quota.1

   1 .TH LFS-QUOTA 1 2020-04-06 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs-quota \- display quota limits and status for users, groups, or projects.
   4 .SH SYNOPSIS
   5 .B lfs quota \fR[\fB-hqv\fR]
   6        [\fB-o <\fIobd_uuid\fR>|\fB-I <\fIost_idx\fR>|\fB-i <\fImdt_idx\fR>]
   7        [\fB-u <\fIuname\fR|\fIuid\fR>|\fB-g <\fIgname\fR|\fIgid\fR>\
   8 |\fB-p <\fIprojid\fR>]
   9        [\fB--pool\fR <\fIpname\fR>]
  10        <\fIfilesystem\fR>\fR
  11
  12 .br
  13 .B lfs quota \fR[\fB-hq\fR] \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
  14 .br
  15
  16 .br
  17 .B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
  18 .br
  19
  20 .br
  21 .B lfs quota -a \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
  22 .br
  23
  24 .TP
  25 .SH DESCRIPTION
  26 .PP
  27 .B lfs quota <\fIfilesystem\fR>\fR
  28 .TP
  29
  30 Display disk usage and limits for individual users, groups, and projects. \
  31 An asterisk is displayed when the quota is exceeded. \
  32 By default the statistics for the entire filesystem are displayed but \
  33 individual MDTs and OSTs can be specified. \
  34 A user or group name or an ID can \
  35 be specified. If user, group and project are omitted, quotas for \
  36 current uid/gid/projid are shown.
  37 .TP
  38 .B -h
  39 Human readable. This will change the formatting of \
  40 block storage and time values. Without this option block storage values \
  41 are in kilobytes and times are in seconds. With this option block storage \
  42 values use the common metric binary suffixes
  43 .BR k "," M "," G "," T "," P "," E
  44 which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 \
  45 respectively.
  46 Time values use the "XXwXXdXXhXXmXXs" format. This format specifies \
  47 weeks, days, hours, minutes, seconds.
  48 .TP
  49 .B -q
  50 Quiet. Display only the line containing the data. \
  51 The line saying what the data is, and the line with the data
  52 column headers will not be printed.
  53 .TP
  54 .B -v
  55 Verbose. Display per-MDT and per-OST statistics in addition
  56 to the usual system wide data. An asterisk near the OST or MDT means that
  57 the quota is exceeded only for that specific target. The user is over the
  58 quota only if an asterisk is near the whole filesystem usage.
  59 Inactive target will also be printed but marked as "inact".
  60 .TP
  61 .B -u <\fIuname|uid\fR>
  62 Display user quota information for \fIuname\fR or \fIuid\fR.
  63 .TP
  64 .B -g <\fIgname|gid\fR>
  65 Display group quota information for name \fIgname\fR or \fIgid\fR.
  66 .TP
  67 .B -p <\fIprojid\fR>
  68 Display project quota information for \fIprojid\fR.
  69 .TP
  70 .B -o <\fIobd_uuid\fR>
  71 Display quota information for \fIobd_uuid\fR.
  72 .TP
  73 .B -i <\fImdt_idx\fR>
  74 Display project quota information for \fImdt_idx\fR.
  75 .TP
  76 .B -I <\fIost_idx\fR>
  77 Display project quota information for \fIost_idx\fR.
  78 .TP
  79 .B --pool <\fIpname\fR>
  80 Display quota information per OST pool \fIpname\fR.
  81 .TP
  82 .B lfs quota \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
  83 .TP
  84 Display default quota values for users, groups, or projects. \
  85 This command requires super user permissions.
  86 .TP
  87 .B -U <\fIuname|uid\fR>
  88 Display default user quota information for <\fIfilesystem\fR>.
  89 .TP
  90 .B -G <\fIgname|gid\fR>
  91 Display default group quota information for name <\fIfilesystem\fR>.
  92 .TP
  93 .B -P <\fIprojid\fR>
  94 Display default project quota information for <\fIfilesystem\fR>.
  95 .TP
  96 .B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> [\fB--pool\fR <\fIpname\fR>] <\fIfilesystem\fR>
  97 .TP
  98 Display grace times for users, groups, or projects. \
  99 The format is always "XXwXXdXXhXXmXXs".
 100 .TP
 101 .B -u <\fIuname|uid\fR>
 102 Display default user grace times for <\fIfilesystem\fR>.
 103 .TP
 104 .B -g <\fIgname|gid\fR>
 105 Display default group grace times for name <\fIfilesystem\fR>.
 106 .TP
 107 .B -p <\fIprojid\fR>
 108 Display default project grace times for <\fIfilesystem\fR>.
 109 .TP
 110 .B --pool <\fIpname\fR>
 111 Display user, group or project grace times per OST pool \fIpname\fR.
 112 .TP
 113 .B lfs quota -a \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
 114 .TP
 115 Display all quota setting for all users, groups, or projects.
 116 .TP
 117 .SH EXAMPLES
 118 .TP
 119 .B $ lfs quota /mnt/lustre
 120 Display quotas and usage for current user, group, and project
 121 .TP
 122 .B $ lfs quota -u bob /mnt/lustre
 123 Display quotas and usage for user 'bob'
 124 .TP
 125 .B $ lfs quota -U /mnt/lustre
 126 Display default user quotas
 127 .TP
 128 .B $ lfs quota -t -u /mnt/lustre
 129 Display grace times for user quotas on /mnt/lustre
 130 .TP
 131 .B $ lfs quota -u ivan --pool flash_pool /mnt/lustre
 132 Display quotas and usage for user 'ivan' per 'flash_pool"
 133 .TP
 134 .B $ lfs quota -t -g --pool flash_pool /mnt/lustre
 135 Display grace times for group quotas per 'flash_pool"
 136 .TP
 137 .SH SEE ALSO
 138 .BR lfs (1),
 139 .BR lfs-setquota(1)