mq_close()

close a message queue 

Realtime Function

SYNOPSIS

#include <mqueue.h>

int mq_close(mqd_t mqdes);

DESCRIPTION

The mq_close() function severs the link between the specified message queue descriptor, mqdes, and its associated message queue.

This function also removes any notification requests for the message queue identified by mqdes that are attached to the calling process. The message queue is then available for another process to attach for notification.

PARAMETERS

mqdes 

Is a message queue descriptor.

RETURN VALUES

On success, mq_close() returns 0. On failure, it returns -1 and sets errno to one of the following:

EBADF 

mqdes is not a valid message queue descriptor.

CONFORMANCE

UNIX 03.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

None.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
mq_open(), mq_unlink(), msgctl(), msgget(), msgrcv(), msgsnd()

MKS Toolkit 9.3 Documentation Build 6.