Yolinux.com

mq_close manpage

Search topic Section


MQ_CLOSE(3)		   Linux Programmer's Manual		   MQ_CLOSE(3)



NAME
       mq_close - close a message queue descriptor

SYNOPSIS
       #include <mqueue.h>

       int mq_close(mqd_t mqdes);

       Link with -lrt.

DESCRIPTION
       mq_close() closes the message queue descriptor mqdes.

       If  the	calling	 process  has  attached	 a  notification  request (see
       (mq_notify(3)) to this message queue via mqdes, then  this  request  is
       removed, and another process can now attach a notification request.

RETURN VALUE
       On  success  mq_close() returns 0; on error, -1 is returned, with errno
       set to indicate the error.

ERRORS
       EBADF  The message queue descriptor specified in mqdes is invalid.

ATTRIBUTES
       For  an	explanation  of	 the  terms  used   in	 this	section,   see
       attributes(7).

       +-----------+---------------+---------+
       |Interface  | Attribute	   | Value   |
       +-----------+---------------+---------+
       |mq_close() | Thread safety | MT-Safe |
       +-----------+---------------+---------+
CONFORMING TO
       POSIX.1-2001, POSIX.1-2008.

NOTES
       All  open  message  queues are automatically closed on process termina-
       tion, or upon execve(2).

SEE ALSO
       mq_getattr(3),  mq_notify(3),  mq_open(3),  mq_receive(3),  mq_send(3),
       mq_unlink(3), mq_overview(7)

COLOPHON
       This  page  is  part of release 4.10 of the Linux man-pages project.  A
       description of the project, information about reporting bugs,  and  the
       latest	  version     of     this    page,    can    be	   found    at
       https://www.kernel.org/doc/man-pages/.



Linux				  2016-12-12			   MQ_CLOSE(3)