1mq_unlink(3C)            Standard C Library Functions            mq_unlink(3C)
2
3
4

NAME

6       mq_unlink - remove a message queue
7

SYNOPSIS

9       #include <mqueue.h>
10
11       int mq_unlink(const char *name);
12
13

DESCRIPTION

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

RETURN VALUES

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

65       mqueue.h(3HEAD), mq_close(3C), mq_open(3C), attributes(5), standards(5)
66

NOTES

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)
Impressum