Yolinux.com

mq_unlink manpage

Search topic Section


MQ_UNLINK(3)		   Linux Programmer's Manual		  MQ_UNLINK(3)



NAME
       mq_unlink - remove a message queue

SYNOPSIS
       #include <mqueue.h>

       int mq_unlink(const char *name);

       Link with -lrt.

DESCRIPTION
       mq_unlink()  removes  the  specified  message  queue name.  The message
       queue name is removed immediately.  The queue itself is destroyed  once
       any  other  processes  that have the queue open close their descriptors
       referring to the queue.

RETURN VALUE
       On success mq_unlink() returns 0; on error, -1 is returned, with	 errno
       set to indicate the error.

ERRORS
       EACCES The  caller  does	 not  have  permission	to unlink this message
	      queue.

       ENAMETOOLONG
	      name was too long.

       ENOENT There is no message queue with the given name.

ATTRIBUTES
       For  an	explanation  of	 the  terms  used   in	 this	section,   see
       attributes(7).

       +------------+---------------+---------+
       |Interface   | Attribute	    | Value   |
       +------------+---------------+---------+
       |mq_unlink() | Thread safety | MT-Safe |
       +------------+---------------+---------+
CONFORMING TO
       POSIX.1-2001, POSIX.1-2008.

SEE ALSO
       mq_close(3),  mq_getattr(3),  mq_notify(3),  mq_open(3), mq_receive(3),
       mq_send(3), mq_overview(7)

COLOPHON
       This page is part of release 4.10 of the Linux  man-pages  project.   A
       description  of	the project, information about reporting bugs, and the
       latest	 version    of	  this	  page,	   can	   be	  found	    at
       https://www.kernel.org/doc/man-pages/.



Linux				  2015-08-08			  MQ_UNLINK(3)