mq_unlink(3) — Linux manual page

 mq_unlink(3) Library Functions Manual mq_unlink(3) 

NAME         top

 mq_unlink - remove a message queue 

LIBRARY         top

 Real-time library (librt, -lrt) 

SYNOPSIS         top

 #include <mqueue.h> int mq_unlink(const char *name); 

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. 

ATTRIBUTES         top

 For an explanation of the terms used in this section, see attributes(7). ┌──────────────────────────────────────┬───────────────┬─────────┐ │ Interface │ Attribute │ Value │ ├──────────────────────────────────────┼───────────────┼─────────┤ │ mq_unlink() │ Thread safety │ MT-Safe │ └──────────────────────────────────────┴───────────────┴─────────┘ 

STANDARDS         top

 POSIX.1-2008. 

HISTORY         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 the man-pages (Linux kernel and C library user-space interface documentation) project. Information about the project can be found at ⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report for this manual page, see ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩. This page was obtained from the tarball man-pages-6.15.tar.gz fetched from ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on 2025-08-11. If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up- to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which is not part of the original manual page), send a mail to man-pages@man7.org Linux man-pages 6.15 2025-05-17 mq_unlink(3) 

Pages that refer to this page: ipcrm(1),  syscalls(2),  mq_close(3),  mq_getattr(3),  mq_notify(3),  mq_open(3),  mq_receive(3),  mq_send(3),  mq_overview(7)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.