1mq_unlink(3C) Standard C Library Functions mq_unlink(3C)
2
3
4
6 mq_unlink - remove a message queue
7
9 #include <mqueue.h>
10
11 int mq_unlink(const char *name);
12
13
15 The mq_unlink() function removes the message queue named by the path‐
16 name name. After a successful call to mq_unlink() with name, a call to
17 mq_open(3C) with name fails if the flag O_CREAT is not set in flags. If
18 one or more processes have the message queue open when mq_unlink() is
19 called, destruction of the message queue is postponed until all refer‐
20 ences to the message queue have been closed. Calls to mq_open(3C) to
21 re-create the message queue may fail until the message queue is actu‐
22 ally removed. However, the mq_unlink() call need not block until all
23 references have been closed; it may return immediately.
24
26 Upon successful completion, mq_unlink() returns 0; otherwise, the named
27 message queue is not changed by this function call, the function
28 returns −1 and sets errno to indicate the error.
29
31 The mq_unlink() function will fail if:
32
33 EACCES Permission is denied to unlink the named message
34 queue.
35
36
37 ENAMETOOLONG The length of the name string exceeds PATH_MAX, or a
38 pathname component is longer than NAME_MAX while
39 _POSIX_NO_TRUNC is in effect.
40
41
42 ENOENT The named message queue, name, does not exist.
43
44
45 ENOSYS mq_unlink() is not supported by the system.
46
47
49 See attributes(5) for descriptions of the following attributes:
50
51
52
53
54 ┌─────────────────────────────┬─────────────────────────────┐
55 │ATTRIBUTE TYPE │ATTRIBUTE VALUE │
56 ├─────────────────────────────┼─────────────────────────────┤
57 │Interface Stability │Committed │
58 ├─────────────────────────────┼─────────────────────────────┤
59 │MT-Level │MT-Safe │
60 ├─────────────────────────────┼─────────────────────────────┤
61 │Standard │See standards(5). │
62 └─────────────────────────────┴─────────────────────────────┘
63
65 mqueue.h(3HEAD), mq_close(3C), mq_open(3C), attributes(5), standards(5)
66
68 Solaris 2.6 was the first release to support the Asynchronous Input and
69 Output option. Prior to this release, this function always returned −1
70 and set errno to ENOSYS.
71
72
73
74SunOS 5.11 5 Feb 2008 mq_unlink(3C)