mq_unlink()

Remove a queue

Synopsis:

#include <mqueue.h>

int mq_unlink( const char* name );

Library:

libc

Description:

The mq_unlink() function removes the queue name. If some process has the queue open when the call to mq_unlink() is made, then the actual deletion of the queue is postponed until it has been closed. If a queue exists in the nether-world between unlinking and the actual removal of the queue, then all calls to open queue name fail (even if O_CREAT is present in oflag). Once the queue is deleted, all elements currently on it are freed. Due to the lazy deletion of queues, it's impossible for any process to be blocked on the message queue when it's deleted.

Calling unlink() with a name that resolves to the message queue server's namespace (e.g. /dev/mqueue/my_queue) is analogous to calling mq_unlink() with name set to the last elements of the pathname (e.g. my_queue).

Returns:

-1

The queue wasn't successfully unlinked (errno is set).

Any other value

The queue is successfully unlinked.

Errors:

EACCES

The user doesn't have permission to unlink the specified queue.

ELOOP

Too many levels of symbolic links or prefixes.

ENAMETOOLONG

The length of name exceeds PATH_MAX.

ENOENT

The queue name doesn't exist.

ENOSYS

The mq_unlink() function isn't implemented for the filesystem specified in path.

Classification:

POSIX 1003.1 (Realtime Extensions)

See also:

mq_close(), mq_open()