Q_XGETQSTATV(2const)

💖 Q_XGETQSTATV 💖

okay bestie, so this is Q_XGETQSTATV — it gets you the XFS-specific quota info. you know, the good stuff. 🎀

This page lives in the 2const manual, and heads up, Q_XGETQSTATV is part of the Linux man-pages project (that's the Linux man-pages 6.20 situation), and we're rocking a 2026-06-05 date on this bad boy. hold that thought, there's a cute lil sign-off at the bottom. 💅

---

📚 LIBRARY

Standard C library (libc, -lc). the classic. 🫶

---

✨ SYNOPSIS ✨

here's the vibe, three ways to roll up:

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

int quotactl(QCMD(Q_XGETQSTATV, 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_XGETQSTATV, type), 0,
            struct fs_quota_statv *addr);

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

#define FS_QSTATV_VERSION1  1

struct fs_quota_statv {
     int8_t    qs_version;
     uint8_t   qs_pad1;
     uint16_t  qs_flags;
     uint32_t  qs_incoredqs;
     struct fs_qfilestatv  qs_uquota;
     struct fs_qfilestatv  qs_gquota;
     struct fs_qfilestatv  qs_pquota;
     int32_t   qs_btimelimit;
     int32_t   qs_itimelimit;
     int32_t   qs_rtbtimelimit;
     uint16_t  qs_bwarnlimit;
     uint16_t  qs_iwarnlimit;
     uint64_t  qs_pad2[8];
};

struct fs_qfilestatv {
     uint64_t  qfs_ino;
     uint64_t  qfs_nblks;
     uint32_t  qfs_nextents;
     uint32_t  qfs_pad;
};

---

🌸 DESCRIPTION 🌸

So what does this actually DO? It hands you back XFS filesystem-specific quota information, and it drops it into that fs_quota_statv that addr is pointing at. ✨

Now the tea on why this version eats: compared to Q_XGETQSTAT(2const), this one uses a structure with proper versioning support, plus the layout is correct (every single field is naturally aligned) and it's got padding so there's no special compat handling mess. and as if that wasn't enough of a serve, it also gives you the ability to get statistics about the project quota file. periodt. 💅

🧚 struct fs_quota_statv

• .qs_version — you gotta fill this in yourself with the version of the structure that the callee supports. for now, only FS_QSTAT_VERSION1 is supported, that's the whole menu. the kernel will fill the structure in accordance with the version you provided. 👑
• .qs_pad1 — padding, for 16-bit alignment. it's just holding space, not the main character.
• .qs_flags — the XFS_QUOTA_* flags.
• .qs_incoredqs — number of dquots incore.
• .qs_uquota — user quota information.
• .qs_gquota — group quota information.
• .qs_pquota — project quota information.
• .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.
• .qs_pad2 — for future proofing. it's giving forward-thinking icon. 🔮

🦋 struct fs_qfilestatv

• .qfs_ino — inode number.
• .qfs_nblks — number of BBs 512-byte-blocks.
• .qfs_nextents — number of extents.
• .qfs_pad — padding, for 8-byte alignment.

---

⭐ RETURN VALUE ⭐

See quotactl(2). (yeah bestie, it's a cross-reference situation, go peek over there 😌)

---

💀 ERRORS 💀

See quotactl(2). same deal. 🔥

---

🌈 STANDARDS 🌈

Linux. that's it, that's the standard. no cap.

---

👑 HISTORY 👑

Linux. yes, again. iconic of it.

---

🎀 SEE ALSO 🎀

• quotactl(2)
• quotactl_fd(2)

---

and that's the whole page, bestie!! 🫶💖 this one came from the Linux man-pages, version 6.20, and it was dated 2026-06-05 — so if you're reading this way later, just know we said it with love back then. go forth and get those XFS quota stats. slay. ✨🦋💅