1 .\" Copyright (c) 2021 Fernando Apesteguia <fernape@FreeBSD.org>
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\" notice(s), this list of conditions and the following disclaimer as
8 .\" the first lines of this file unmodified other than the possible
9 .\" addition of one or more copyright notices.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice(s), this list of conditions and the following disclaimer in
12 .\" the documentation and/or other materials provided with the
15 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY
16 .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE
19 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
22 .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
23 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
24 .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
25 .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 .\" Portions of this text are reprinted and reproduced in electronic form
28 .\" from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
29 .\" Portable Operating System Interface (POSIX), The Open Group Base
30 .\" Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
31 .\" Electrical and Electronics Engineers, Inc and The Open Group. In the
32 .\" event of any discrepancy between this version and the original IEEE and
33 .\" The Open Group Standard, the original IEEE and The Open Group Standard is
34 .\" the referee document. The original Standard can be obtained online at
35 .\" http://www.opengroup.org/unix/online.html.
44 .Nd "mq_unlink - remove a message queue (REALTIME)"
50 .Fn mq_unlink "const char *name"
54 function removes the message queue named by the string
56 If one or more processes have the message queue open when
58 is called, destruction of the message queue will be postponed
59 until all references to the message queue have been closed.
62 call need not block until all references have been closed; it may return
65 After a successful call to
67 reuse of the name will subsequently cause
69 to behave as if no message queue of this name exists.
79 Permission is denied to unlink the message queue represented by
84 .It Bq Er ENAMETOOLONG
90 a pathname component is longer than
93 The message queue does not exist.
96 module is neither loaded nor included in the kernel.
103 system call conforms to
107 error code is an extension to the standard.
109 Support for POSIX message queues first appeared in
112 Portions of this text are reprinted and reproduced in electronic form
113 from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
114 Portable Operating System Interface (POSIX), The Open Group Base
115 Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
116 Electrical and Electronics Engineers, Inc and The Open Group.
117 In the event of any discrepancy between this version and the original IEEE and
118 The Open Group Standard, the original IEEE and The Open Group Standard is
119 the referee document.
120 The original Standard can be obtained online at
121 http://www.opengroup.org/unix/online.html.