Debian Codegraph @

upstream/debian-unstable/man3/mq_unlink.3

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