QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Close a message queue
#include <mqueue.h> int mq_close( mqd_t mqdes );
- The message-queue descriptor, returned by mq_open(), of the message queue that you want to close.
- For the traditional implementation, libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
- For the alternate implementation using asynchronous messages,
Use the -l mq option to qcc to link against this library.
The mq_close() function removes the association between mqdes and a message queue. If the current process attaches a notify to this queue for notification, the attachment is eliminated. If this queue is unlinked before the call to mq_close(), and this process is the last process to call mq_close() on the queue, then the queue is destroyed, along with its contents.
|Neutrino supports two implementations of message queues: a traditional implementation, and an alternate one that uses asynchronous messages. For more information, see the entry for mq and mqueue in the Utilities Reference.|
In the traditional (mqueue) implementation, calling close() with mqdes has the same effect as calling mq_close().
-1 if an error occurred (errno is set). Any other value indicates success.
- Invalid queue mqdes.
mq, mqueue in the Utilities Reference