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.
42 .Nd "mq_unlink - remove a message queue (REALTIME)"
48 .Fn mq_unlink "const char *name"
52 function removes the message queue named by the string
54 If one or more processes have the message queue open when
56 is called, destruction of the message queue will be postponed
57 until all references to the message queue have been closed.
60 call need not block until all references have been closed; it may return
63 After a successful call to
65 reuse of the name will subsequently cause
67 to behave as if no message queue of this name exists.
77 Permission is denied to unlink the message queue represented by
82 .It Bq Er ENAMETOOLONG
88 a pathname component is longer than
91 The message queue does not exist.
94 module is neither loaded nor included in the kernel.
101 system call conforms to
105 error code is an extension to the standard.
107 Support for POSIX message queues first appeared in
110 Portions of this text are reprinted and reproduced in electronic form
111 from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
112 Portable Operating System Interface (POSIX), The Open Group Base
113 Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
114 Electrical and Electronics Engineers, Inc and The Open Group.
115 In the event of any discrepancy between this version and the original IEEE and
116 The Open Group Standard, the original IEEE and The Open Group Standard is
117 the referee document.
118 The original Standard can be obtained online at
119 http://www.opengroup.org/unix/online.html.