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