LFS-QUOTA(1)

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

SYNOPSIS
lfs quota [--blocks|--busage|--space] [--block-softlimit|--bsoftlimit] [--block-hardlimit|--bhardlimit] [--block-grace|--bgrace|--btime] [--delimiter DELIMITER] [--filesystem|--mount-point] [-h|--human-readable] [--inodes|--iusage] [--inode-softlimit|--isoftlimit] [--inode-hardlimit|--ihardlimit] [--inode-grace|--igrace|--itime] [{-o|--ost OBD_UUID|OST_IDX }|{-m|--mdt MDT_IDX}] [--pool OST_POOL_NAME] [-q|--quiet] [{-u|--user USER}|{ -g|--group GROUP}|{ -p|--projid PROJID}] [-v|--verbose] [MOUNT_POINT ...]
lfs quota {-U|--default-usr|-G|--default-grp|-P|--default-prj} [MOUNT_POINT ...]
lfs quota -t|--times {-u|-g|-p} [MOUNT_POINT ...]
lfs quota -a|--all {-u|-g|-p} [-n] [-s START_QID] [-e END_QID] [MOUNT_POINT ...]

DESCRIPTION

lfs quota [MOUNT_POINT ...]
    Display disk usage and limits for individual users, groups, and projects for each MOUNT_POINT. 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 with the --ost or --mdt options. A user, group, or project ID can be specified. If user, group, and project are omitted, quotas for the current uid/gid/projid are shown. If no MOUNT_POINT is specified, quotas for all Lustre mountpoints will be shown.

lfs quota {-U|-G|-P} [MOUNT_POINT ...]
    Display default quota values for users, groups, or projects. This command requires superuser permissions.

lfs quota -a {-u|-g|-p} [-n] [MOUNT_POINT ...]
    Display disk usage and limits for all users, groups, or projects that exist across all mounted filesystems. -n display the numeric value of the quota IDs instead of its name --start-qid and --end-qid display the value of the quota IDs only in the select range.

lfs quota -t {-u|-g|-p} [MOUNT_POINT ...]
    Display grace times for users, groups, or projects. Time values use the "XXwXXdXXhXXmXXs" format, which specifies weeks, days, hours, minutes, seconds.

OPTIONS

--blocks, --busage, --space, --kbytes
    Print only the kbytes/usage column representing the block space usage. If other column options are specified, all specified columns will be printed.

--block-softlimit, --bsoftlimit
    Print only the bquota column representing the block soft-limit. If other column options are specified, all specified columns will be printed.

--block-hardlimit, --bhardlimit
    Print only the blimit column representing the block hard-limit. If other column options are specified, all specified columns will be printed.

--blocks-grace, --bgrace, --btime
    Print only the bgrace column representing the block grace time. If other column options are specified, all specified columns will be printed.

-d, --delimiter=DELIMITER
    Use the string DELIMITER as the column delimiter. This allows for easier parsing of the output, and could be used to put the output into CVS format for a spreadsheet.

--filesystem, --mount-point
    Print only the filesystem column representing either the mount point or device name. If other column options are specified, all specified columns will be printed.

-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, and E which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 bytes, respectively.

--inodes, --iusage, --files
    Print only the files column representing the number of inodes used. If other column options are specified, all specified columns will be printed.

--inode-softlimit, --isoftlimit
    Print only the iquota column representing the inode soft-limit. If other column options are specified, all specified columns will be printed.

--inode-hardlimit, --ihardlimit
    Print only the ilimit column representing the inode hard-limit. If other column options are specified, all specified columns will be printed.

--ilocks-grace, --igrace, --itime
    Print only the igrace column representing the inode grace time. If other column options are specified, all specified columns will be printed.

-q, --quiet
    Do not display the table or column headers, all other information will be printed.

  SINGLE QUOTA
The following options are only available when none of -a, -t, -U, -G, and -P are specified.

-g, --group {GROUP|GID}
    Display quota information for group name GROUP or numeric GID. Can be used without specifying the mount point to get quota information from all filesystems for the specified GROUP|GID.

-m, --mdt MDT_IDX
    Display quota information for MDT MDT_IDX.

-o, --ost OST_IDX
    Display quota information for OST OST_IDX.

--pool POOL_NAME
    Display quota information for OST pool POOL_NAME.

-p, --projid {PROJECT|PROJID}
    Display quota information for project PROJID|PROJNAME. A username or group name can be used in place of PROJNAME by specifying u:USERNAME or g:GROUPNAME respectively. Can be used without specifying the mount point to get quota information from all filesystems for the specified PROJID.

-u, --user {USER|UID}
    Display quota information for user name USER or numeric UID. Can be used without specifying the mount point to get quota information from all filesystems for the specified USER|UID.

-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".

  ALL QUOTA
These options are only available when -a|--all is specified.

-e, --end-qidEND_QID
    Specify the end of a range for qids to be shown. If START_QID is not specified then the range will go from 0 to END_QID.

-s, --start-qid START_QID
    Specify the start of a range for qids to be shown. If END_QID is not specified then the range will go from START_QID until the qid with the highest value is printed.

  DEFAULT QUOTA

-G, --default-grp {GROUP|GID}
    Display default quota limits for group name GROUP or numeric GID.

-P, --default-prj {PROJECT|PROJID}
    Display default quota limits for project PROJID or PROJNAME as listed in /etc/projid(5).

-U|--default-usr {USER|UID}
    Display default quota limits for username USER or numeric UID.

--pool POOL_NAME
    Display default quota information for OST pool POOL_NAME.

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

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

Display default user quotas:
    # lfs quota -U /mnt/lustre

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

Display quotas and usage for user ivan from the OST pool flash_pool:
    # lfs quota -u ivan --pool flash_pool /mnt/lustre

Display grace times for group quotas for the OST pool flash_pool:
    $ lfs quota -t -g --pool flash_pool /mnt/lustre

Display only the filesystem blocks and inodes columns:
    $ lfs quota --filesystem --blocks --inodes
    Disk quotas for usr root (uid 0):
          Filesystem   kbytes   files
         /mnt/lustre     5236     308
        /mnt/lustre2     5236     308
    Disk quotas for grp root (gid 0):
          Filesystem   kbytes   files
         /mnt/lustre     5236     308
        /mnt/lustre2     5236     308

Change the delimiter to make the table available in CVS format:
    $ lfs quota --delimiter="," /mnt/lustre
    Disk quotas for usr root (uid 0):
          Filesystem, kbytes, bquota, blimit, bgrace,  files, iquota, ilimit, igrace
         /mnt/lustre,   4360,      0,      0,      -,    265,      0,      0,      -
    Disk quotas for grp root (gid 0):
          Filesystem, kbytes, bquota, blimit, bgrace,  files, iquota, ilimit, igrace
         /mnt/lustre,   4360,      0,      0,      -,    265,      0,      0,      -

AVAILABILITY
lfs quota is part of the lustre(7) filesystem package since release 1.7.0

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