MQ_UNLINK(3) Library Functions Manual MQ_UNLINK(3)

mq_unlink — remove a message queue (REALTIME)

#include <mqueue.h>

int mq_unlink(const char *name);

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(3) 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(3) 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.

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.

The mq_unlink() function will fail if:

Permission is denied to unlink the named message queue.
The length of the name string exceeds {NAME_MAX} while _POSIX_NO_TRUNC is in effect.
The named message queue does not exist.
The function mq_unlink() is not supported by this implementation.

None.

None.

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

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

February 1997 posix.fail