git: c9e6bc37a9ca - stable/14 - mq_open(2): document sysctl limit EINVAL and ENFILE conditions

From: Mitchell Horne <mhorne_at_FreeBSD.org>
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.