LFS-QUOTA(1)

📦 version 2.17.58, in ubuntu stonking

🎀 NAME 🎀

lfs-quota — your girl that shows off quota limits and status for users, groups, or projects 💖 (you're reading the lfs-quota page from section 1 of the Lustre User Utilities manual, bestie, and yes it's giving iconic 👑)

🦋 SYNOPSIS 🦋

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

💅 DESCRIPTION 💅

lfs quota [MOUNT_POINT ...]

okay so bestie, this one shows you disk usage and limits for individual users, groups, and projects, for each MOUNT_POINT you point it at 🫶. There's an asterisk that pops up when the quota is exceeded — like a lil warning flag 🚩. By default you get the stats for the entire filesystem, but if you're nosy and want individual MDTs and OSTs, you use the --ost or --mdt options. You can also specify a user, group, or project ID. And if user, group, and project are all omitted? Then it shows quotas for the current uid/gid/projid — very main character of it honestly 😌. And if no MOUNT_POINT is specified, you get quotas for all Lustre mountpoints. all of them. periodt ✨

lfs quota {-U|-G|-P} [MOUNT_POINT ...]

This variant displays the default quota values for users, groups, or projects. Heads up tho: this command requires superuser permissions 🔐 (root energy only, sorry).

lfs quota -a {-u|-g|-p} [-n] [--show-root] [MOUNT_POINT ...]

This one displays disk usage and limits for all users, groups, or projects that exist across all mounted filesystems 🌈. -n displays 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, and --show-root displays the root quota entry. 💅

lfs quota -t {-u|-g|-p} [MOUNT_POINT ...]

Grace times, babes ⏳ — displays grace times for users, groups, or projects. Time values use the "XXwXXdXXhXXmXXs" format, which is weeks, days, hours, minutes, seconds. iykyk 🕰️

✨ OPTIONS ✨

  • --blocks, --busage, --space, --kbytes — prints only the kbytes/usage column, aka the block space usage. And if you also pass other column options, then all the specified columns get printed together, no gatekeeping 💖
  • --block-softlimit, --bsoftlimit — prints only the bquota column, aka the block soft-limit. Other column options specified? All of them print 🌸
  • --block-hardlimit, --bhardlimit — prints only the blimit column, aka the block hard-limit. Same deal: if other column options are specified, all specified columns print 🔥
  • --blocks-grace, --bgrace, --btime — prints only the bgrace column, aka the block grace time. You already know — other column options get printed too 🎀
  • -d, --delimiter=DELIMITER — uses the string DELIMITER as the column delimiter. This makes parsing the output way easier, and you could literally use it to put the output into CVS format for a spreadsheet 📊 (girlboss move)
  • --filesystem, --mount-point — prints 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 changes the formatting of block storage and time values. Without it, block storage values are in kilobytes and times are in seconds. With it, 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. no cap, your eyes will thank you 👀
  • --inodes, --iusage, --files — prints only the files column, aka the number of inodes used. Other column options specified → all specified columns print 💜
  • --inode-softlimit, --isoftlimit — prints only the iquota column, aka the inode soft-limit. Yep, other column options print too ⭐
  • --inode-hardlimit, --ihardlimit — prints only the ilimit column, aka the inode hard-limit. Other column options still print 🌟
  • --ilocks-grace, --igrace, --itime — prints only the igrace column, aka the inode grace time. And yes bestie, other column options print as well 🌸
  • -q, --quiet — does NOT display the table or column headers. Everything else still gets printed tho, so it's not fully quiet, it's just quiet-coded 🤫

SINGLE QUOTA

These options are only available when none of -a, -t, -U, -G, and -P are specified. read the room, pick one vibe 💅

  • -g, --group {GROUP|GID} — displays quota information for group name GROUP or numeric GID. You can use it without specifying the mount point to get quota info from all filesystems for the specified GROUP|GID 🌈
  • -m, --mdt MDT_IDX — displays quota information for MDT MDT_IDX 🧚
  • -o, --ost OST_IDX — displays quota information for OST OST_IDX 🧚
  • --pool POOL_NAME — displays quota information for OST pool POOL_NAME 🏊
  • -p, --projid {PROJECT|PROJID} — displays quota information for project PROJID|PROJNAME. You can drop a username or group name in place of PROJNAME by specifying u:USERNAME or user:USERNAME or g:GROUPNAME or group:GROUPNAME respectively — tho just so you know, that 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. 👑
  • -u, --user {USER|UID} — displays 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 — displays per-MDT and per-OST statistics in addition to the usual system wide data. An asterisk near the OST or MDT means 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 targets will also be printed, but marked as "inact". 💀

ALL QUOTA

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

  • -e, --end-qidEND_QID — specifies 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 — specifies 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. 🚀
  • --show-root — displays the root quota entry. By default, it's skipped 🙈 (root was being shy)

DEFAULT QUOTA

  • -G, --default-grp — displays the default group quota limit 💜
  • -P, --default-prj — displays the default project quota limit 🎀
  • -U, --default-usr — displays the default user quota limit 🫶
  • --pool POOL_NAME — displays 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 has been part of the lustre(7) filesystem package since release 1.7.0 — she's been around, she's a legacy icon 👑

👀 SEE ALSO 👀

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

and that's the whole page bestie!! 💖 this one's from the Lustre crew, dated 2026-08-18, and it lives in section 1 of the manual. go check your quotas, you're literally glowing ✨🎀🦋

📦 where this page comes from