GENWiki

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.16 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)