mq_close(2POSIX)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO

NAME

mq_close- close a message queue

SYNOPSIS

#include <mqueue.h>

int mq_close(mqd_t mqdes);

FEATURES

POSIX_MQ

DESCRIPTION

The mq_close system call removes the association between the message queue descriptor, mqdes and its message queue. The mqdes message queue descriptor is obtained from a mq_open(2POSIX) system call. An mq_close system call is never blocked.

RETURN VALUE

Upon successful completion, mq_close returns a value of 0; otherwise, it will return -1 and set errno to indicate one of the following error conditions.

ERRORS

[ENOSYS]

The mq_close function is not supported.

The MQ feature [_POSIX_MESSAGE_PASSING] option (see sysconf(3POSIX)) is not configured.

[EBADF]

The mqdes argument is not a valid message queue descriptor.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

mq_open(2POSIX), mq_unlink(2POSIX), sysconf(3POSIX)

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO