mq_unlink.2 (2010 09)

m
mq_unlink(2) mq_unlink(2)
NAME
mq_unlink - unlink a message queue
SYNOPSIS
#include <sys/mqueue.h>
int mq_unlink(const char *name);
DESCRIPTION
The mq_unlink() system call disassociates the queue name, from a message queue specified by the
argument, name. After a successful call to
mq_unlink(), attempts to open a message queue with the
same name will fail, if the flag
O_CREAT is not set in oflags.
If there are no processes with existing open descriptors for the message queue, the queue is destroyed. If
one or more processes have the message queue open, the removal of the queue is postponed until all
descriptors for the queue have been closed.
To use this function, link in the realtime library by specifying
-lrt on the compiler or linker command
line.
Security Restrictions
Some or all of the actions associated with this system call are subject to compartmentalization restric-
tions. See compartments (5) for more information.
Some or all of the actions associated with this system call require privileges. See privileges (5).
RETURN VALUE
mq_unlink() returns the following values:
0 Successful completion.
-1 Failure, errno is set to indicate the error.
ERRORS
If
mq_unlink() fails, errno is set to one of the following values:
[EACCES] Permission to unlink the named message queue is denied.
[EINVAL] The argument name is not a valid message queue name.
[ENAMETOOLONG]
The length of the name string exceeds PATH_MAX bytes, or the length of a (path-
name) component of the name string exceeds NAME_MAX bytes while
_POSIX_NO_TRUNC is in effect.
[ENOENT] The named message queue does not exist.
[ENOSYS]
mq_unlink() is not supported by the implementation.
SEE ALSO
mq_open(2), mq_close(2), compartments(5), privileges(5).
STANDARDS CONFORMANCE
mq_unlink(): POSIX 1003.1b
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1