NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | SEE ALSO | COLOPHON

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

NAME         top

       mq_unlink - remove a message queue

SYNOPSIS         top

       #include <mqueue.h>

       mqd_t mq_unlink(const char *name);

       Link with -lrt.

DESCRIPTION         top

       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         top

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

ERRORS         top

       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.

CONFORMING TO         top

       POSIX.1-2001.

SEE ALSO         top

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

COLOPHON         top

       This page is part of release 3.23 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

Linux                                 2006-02-25                         MQ_UNLINK(3)