]>
Commit | Line | Data |
---|---|---|
d4697bc9 | 1 | /* Copyright (C) 2004-2014 Free Software Foundation, Inc. |
1b82c6c7 | 2 | This file is part of the GNU C Library. |
1b82c6c7 UD |
3 | |
4 | The GNU C Library is free software; you can redistribute it and/or | |
5 | modify it under the terms of the GNU Lesser General Public | |
6 | License as published by the Free Software Foundation; either | |
7 | version 2.1 of the License, or (at your option) any later version. | |
8 | ||
9 | The GNU C Library is distributed in the hope that it will be useful, | |
10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
12 | Lesser General Public License for more details. | |
13 | ||
14 | You should have received a copy of the GNU Lesser General Public | |
59ba27a6 PE |
15 | License along with the GNU C Library; if not, see |
16 | <http://www.gnu.org/licenses/>. */ | |
1b82c6c7 UD |
17 | |
18 | #ifndef _MQUEUE_H | |
19 | #define _MQUEUE_H 1 | |
20 | ||
21 | #include <features.h> | |
22 | #include <sys/types.h> | |
23 | #include <fcntl.h> | |
24 | #define __need_sigevent_t | |
25 | #include <bits/siginfo.h> | |
26 | #define __need_timespec | |
27 | #include <time.h> | |
28 | /* Get the definition of mqd_t and struct mq_attr. */ | |
29 | #include <bits/mqueue.h> | |
30 | ||
31 | __BEGIN_DECLS | |
32 | ||
33 | /* Establish connection between a process and a message queue NAME and | |
34 | return message queue descriptor or (mqd_t) -1 on error. OFLAG determines | |
35 | the type of access used. If O_CREAT is on OFLAG, the third argument is | |
36 | taken as a `mode_t', the mode of the created message queue, and the fourth | |
37 | argument is taken as `struct mq_attr *', pointer to message queue | |
38 | attributes. If the fourth argument is NULL, default attributes are | |
39 | used. */ | |
a784e502 | 40 | extern mqd_t mq_open (const char *__name, int __oflag, ...) |
177f96e8 | 41 | __THROW __nonnull ((1)); |
1b82c6c7 UD |
42 | |
43 | /* Removes the association between message queue descriptor MQDES and its | |
44 | message queue. */ | |
45 | extern int mq_close (mqd_t __mqdes) __THROW; | |
46 | ||
47 | /* Query status and attributes of message queue MQDES. */ | |
177f96e8 UD |
48 | extern int mq_getattr (mqd_t __mqdes, struct mq_attr *__mqstat) |
49 | __THROW __nonnull ((2)); | |
1b82c6c7 UD |
50 | |
51 | /* Set attributes associated with message queue MQDES and if OMQSTAT is | |
52 | not NULL also query its old attributes. */ | |
53 | extern int mq_setattr (mqd_t __mqdes, | |
a784e502 | 54 | const struct mq_attr *__restrict __mqstat, |
177f96e8 UD |
55 | struct mq_attr *__restrict __omqstat) |
56 | __THROW __nonnull ((2)); | |
1b82c6c7 UD |
57 | |
58 | /* Remove message queue named NAME. */ | |
a784e502 | 59 | extern int mq_unlink (const char *__name) __THROW __nonnull ((1)); |
1b82c6c7 | 60 | |
a877d33e UD |
61 | /* Register notification issued upon message arrival to an empty |
62 | message queue MQDES. */ | |
a784e502 | 63 | extern int mq_notify (mqd_t __mqdes, const struct sigevent *__notification) |
1b82c6c7 UD |
64 | __THROW; |
65 | ||
66 | /* Receive the oldest from highest priority messages in message queue | |
67 | MQDES. */ | |
68 | extern ssize_t mq_receive (mqd_t __mqdes, char *__msg_ptr, size_t __msg_len, | |
177f96e8 | 69 | unsigned int *__msg_prio) __nonnull ((2)); |
1b82c6c7 UD |
70 | |
71 | /* Add message pointed by MSG_PTR to message queue MQDES. */ | |
a784e502 | 72 | extern int mq_send (mqd_t __mqdes, const char *__msg_ptr, size_t __msg_len, |
177f96e8 | 73 | unsigned int __msg_prio) __nonnull ((2)); |
1b82c6c7 UD |
74 | |
75 | #ifdef __USE_XOPEN2K | |
76 | /* Receive the oldest from highest priority messages in message queue | |
77 | MQDES, stop waiting if ABS_TIMEOUT expires. */ | |
78 | extern ssize_t mq_timedreceive (mqd_t __mqdes, char *__restrict __msg_ptr, | |
79 | size_t __msg_len, | |
80 | unsigned int *__restrict __msg_prio, | |
a784e502 | 81 | const struct timespec *__restrict __abs_timeout) |
754980e4 | 82 | __nonnull ((2, 5)); |
1b82c6c7 UD |
83 | |
84 | /* Add message pointed by MSG_PTR to message queue MQDES, stop blocking | |
85 | on full message queue if ABS_TIMEOUT expires. */ | |
a784e502 | 86 | extern int mq_timedsend (mqd_t __mqdes, const char *__msg_ptr, |
1b82c6c7 | 87 | size_t __msg_len, unsigned int __msg_prio, |
a784e502 | 88 | const struct timespec *__abs_timeout) |
754980e4 | 89 | __nonnull ((2, 5)); |
1b82c6c7 UD |
90 | #endif |
91 | ||
3a50811c | 92 | /* Define some inlines helping to catch common problems. */ |
5ac3ea17 | 93 | #if __USE_FORTIFY_LEVEL > 0 && defined __fortify_function \ |
3a50811c UD |
94 | && defined __va_arg_pack_len |
95 | # include <bits/mqueue2.h> | |
96 | #endif | |
97 | ||
a877d33e | 98 | __END_DECLS |
1b82c6c7 UD |
99 | |
100 | #endif /* mqueue.h */ |