Q_XGETQSTAT(2const)

💖 Q_XGETQSTAT — the manual, bestie edition 💖

okay so this is Q_XGETQSTAT, and it lives in section 2const of the Linux manual pages. it's a quota command constant, it's iconic, and it's about to spill all the XFS tea. let's go 🦋

---

✨ NAME ✨

Q_XGETQSTAT — get XFS-specific quota information 💅

---

📚 LIBRARY 📚

Standard C library (libc, -lc) — the classics, no cap.

---

🎀 SYNOPSIS 🎀

okay so there's literally more than one way to call this, here's all of them exactly as they are:

#include <xfs/xqm.h>      /* See quotactl(2) */
#include <sys/quota.h>

int quotactl(QCMD(Q_XGETQSTAT, type), const char *_Nullable special, 0,
             caddr_t addr);

#include <xfs/xqm.h>      /* See quotactl_fd(2) */
#include <sys/syscall.h>  /* Definition of SYS_* constants */
#include <unistd.h>

int syscall(SYS_quotactl_fd, int fd, QCMD(Q_XGETQSTAT, type), 0,
            struct fs_quota_stat *addr);

and here's the constant plus the structs it hands you, verbatim, do not touch:

#include <xfs/xqm.h>      /* See quotactl(2) */

#define FS_QSTAT_VERSION  1  /* fs_quota_stat.qs_version */

struct fs_quota_stat {
     int8_t    qs_version;
     uint16_t  qs_flags;
     int8_t    qs_pad;
     struct fs_qfilestat  qs_uquota;
     struct fs_qfilestat  qs_gquota;
     uint32_t  qs_incoredqs;
     int32_t   qs_btimelimit;
     int32_t   qs_itimelimit;
     int32_t   qs_rtbtimelimit;
     uint16_t  qs_bwarnlimit;
     uint16_t  qs_iwarnlimit;
};

struct fs_qfilestat {
     uint64_t  qfs_ino;
     uint64_t  qfs_nblks;
     uint32_t  qfs_nextents;
};

---

🌸 DESCRIPTION 🌸

so basically it returns XFS filesystem-specific quota information, and it drops all of that into the fs_quota_stat structure that addr points at. simple, clean, slay ✨

it's giving detective energy, because it's useful for finding out how much space is used to store quota information, and also for getting the quota on/off status of a given local XFS filesystem. like, hi, what's your status bestie 💖

🧚 struct fs_quota_stat

• .qs_version — version number for future changes. it's the little time capsule of versions, lowkey.
• .qs_flags — XFS_QUOTA_{U,P,G}DQ_{ACCT,ENFD} 👑
• .qs_pad — unused. it's just vibing there, taking up space, doing nothing. respect honestly.
• .qs_uquota — user quota storage information.
• .qs_gquota — group quota storage information.
• .qs_incoredqs — number of dquots in core.
• .qs_btimelimit — limit for blocks timer.
• .qs_itimelimit — limit for inodes timer.
• .qs_rtbtimelimit — limit for RT blocks timer.
• .qs_bwarnlimit — limit for # of warnings.
• .qs_iwarnlimit — limit for # of warnings.

🧚 struct fs_quota_stat (the file-stat one, yes it has the same heading as the original, i don't make the rules)

• .qfs_ino — inode number.
• .qfs_nblks — number of BBs 512-byte-blocks.
• .qfs_nextents — number of extents.

---

🔥 RETURN VALUE 🔥

See quotactl(2). that's it, that's the whole section. go read the other one bestie 🫶

---

💀 ERRORS 💀

See quotactl(2). same deal, the source of truth is over there ✨

---

🌈 STANDARDS 🌈

Linux. periodt.

---

📜 HISTORY 📜

Linux. also periodt.

---

👑 SEE ALSO 👑

• quotactl(2)
• quotactl_fd(2)
• Q_XGETQSTATV(2const)

---

aaaand that's the whole page bestie, you ate it 🍓 this was Linux man-pages 6.20, dated 2026-06-05, and it's the Q_XGETQSTAT(2const) page — go forth and stat your quotas, no cap 💅✨