From: Alejandro Colomar <alx@kernel.org>
Date: Sun, 12 Apr 2026 17:10:57 +0000 (+0200)
Subject: man/man2/quotactl.2, man/man2const/Q_GETNEXTQUOTA.2const: Split Q_GETNEXTQUOTA from... 
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=c3ab07ee53e30da1dab7d79af88fdf4e002e0230;p=thirdparty%2Fman-pages.git

man/man2/quotactl.2, man/man2const/Q_GETNEXTQUOTA.2const: Split Q_GETNEXTQUOTA from quotactl(2)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man2/quotactl.2 b/man/man2/quotactl.2
index 874ed728f..de0f9ea2e 100644
--- a/man/man2/quotactl.2
+++ b/man/man2/quotactl.2
@@ -107,42 +107,8 @@ value is one of the following operations:
 .BR Q_QUOTAOFF (2const)
 .TQ
 .BR Q_GETQUOTA (2const)
-.TP
-.BR Q_GETNEXTQUOTA " (since Linux 4.6)"
-.\" commit 926132c0257a5a8d149a6a395cc3405e55420566
-This operation is the same as
-.BR Q_GETQUOTA (2const),
-but it returns quota information for the next ID greater than or equal to
-.I id
-that has a quota set.
-.IP
-The
-.I addr
-argument is a pointer to a
-.I nextdqblk
-structure whose fields are as for the
-.BR dqblk (2type),
-except for the addition of a
-.I dqb_id
-field that is used to return the ID for which
-quota information is being returned:
-.IP
-.in +4n
-.EX
-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;
-};
-.EE
-.in
+.TQ
+.BR Q_GETNEXTQUOTA (2const)
 .TP
 .B Q_SETQUOTA
 Set quota information for user or group
@@ -421,7 +387,7 @@ already has
 field, no separate structure type is needed (in contrast with
 .BR Q_GETQUOTA (2const)
 and
-.B Q_GETNEXTQUOTA
+.BR Q_GETNEXTQUOTA (2const)
 operations)
 .TP
 .B Q_XSETQLIM
@@ -646,8 +612,6 @@ Quotas have not been turned on for this filesystem.
 .B ESRCH
 .I op
 is
-.B Q_GETNEXTQUOTA
-or
 .BR Q_XGETNEXTQUOTA ,
 but there is no ID greater than or equal to
 .I id
diff --git a/man/man2const/Q_GETNEXTQUOTA.2const b/man/man2const/Q_GETNEXTQUOTA.2const
new file mode 100644
index 000000000..5862434c2
--- /dev/null
+++ b/man/man2const/Q_GETNEXTQUOTA.2const
@@ -0,0 +1,89 @@
+.\" Copyright 1996, Andries E. Brouwer <aeb@cwi.nl>
+.\" Copyright 2010, Jan Kara <jack@suse.cz>
+.\" Copyright 2010, Michael Kerrisk <mtk.manpages@gmail.com>
+.\" Copyright, the authors of the Linux man-pages project
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH Q_GETNEXTQUOTA 2const (date) "Linux man-pages (unreleased)"
+.SH NAME
+Q_GETNEXTQUOTA
+\-
+get disk quota limits and current usage for next user or group
+.SH LIBRARY
+Standard C library
+.RI ( libc ,\~ \-lc )
+.SH SYNOPSIS
+.nf
+.B #include <sys/quota.h>
+.P
+.BI "int\~quotactl(QCMD(Q_GETNEXTQUOTA, " type "), const\~char\~*_Nullable\~" special ,
+.BI "             int\~" id ", caddr_t\~" addr );
+.P
+.BR "#include <sys/quota.h>" "    /* Definition of " Q_* " constants */"
+.BR "#include <sys/syscall.h>" "  /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
+.P
+.BI "int\~syscall(SYS_quotactl_fd, int\~" fd ", QCMD(Q_GETNEXTQUOTA, " type ),
+.BI "            int\~" id ", struct\~nextdqblk\~*" addr );
+.fi
+.SH DESCRIPTION
+.TP
+.BR Q_GETNEXTQUOTA " (since Linux 4.6)"
+.\" commit 926132c0257a5a8d149a6a395cc3405e55420566
+This operation is the same as
+.BR Q_GETQUOTA (2const),
+but it returns quota information for the next ID greater than or equal to
+.I id
+that has a quota set.
+.IP
+The
+.I addr
+argument is a pointer to a
+.I nextdqblk
+structure whose fields are as for the
+.BR dqblk (2type),
+except for the addition of a
+.I dqb_id
+field that is used to return the ID for which
+quota information is being returned:
+.IP
+.in +4n
+.EX
+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;
+};
+.EE
+.in
+.SH RETURN VALUE
+See
+.BR quotactl (2).
+.SH ERRORS
+See
+.BR quotactl (2).
+.TP
+.B ESRCH
+.I op
+is
+.B Q_GETNEXTQUOTA
+but there is no ID greater than or equal to
+.I id
+that has an active quota.
+.SH STANDARDS
+Linux.
+.SH HISTORY
+Linux.
+.SH SEE ALSO
+.BR quotactl (2),
+.BR quotactl_fd (2),
+.BR Q_GETQUOTA (2const),
+.BR dqblk (2type)