2007-08-02 23:28:20 +02:00
|
|
|
/* Copyright (C) 2004, 2005, 2007 Free Software Foundation, Inc.
|
2004-04-13 04:15:43 +02:00
|
|
|
This file is part of the GNU C Library.
|
|
|
|
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
|
|
modify it under the terms of the GNU Lesser General Public
|
|
|
|
License as published by the Free Software Foundation; either
|
|
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
Lesser General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
|
|
License along with the GNU C Library; if not, write to the Free
|
|
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
|
|
02111-1307 USA. */
|
|
|
|
|
|
|
|
#ifndef _MQUEUE_H
|
|
|
|
#define _MQUEUE_H 1
|
|
|
|
|
|
|
|
#include <features.h>
|
|
|
|
#include <sys/types.h>
|
|
|
|
#include <fcntl.h>
|
|
|
|
#define __need_sigevent_t
|
|
|
|
#include <bits/siginfo.h>
|
|
|
|
#define __need_timespec
|
|
|
|
#include <time.h>
|
|
|
|
/* Get the definition of mqd_t and struct mq_attr. */
|
|
|
|
#include <bits/mqueue.h>
|
|
|
|
|
|
|
|
__BEGIN_DECLS
|
|
|
|
|
|
|
|
/* Establish connection between a process and a message queue NAME and
|
|
|
|
return message queue descriptor or (mqd_t) -1 on error. OFLAG determines
|
|
|
|
the type of access used. If O_CREAT is on OFLAG, the third argument is
|
|
|
|
taken as a `mode_t', the mode of the created message queue, and the fourth
|
|
|
|
argument is taken as `struct mq_attr *', pointer to message queue
|
|
|
|
attributes. If the fourth argument is NULL, default attributes are
|
|
|
|
used. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern mqd_t mq_open (__const char *__name, int __oflag, ...)
|
|
|
|
__THROW __nonnull ((1));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
/* Removes the association between message queue descriptor MQDES and its
|
|
|
|
message queue. */
|
|
|
|
extern int mq_close (mqd_t __mqdes) __THROW;
|
|
|
|
|
|
|
|
/* Query status and attributes of message queue MQDES. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern int mq_getattr (mqd_t __mqdes, struct mq_attr *__mqstat)
|
|
|
|
__THROW __nonnull ((2));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
/* Set attributes associated with message queue MQDES and if OMQSTAT is
|
|
|
|
not NULL also query its old attributes. */
|
|
|
|
extern int mq_setattr (mqd_t __mqdes,
|
2007-08-02 23:28:20 +02:00
|
|
|
__const struct mq_attr *__restrict __mqstat,
|
|
|
|
struct mq_attr *__restrict __omqstat)
|
|
|
|
__THROW __nonnull ((2));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
/* Remove message queue named NAME. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern int mq_unlink (__const char *__name) __THROW __nonnull ((1));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
2005-10-23 22:38:06 +02:00
|
|
|
/* Register notification issued upon message arrival to an empty
|
|
|
|
message queue MQDES. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern int mq_notify (mqd_t __mqdes, __const struct sigevent *__notification)
|
2004-04-13 04:15:43 +02:00
|
|
|
__THROW;
|
|
|
|
|
|
|
|
/* Receive the oldest from highest priority messages in message queue
|
|
|
|
MQDES. */
|
|
|
|
extern ssize_t mq_receive (mqd_t __mqdes, char *__msg_ptr, size_t __msg_len,
|
2007-08-02 23:28:20 +02:00
|
|
|
unsigned int *__msg_prio) __nonnull ((2));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
/* Add message pointed by MSG_PTR to message queue MQDES. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern int mq_send (mqd_t __mqdes, __const char *__msg_ptr, size_t __msg_len,
|
|
|
|
unsigned int __msg_prio) __nonnull ((2));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
#ifdef __USE_XOPEN2K
|
|
|
|
/* Receive the oldest from highest priority messages in message queue
|
|
|
|
MQDES, stop waiting if ABS_TIMEOUT expires. */
|
|
|
|
extern ssize_t mq_timedreceive (mqd_t __mqdes, char *__restrict __msg_ptr,
|
|
|
|
size_t __msg_len,
|
|
|
|
unsigned int *__restrict __msg_prio,
|
2007-08-02 23:28:20 +02:00
|
|
|
__const struct timespec *__restrict __abs_timeout)
|
2007-08-03 11:51:21 +02:00
|
|
|
__nonnull ((2, 5));
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
/* Add message pointed by MSG_PTR to message queue MQDES, stop blocking
|
|
|
|
on full message queue if ABS_TIMEOUT expires. */
|
2007-08-02 23:28:20 +02:00
|
|
|
extern int mq_timedsend (mqd_t __mqdes, __const char *__msg_ptr,
|
2004-04-13 04:15:43 +02:00
|
|
|
size_t __msg_len, unsigned int __msg_prio,
|
2007-08-02 23:28:20 +02:00
|
|
|
__const struct timespec *__abs_timeout)
|
2007-08-03 11:51:21 +02:00
|
|
|
__nonnull ((2, 5));
|
2004-04-13 04:15:43 +02:00
|
|
|
#endif
|
|
|
|
|
* rt/Versions (librt): Export __mq_open_2@@GLIBC_2.7.
* rt/Makefile (headers): Add bits/mqueue2.h.
* rt/mqueue.h: Include bits/mqueue2.h if -D_FORTIFY_SOURCE=2,
optimizing with GCC and __va_arg_pack_len is defined.
* rt/bits/mqueue2.h: New file.
* rt/mq_open.c (__mq_open): Renamed from mq_open.
(mq_open): New strong_alias.
(__mq_open_2): New function.
* sysdeps/unix/sysv/linux/mq_open.c (__mq_open): Renamed from mq_open.
(mq_open): New strong_alias.
(__mq_open_2): New function.
* debug/Versions (libc): Export __fortify_fail@@GLIBC_PRIVATE.
* Versions.def (librt): Add GLIBC_2.7 version.
* debug/fortify_fail.c (__fortify_fail): Add libc_hidden_def.
* include/stdio.h (__fortify_fail): Add libc_hidden_proto.
* misc/sys/cdefs.h (__errordecl, __va_arg_pack_len): Define.
* io/fcntl.h: Include bits/fcntl2.h when __va_arg_pack_len
is defined rather than when not C++.
* io/bits/fcntl2.h (__open_alias, __open64_alias, __openat_alias,
__openat64_alias): New redirects.
(__open_too_many_args, __open_missing_mode, __open64_too_many_args,
__open64_missing_mode, __openat_too_many_args, __openat_missing_mode,
__openat64_too_many_args, __openat64_missing_mode): New __errordecls.
(open, open64, openat, openat64): Rewrite as __extern_always_inline
functions instead of function-like macros.
2007-09-16 00:35:27 +02:00
|
|
|
/* Define some inlines helping to catch common problems. */
|
|
|
|
#if __USE_FORTIFY_LEVEL > 0 && defined __extern_always_inline \
|
|
|
|
&& defined __va_arg_pack_len
|
|
|
|
# include <bits/mqueue2.h>
|
|
|
|
#endif
|
|
|
|
|
2005-10-23 22:38:06 +02:00
|
|
|
__END_DECLS
|
2004-04-13 04:15:43 +02:00
|
|
|
|
|
|
|
#endif /* mqueue.h */
|