quotactl.2: Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 52 insertions, 2 deletions

diff --git a/man2/quotactl.2 b/man2/quotactl.2
index 1a3ca44118..a64e795685 100644
--- a/man2/quotactl.2
+++ b/man2/quotactl.2
@@ -196,6 +196,42 @@ a privileged user
 .RB ( CAP_SYS_ADMIN )
 can retrieve the quotas of any user.
 .TP
+.BR Q_GETNEXTQUOTA " (since Linux 4.6)"
+.\" commit 926132c0257a5a8d149a6a395cc3405e55420566
+This operation is the same as
+.BR Q_GETQUOTA ,
+but it returns quota information for the next ID greater than or equal to
+.IR id
+that has a quota set.
+
+The
+.I addr
+argument is a pointer to a
+.I nextdqblk
+structure whose fields are as for the
+.IR dqblk ,
+except for the addition of a
+.I dqb_id
+field that is used to return the ID for which
+quota information is being returned:
+
+.nf
+.in +4n
+struct nextdqblk {
+    uint64_t dqb_bhardlimit;
+    uint64_t dqb_bsoftlimit;
+    uint64_t dqb_curspace;
+    uint64_t dqb_ihardlimit;
+    uint64_t dqb_isoftlimit;
+    uint64_t dqb_curinodes;
+    uint64_t dqb_btime;
+    uint64_t dqb_itime;
+    uint32_t dqb_valid;
+    uint32_t dqb_id;
+};
+.in
+.fi
+.TP
 .B Q_SETQUOTA
 Set quota information for user or group
 .IR id ,
@@ -387,8 +423,12 @@ a privileged user
 may retrieve the quotas of any user.
 .TP
 .BR Q_XGETNEXTQUOTA " (since Linux 4.6)"
-.\" commit 926132c0257a5a8d149a6a395cc3405e55420566
-
+.\" commit 8b37524962b9c54423374717786198f5c0820a28
+This operation is the same as
+.BR Q_XGETQUOTA ,
+but it returns quota information for the next ID greater than or equal to
+.IR id
+that has a quota set.
 .TP
 .B Q_XSETQLIM
 Set disk quota limits for user
@@ -502,6 +542,16 @@ Quotas have not been turned on for this filesystem.
 is
 .BR Q_QUOTAON ,
 but the specified quota format was not found.
+.TP
+.B ESRCH
+.I cmd
+is
+.B Q_GETNEXTQUOTA
+or
+.BR Q_XGETNEXTQUOTA ,
+but there is no ID greater than or equal to
+.IR id
+that has an active quota.
 .SH SEE ALSO
 .BR quota (1),
 .BR getrlimit (2),