The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

mq_close - close a message queue (REALTIME)

 SYNOPSIS



#include <mqueue.h>

int mq_close(mqd_t mqdes);

 DESCRIPTION

The mq_close() function removes the association between the message queue descriptor, mqdes, and its message queue. The results of using this message queue descriptor after successful return from this mq_close(), and until the return of this message queue descriptor from a subsequent mq_open(), are undefined.

If the process has successfully attached a notification request to the message queue via this mqdes, this attachment will be removed, and the message queue is available for another process to attach for notification.

 RETURN VALUE

Upon successful completion, the mq_close() function returns a value of zero; otherwise, the function returns a value of -1 and sets errno to indicate the error.

 ERRORS

The mq_close() function will fail if:
[EBADF]
The mqdes argument is not a valid message queue descriptor.
[ENOSYS]
The function mq_close() is not supported by this implementation.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 SEE ALSO

mq_open(), mq_unlink(), <mqueue.h>, msgctl(), msgget(), msgrcv(), msgsnd().

DERIVATION

Derived from the POSIX Realtime Extension (1003.1b-1993/1003.1i-1995)

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]