git: c9e6bc37a9ca - stable/14 - mq_open(2): document sysctl limit EINVAL and ENFILE conditions
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 13 Nov 2026 18:41:18 UTC
The branch stable/14 has been updated by mhorne:
URL: https://cgit.FreeBSD.org/src/commit/?id=c9e6bc37a9cae3f1e37f20ce023bc79d27a00527
commit c9e6bc37a9cae3f1e37f20ce023bc79d27a00527
Author: Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-04-02 17:37:49 +0000
Commit: Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2026-11-13 18:41:02 +0000
mq_open(2): document sysctl limit EINVAL and ENFILE conditions
Document two missing error conditions for mq_open(2):
- EINVAL: returned when mq_maxmsg exceeds kern.mqueue.maxmsg or
mq_msgsize exceeds kern.mqueue.maxmsgsize.
- ENFILE: add kern.mqueue.maxmq sysctl name to the existing entry.
PR: 243209
Reviewed by: mhorne
MFC after: 1 week
Signed-off-by: Kit Dallege <xaum.io@gmail.com>
Pull Request: https://github.com/freebsd/freebsd-src/pull/2098
(cherry picked from commit 3e9f4fd6fc50300d052d5619d82a14d3488483d5)
---
lib/libc/sys/mq_open.2 | 23 ++++++++++++++++++++++-
1 file changed, 22 insertions(+), 1 deletion(-)
diff --git a/lib/libc/sys/mq_open.2 b/lib/libc/sys/mq_open.2
index e5e7808c9e26..51668e55d9f7 100644
--- a/lib/libc/sys/mq_open.2
+++ b/lib/libc/sys/mq_open.2
@@ -35,7 +35,7 @@
.\" the referee document. The original Standard can be obtained online at
.\" http://www.opengroup.org/unix/online.html.
.\"
-.Dd September 28, 2019
+.Dd April 2, 2026
.Dt MQ_OPEN 2
.Os
.Sh NAME
@@ -270,6 +270,24 @@ and either
or
.Va mq_msgsize
was less than or equal to zero.
+.It Bq Er EINVAL
+.Dv O_CREAT
+was specified in
+.Fa oflag ,
+the value of
+.Fa attr
+is not
+.Dv NULL ,
+and either
+.Va mq_maxmsg
+exceeds the
+.Va kern.mqueue.maxmsg
+sysctl limit,
+or
+.Va mq_msgsize
+exceeds the
+.Va kern.mqueue.maxmsgsize
+sysctl limit.
.It Bq Er EMFILE
Too many message queue descriptors or file descriptors are currently in use
by this process.
@@ -283,6 +301,9 @@ is longer than
.Brq Dv NAME_MAX .
.It Bq Er ENFILE
Too many message queues are currently open in the system.
+The system limit is controlled by the
+.Va kern.mqueue.maxmq
+sysctl.
.It Bq Er ENOENT
.Dv O_CREAT
is not set and the named message queue does not exist.