mq_unlink(2)mq_unlink(2)NAMEmq_unlink - unlink a message queue
SYNOPSISDESCRIPTION
The system call disassociates the queue name, from a message queue
specified by the argument, name. After a successful call to attempts
to open a message queue with the same name will fail, if the flag is
not set in oflags.
If there are no processes with existing open descriptors for the mes‐
sage 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 on the
compiler or linker command line.
Security Restrictions
Some or all of the actions associated with this system call are subject
to compartmentalization restrictions. See compartments(5) for more
information.
Some or all of the actions associated with this system call require
privileges. See privileges(5).
RETURN VALUE
returns the following values:
Successful completion.
Failure,
is set to indicate the error.
ERRORS
If fails, 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 bytes, or
the length of a (pathname) component of the name
string exceeds bytes while is in effect.
[ENOENT] The named message queue does not exist.
[ENOSYS] is not supported by the implementation.
SEE ALSOmq_open(2), mq_close(2), compartments(5), privileges(5).
STANDARDS CONFORMANCEmq_unlink(2)