mq_unlink(2)							System Calls Manual						      mq_unlink(2)

NAME

       mq_unlink - unlink a message queue

SYNOPSIS

DESCRIPTION

       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 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 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 ALSO

       mq_open(2), mq_close(2), compartments(5), privileges(5).

STANDARDS CONFORMANCE

																      mq_unlink(2)