]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man2const/Q_XGETQSTATV.2const: Tweak after split
authorAlejandro Colomar <alx@kernel.org>
Thu, 4 Jun 2026 22:25:52 +0000 (00:25 +0200)
committerAlejandro Colomar <alx@kernel.org>
Thu, 4 Jun 2026 23:09:37 +0000 (01:09 +0200)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man2const/Q_XGETQSTATV.2const

index 94d6701e0c5b4c2ea82e3883045c14edd8b20c0f..be9f60fcd1021c0f1c7e67c0c6690a6bdaafb713 100644 (file)
@@ -27,69 +27,110 @@ Standard C library
 .P
 .BI "int\~syscall(SYS_quotactl_fd, int\~" fd ", QCMD(Q_XGETQSTATV, " type "), 0,"
 .BI "            struct\~fs_quota_statv\~*" addr );
+.P
+.BR "#include <xfs/xqm.h>" "      /* See quotactl_fd(2) */"
 .fi
-.SH DESCRIPTION
-.TP
-.B Q_XGETQSTATV
-Returns XFS filesystem-specific quota information in the
-.I fs_quota_statv
-pointed to by
-.IR addr .
-This version of the operation uses a structure with proper versioning support,
-along with appropriate layout (all fields are naturally aligned) and
-padding to avoiding special compat handling;
-it also provides the ability to get statistics regarding
-the project quota file.
-The
-.I fs_quota_statv
-structure itself is defined as follows:
-.IP
-.in +4n
+.P
 .EX
-#define FS_QSTATV_VERSION1 1 /* fs_quota_statv.qs_version */
+#define FS_QSTATV_VERSION1  1
 \&
-struct fs_qfilestatv {
-    uint64_t qfs_ino;       /* Inode number */
-    uint64_t qfs_nblks;     /* Number of BBs
-                               512\-byte\-blocks */
-    uint32_t qfs_nextents;  /* Number of extents */
-    uint32_t qfs_pad;       /* Pad for 8\-byte alignment */
+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_quota_statv {
-    int8_t   qs_version;    /* Version for future
-                               changes */
-    uint8_t  qs_pad1;       /* Pad for 16\-bit alignment */
-    uint16_t qs_flags;      /* XFS_QUOTA_.* flags */
-    uint32_t qs_incoredqs;  /* Number of dquots incore */
-    struct fs_qfilestatv qs_uquota;  /* User quota
-                                        information */
-    struct fs_qfilestatv qs_gquota;  /* Group quota
-                                        information */
-    struct fs_qfilestatv qs_pquota;  /* Project quota
-                                        information */
-    int32_t  qs_btimelimit;   /* Limit for blocks timer */
-    int32_t  qs_itimelimit;   /* Limit for inodes timer */
-    int32_t  qs_rtbtimelimit; /* Limit for RT blocks
-                                 timer */
-    uint16_t qs_bwarnlimit;   /* Limit for # of warnings */
-    uint16_t qs_iwarnlimit;   /* Limit for # of warnings */
-    uint64_t qs_pad2[8];      /* For future proofing */
+struct fs_qfilestatv {
+       uint64_t  qfs_ino;
+       uint64_t  qfs_nblks;
+       uint32_t  qfs_nextents;
+       uint32_t  qfs_pad;
 };
 .EE
-.in
-.IP
-The
-.I qs_version
-field of the structure should be filled with the version of the structure
-supported by the callee (for now, only
+.SH DESCRIPTION
+Returns XFS filesystem-specific quota information in the
+.I fs_quota_statv
+pointed to by
+.IR addr .
+.P
+This version of the operation
+(compared to
+.BR Q_XGETQSTAT (2const))
+uses a structure with proper versioning support,
+along with appropriate layout (all fields are naturally aligned)
+and padding to avoiding special compat handling;
+it also provides the ability to get
+statistics regarding the project quota file.
+.SS struct\~fs_quota_statv
+.TP
+.I .qs_version
+This field should be filled with
+the version of the structure supported by the callee
+(for now, only
 .I FS_QSTAT_VERSION1
 is supported).
 The kernel will fill the structure in accordance with
-version provided.
-The
-.I id
-argument is ignored.
+the version provided.
+.TP
+.I .qs_pad1
+Pad for 16-bit alignment.
+.TP
+.I .qs_flags
+.BI XFS_QUOTA_ *
+flags.
+.TP
+.I .qs_incoredqs
+Number of dquots incore.
+.TP
+.I .qs_uquota
+User quota information.
+.TP
+.I .qs_gquota
+Group quota information.
+.TP
+.I .qs_pquota
+Project quota information.
+.TP
+.I .qs_btimelimit
+Limit for blocks timer.
+.TP
+.I .qs_itimelimit
+Limit for inodes timer.
+.TP
+.I .qs_rtbtimelimit
+Limit for RT blocks timer.
+.TP
+.I .qs_bwarnlimit
+Limit for # of warnings.
+.TP
+.I .qs_iwarnlimit
+Limit for # of warnings.
+.TP
+.I .qs_pad2
+For future proofing.
+.SS struct\~fs_qfilestatv
+.TP
+.I .qfs_ino
+Inode number.
+.TP
+.I .qfs_nblks
+Number of BBs 512-byte-blocks.
+.TP
+.I .qfs_nextents
+Number of extents.
+.TP
+.I .qfs_pad
+Pad for 8-byte alignment.
 .SH RETURN VALUE
 See
 .BR quotactl (2).