man3/mq_unlink.3

   1 '\" t
   2 .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\"
   4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   5 .\"
   6 .TH mq_unlink 3 (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 mq_unlink \- remove a message queue
   9 .SH LIBRARY
  10 Real-time library
  11 .RI ( librt ", " \-lrt )
  12 .SH SYNOPSIS
  13 .nf
  14 .B #include <mqueue.h>
  15 .PP
  16 .BI "int mq_unlink(const char *" name );
  17 .fi
  18 .SH DESCRIPTION
  19 .BR mq_unlink ()
  20 removes the specified message queue
  21 .IR name .
  22 The message queue name is removed immediately.
  23 The queue itself is destroyed once any other processes that have
  24 the queue open close their descriptors referring to the queue.
  25 .SH RETURN VALUE
  26 On success
  27 .BR mq_unlink ()
  28 returns 0; on error, \-1 is returned, with
  29 .I errno
  30 set to indicate the error.
  31 .SH ERRORS
  32 .TP
  33 .B EACCES
  34 The caller does not have permission to unlink this message queue.
  35 .TP
  36 .B ENAMETOOLONG
  37 .I name
  38 was too long.
  39 .TP
  40 .B ENOENT
  41 There is no message queue with the given
  42 .IR name .
  43 .SH ATTRIBUTES
  44 For an explanation of the terms used in this section, see
  45 .BR attributes (7).
  46 .ad l
  47 .nh
  48 .TS
  49 allbox;
  50 lbx lb lb
  51 l l l.
  52 Interface       Attribute       Value
  53 T{
  54 .BR mq_unlink ()
  55 T}      Thread safety   MT-Safe
  56 .TE
  57 .hy
  58 .ad
  59 .sp 1
  60 .SH STANDARDS
  61 POSIX.1-2001, POSIX.1-2008.
  62 .SH SEE ALSO
  63 .BR mq_close (3),
  64 .BR mq_getattr (3),
  65 .BR mq_notify (3),
  66 .BR mq_open (3),
  67 .BR mq_receive (3),
  68 .BR mq_send (3),
  69 .BR mq_overview (7)