|
@@ -1,9 +1,23 @@
|
|
-/*
|
|
+/* Copyright (C) 2004, 2005 Free Software Foundation, Inc.
|
|
- * mqueue.h - definitions and function prototypes for POSIX mqueue support.
|
|
+ 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
|
|
#ifndef _MQUEUE_H
|
|
-#define _MQUEUE_H
|
|
+#define _MQUEUE_H 1
|
|
|
|
|
|
#include <features.h>
|
|
#include <features.h>
|
|
#include <sys/types.h>
|
|
#include <sys/types.h>
|
|
@@ -12,86 +26,65 @@
|
|
#include <bits/siginfo.h>
|
|
#include <bits/siginfo.h>
|
|
#define __need_timespec
|
|
#define __need_timespec
|
|
#include <time.h>
|
|
#include <time.h>
|
|
-
|
|
+/* Get the definition of mqd_t and struct mq_attr. */
|
|
-typedef int mqd_t;
|
|
+#include <bits/mqueue.h>
|
|
-
|
|
|
|
-struct mq_attr {
|
|
|
|
- long int mq_flags; /* Message queue flags */
|
|
|
|
- long int mq_maxmsg; /* Maximum number of messages */
|
|
|
|
- long int mq_msgsize; /* Maximum message size */
|
|
|
|
- long int mq_curmsgs; /* Number of messages currently queued */
|
|
|
|
- long int __pad[4];
|
|
|
|
-};
|
|
|
|
|
|
|
|
__BEGIN_DECLS
|
|
__BEGIN_DECLS
|
|
|
|
|
|
-/*
|
|
+/* Establish connection between a process and a message queue NAME and
|
|
- * Establish connection between a process and a message queue __name and
|
|
+ return message queue descriptor or (mqd_t) -1 on error. OFLAG determines
|
|
- * 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
|
|
- * 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
|
|
- * 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
|
|
- * argument is taken as `struct mq_attr *', pointer to message queue
|
|
+ attributes. If the fourth argument is NULL, default attributes are
|
|
- * attributes. If the fourth argument is NULL, default attributes are used.
|
|
+ used. */
|
|
- */
|
|
+extern mqd_t mq_open (const char *__name, int __oflag, ...) __THROW;
|
|
-extern mqd_t mq_open(const char *__name, int __oflag, ...) __THROW;
|
|
+
|
|
-
|
|
+/* Removes the association between message queue descriptor MQDES and its
|
|
-/*
|
|
+ message queue. */
|
|
- * Remove the association between message queue descriptor __mqdes and its
|
|
+extern int mq_close (mqd_t __mqdes) __THROW;
|
|
- * message queue.
|
|
+
|
|
- */
|
|
+/* Query status and attributes of message queue MQDES. */
|
|
-extern int mq_close(mqd_t __mqdes) __THROW;
|
|
+extern int mq_getattr (mqd_t __mqdes, struct mq_attr *__mqstat) __THROW;
|
|
-
|
|
+
|
|
-/* Query status and attributes of message queue __mqdes */
|
|
+/* Set attributes associated with message queue MQDES and if OMQSTAT is
|
|
-extern int mq_getattr(mqd_t __mqdes, struct mq_attr *__mqstat) __THROW;
|
|
+ not NULL also query its old attributes. */
|
|
-
|
|
+extern int mq_setattr (mqd_t __mqdes,
|
|
-/*
|
|
+ const struct mq_attr *__restrict __mqstat,
|
|
- * Set attributes associated with message queue __mqdes and if __omqstat is
|
|
+ struct mq_attr *__restrict __omqstat) __THROW;
|
|
- * not NULL also query its old attributes.
|
|
+
|
|
- */
|
|
+/* Remove message queue named NAME. */
|
|
-extern int mq_setattr(mqd_t __mqdes,
|
|
+extern int mq_unlink (const char *__name) __THROW;
|
|
- const struct mq_attr *__restrict __mqstat,
|
|
+
|
|
- struct mq_attr *__restrict __omqstat) __THROW;
|
|
+/* Register notification issued upon message arrival to an empty
|
|
-
|
|
+ message queue MQDES. */
|
|
-/* Remove message queue named __name */
|
|
+extern int mq_notify (mqd_t __mqdes, const struct sigevent *__notification)
|
|
-extern int mq_unlink(const char *__name) __THROW;
|
|
|
|
-
|
|
|
|
-/*
|
|
|
|
- * Register notification upon message arrival to an empty message queue
|
|
|
|
- * __mqdes
|
|
|
|
- */
|
|
|
|
-extern int mq_notify(mqd_t __mqdes, const struct sigevent *__notification)
|
|
|
|
__THROW;
|
|
__THROW;
|
|
|
|
|
|
-/*
|
|
+/* Receive the oldest from highest priority messages in message queue
|
|
- * Receive the oldest from highest priority messages in message queue
|
|
+ MQDES. */
|
|
- * __mqdes
|
|
+extern ssize_t mq_receive (mqd_t __mqdes, char *__msg_ptr, size_t __msg_len,
|
|
- */
|
|
+ unsigned int *__msg_prio);
|
|
-extern ssize_t mq_receive(mqd_t __mqdes, char *__msg_ptr, size_t __msg_len,
|
|
|
|
- unsigned int *__msg_prio);
|
|
|
|
|
|
|
|
-/* Add message pointed by __msg_ptr to message queue __mqdes */
|
|
+/* Add message pointed by MSG_PTR to message queue MQDES. */
|
|
-extern int mq_send(mqd_t __mqdes, const char *__msg_ptr, size_t __msg_len,
|
|
+extern int mq_send (mqd_t __mqdes, const char *__msg_ptr, size_t __msg_len,
|
|
- unsigned int __msg_prio);
|
|
+ unsigned int __msg_prio);
|
|
|
|
|
|
#ifdef __USE_XOPEN2K
|
|
#ifdef __USE_XOPEN2K
|
|
-/*
|
|
+/* Receive the oldest from highest priority messages in message queue
|
|
- * Receive the oldest from highest priority messages in message queue
|
|
+ MQDES, stop waiting if ABS_TIMEOUT expires. */
|
|
- * __mqdes, stop waiting if __abs_timeout expires.
|
|
+extern ssize_t mq_timedreceive (mqd_t __mqdes, char *__restrict __msg_ptr,
|
|
- */
|
|
+ size_t __msg_len,
|
|
-extern ssize_t mq_timedreceive(mqd_t __mqdes, char *__restrict __msg_ptr,
|
|
+ unsigned int *__restrict __msg_prio,
|
|
- size_t __msg_len,
|
|
+ const struct timespec *__restrict __abs_timeout);
|
|
- unsigned int *__restrict __msg_prio,
|
|
+
|
|
- const struct timespec *__restrict __abs_timeout);
|
|
+/* Add message pointed by MSG_PTR to message queue MQDES, stop blocking
|
|
-
|
|
+ on full message queue if ABS_TIMEOUT expires. */
|
|
-/*
|
|
+extern int mq_timedsend (mqd_t __mqdes, const char *__msg_ptr,
|
|
- * Add message pointed by __msg_ptr to message queue __mqdes, stop blocking
|
|
+ size_t __msg_len, unsigned int __msg_prio,
|
|
- * on full message queue if __abs_timeout expires.
|
|
+ const struct timespec *__abs_timeout);
|
|
- */
|
|
|
|
-extern int mq_timedsend(mqd_t __mqdes, const char *__msg_ptr,
|
|
|
|
- size_t __msg_len, unsigned int __msg_prio,
|
|
|
|
- const struct timespec *__abs_timeout);
|
|
|
|
#endif
|
|
#endif
|
|
|
|
|
|
__END_DECLS
|
|
__END_DECLS
|
|
|
|
|
|
-#endif
|
|
+#endif /* mqueue.h */
|