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


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


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.






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


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 ]