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 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 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  termination,  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.04 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 http://www.kernel.org/doc/man-pages/.