OS Manuals

lfs-quota(1)

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

LFS-QUOTA(1) Lustre User Utilities LFS-QUOTA(1)

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

lfs quota [--blocks|--busage|--space] [--block-softlimit|--bsoftlimit] [--block-hardlimit|--bhardlimit] [--block-grace|--bgrace|--btime] [-d|--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] [--show-root] [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.
Display default quota values for users, groups, or projects. This command requires superuser permissions.
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. --show-root display root quota entry.
Display grace times for users, groups, or projects. Time values use the "XXwXXdXXhXXmXXs" format, which specifies weeks, days, hours, minutes, seconds.

Print only the kbytes/usage column representing the block space usage. If other column options are specified, all specified columns will be printed.
Print only the bquota column representing the block soft-limit. If other column options are specified, all specified columns will be printed.
Print only the blimit column representing the block hard-limit. If other column options are specified, all specified columns will be printed.
Print only the bgrace column representing the block grace time. If other column options are specified, all specified columns will be printed.
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.
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.
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.
Print only the files column representing the number of inodes used. If other column options are specified, all specified columns will be printed.
Print only the iquota column representing the inode soft-limit. If other column options are specified, all specified columns will be printed.
Print only the ilimit column representing the inode hard-limit. If other column options are specified, all specified columns will be printed.
Print only the igrace column representing the inode grace time. If other column options are specified, all specified columns will be printed.
Do not display the table or column headers, all other information will be printed.

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

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.
Display quota information for MDT MDT_IDX.
Display quota information for OST OST_IDX.
Display quota information for OST pool POOL_NAME.
Display quota information for project PROJID|PROJNAME. A username or group name can be used in place of PROJNAME by specifying u:USERNAME or user:USERNAME or g:GROUPNAME or group:GROUPNAME respectively, though this name will not be shown in place of the numeric ID. This can be used without specifying the mount point to get quota information from all filesystems for the specified PROJID.
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.
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".

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

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.
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.
Display root quota entry. By default, it is skipped.

Display default group quota limit.
Display default project quota limit.
Display default user quota limit.
Display default quota information for OST pool POOL_NAME.

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,      -

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

lfs(1), lfs-project(1), lfs-setquota(1), projid(5)

2026-08-18 Lustre

lustre 2.17.59-r2 · enterprise-packages · ingested 2026-10-11