NAME

mq_unlink - remove a message queue (REALTIME)

 SYNOPSIS

#include <mqueue.h>

int mq_unlink(const char *name);

 DESCRIPTION

The mq_unlink() function removes the message queue named by the pathname name. After a successful call to mq_unlink() with name, a call to mq_open() with name fails if the flag O_CREAT is not set in flags. If one or more processes have the message queue open when mq_unlink() is called, destruction of the message queue is postponed until all references to the message queue have been closed. Calls to mq_open() to re-create the message queue may fail until the message queue is actually removed. However, the mq_unlink() call need not block until all references have been closed; it may return immediately.

 RETURN VALUE

Upon successful completion, the function returns a value of zero. Otherwise, the named message queue is unchanged by this function call, and the function returns a value of -1 and sets errno to indicate the error.

 ERRORS

The mq_unlink() function will fail if:

[EACCES]

Permission is denied to unlink the named message queue.

[ENAMETOOLONG]

The length of the name string exceeds {NAME_MAX} while _POSIX_NO_TRUNC is in effect.

[ENOENT]

The named message queue does not exist.

[ENOSYS]

The function mq_unlink() is not supported by this implementation.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 SEE ALSO

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

DERIVATION

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