LFS-QUOTA(1)

NAME
lfs-quota - display quota limits and status for users, groups, or projects.

SYNOPSIS
lfs quota [-hqv]
       [-o <obd_uuid>|-I <ost_idx>|-i <mdt_idx>]
       [-u <uname|uid>|-g <gname|gid>|-p <projid>]
       [--pool <pname>]
       <filesystem>
lfs quota [-hq] <-U|-G|-P> <filesystem>
lfs quota -t <-u|-g|-p> <filesystem>

DESCRIPTION

lfs quota <filesystem>

Display disk usage and limits for individual users, groups, and projects. An asterisk is displayed when the quota is exceeded. By default the statistics for the entire filesystem are displayed but individual MDTs and OSTs can be specified. A user or group name or an ID can be specified. If user, group and project are omitted, quotas for current uid/gid/projid are shown.

-h  Human readable. This will change the formatting of block storage and time values. Without this option block storage values are in kilobytes and times are in seconds. With this option block storage values use the common metric binary suffixes k,M,G,T,P,E which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 respectively. Time values use the "XXwXXdXXhXXmXXs" format. This format specifies weeks, days, hours, minutes, seconds.

-q  Quiet. Display only the line containing the data. The line saying what the data is, and the line with the data column headers will not be printed.

-v  Verbose. Display per-MDT and per-OST statistics in addition to the usual system wide data. An asterisk near the OST or MDT means that the quota is exceeded only for that specific target. The user is over the quota only if an asterisk is near the whole filesystem usage. Inactive target will also be printed but marked as "inact".

-u <uname|uid>
    Display user quota information for uname or uid.

-g <gname|gid>
    Display group quota information for name gname or gid.

-p <projid>
    Display project quota information for projid.

-o <obd_uuid>
    Display quota information for obd_uuid.

-i <mdt_idx>
    Display project quota information for mdt_idx.

-I <ost_idx>
    Display project quota information for ost_idx.

--pool <pname>
    Display quota information per OST pool pname.

lfs quota <-U|-G|-P> <filesystem>

Display default quota values for users, groups, or projects. This command requires super user permissions.

-U <uname|uid>
    Display default user quota information for <filesystem>.

-G <gname|gid>
    Display default group quota information for name <filesystem>.

-P <projid>
    Display default project quota information for <filesystem>.

lfs quota -t <-u|-g|-p> [--pool <pname>] <filesystem>

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

-u <uname|uid>
    Display default user grace times for <filesystem>.

-g <gname|gid>
    Display default group grace times for name <filesystem>.

-p <projid>
    Display default project grace times for <filesystem>.

--pool <pname>
    Display user, group or project grace times per OST pool pname.

EXAMPLES

$ lfs quota /mnt/lustre
    Display quotas and usage for current user, group, and project

$ lfs quota -u bob /mnt/lustre
    Display quotas and usage for user 'bob'

$ lfs quota -U /mnt/lustre
    Display default user quotas

$ lfs quota -t -u /mnt/lustre
    Display grace times for user quotas on /mnt/lustre

$ lfs quota -u ivan --pool flash_pool /mnt/lustre
    Display quotas and usage for user 'ivan' per 'flash_pool"

$ lfs quota -t -g --pool flash_pool /mnt/lustre
    Display grace times for group quotas per 'flash_pool"

SEE ALSO
lfs(1),
    lfs-setquota(1)