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        <\fIfilesystem\fR>\fR
  10
  11 .br
  12 .B lfs quota \fR[\fB-hq\fR] \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
  13 .br
  14
  15 .br
  16 .B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
  17 .br
  18
  19 .TP
  20 .SH DESCRIPTION
  21 .PP
  22 .B lfs quota <\fIfilesystem\fR>\fR
  23 .TP
  24
  25 Display disk usage and limits for individual users, groups, and projects. \
  26 By default the statistics for the entire filesystem are displayed but \
  27 individual MDTs and OSTs can be specified. \
  28 A user or group name or an ID can \
  29 be specified. If user, group and project are omitted, quotas for \
  30 current uid/gid/projid are shown.
  31 .TP
  32 .B -h
  33 Human readable. This will change the formatting of \
  34 block storage and time values. Without this option block storage values \
  35 are in kilobytes and times are in seconds. With this option block storage \
  36 values use the common metric binary suffixes
  37 .BR k "," M "," G "," T "," P "," E
  38 which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 \
  39 respectively.
  40 Time values use the "XXwXXdXXhXXmXXs" format. This format specifies \
  41 weeks, days, hours, minutes, seconds.
  42 .TP
  43 .B -q
  44 Quiet. Display only the line containing the data. \
  45 The line saying what the data is, and the line with the data
  46 column headers will not be printed.
  47 .TP
  48 .B -v
  49 Verbose. Display per-MDT and per-OST statistics in addition
  50 to the usual system wide data.
  51 .TP
  52 .B -u <\fIuname|uid\fR>
  53 Display user quota information for \fIuname\fR or \fIuid\fR.
  54 .TP
  55 .B -g <\fIgname|gid\fR>
  56 Display group quota information for name \fIgname\fR or \fIgid\fR.
  57 .TP
  58 .B -p <\fIprojid\fR>
  59 Display project quota information for \fIprojid\fR.
  60 .TP
  61 .B -o <\fIobd_uuid\fR>
  62 Display quota information for \fIobd_uuid\fR.
  63 .TP
  64 .B -i <\fImdt_idx\fR>
  65 Display project quota information for \fImdt_idx\fR.
  66 .TP
  67 .B -I <\fIost_idx\fR>
  68 Display project quota information for \fIost_idx\fR.
  69 .TP
  70 .B lfs quota \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
  71 .TP
  72 Display default quota values for users, groups, or projects. \
  73 This command requires super user permissions.
  74 .TP
  75 .B -U <\fIuname|uid\fR>
  76 Display default user quota information for <\fIfilesystem\fR>.
  77 .TP
  78 .B -G <\fIgname|gid\fR>
  79 Display default group quota information for name <\fIfilesystem\fR>.
  80 .TP
  81 .B -P <\fIprojid\fR>
  82 Display default project quota information for <\fIfilesystem\fR>.
  83 .TP
  84 .B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
  85 .TP
  86 Display grace times for users, groups, or projects. \
  87 The format is always "XXwXXdXXhXXmXXs".
  88 .TP
  89 .B -u <\fIuname|uid\fR>
  90 Display default user grace times for <\fIfilesystem\fR>.
  91 .TP
  92 .B -g <\fIgname|gid\fR>
  93 Display default group grace times for name <\fIfilesystem\fR>.
  94 .TP
  95 .B -p <\fIprojid\fR>
  96 Display default project grace times for <\fIfilesystem\fR>.
  97 .TP
  98 .SH EXAMPLES
  99 .TP
 100 .B $ lfs quota /mnt/lustre
 101 Display quotas and usage for current user, group, and project
 102 .TP
 103 .B $ lfs quota -u bob /mnt/lustre
 104 Display quotas and usage for user 'bob'
 105 .TP
 106 .B $ lfs quota -U /mnt/lustre
 107 Display default user quotas
 108 .TP
 109 .B $ lfs quota -t -u /mnt/lustre
 110 Display grace times for user quotas on /mnt/lustre
 111 .TP
 112 .SH SEE ALSO
 113 .BR lfs (1),
 114 .BR lfs-setquota(1)