]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man2/quotactl.2, man/man2const/Q_GETNEXTQUOTA.2const: Split Q_GETNEXTQUOTA from...
authorAlejandro Colomar <alx@kernel.org>
Sun, 12 Apr 2026 17:10:57 +0000 (19:10 +0200)
committerAlejandro Colomar <alx@kernel.org>
Thu, 4 Jun 2026 23:06:16 +0000 (01:06 +0200)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man2/quotactl.2
man/man2const/Q_GETNEXTQUOTA.2const [new file with mode: 0644]

index 874ed728f240356656758df4f6137ce6b4dc1ac9..de0f9ea2e9cc1fb5ebc8790a5d0b1b9e288fb318 100644 (file)
@@ -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 (file)
index 0000000..5862434
--- /dev/null
@@ -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)