summaryrefslogtreecommitdiffstats
path: root/cpukit/posix/include/mqueue.h
diff options
context:
space:
mode:
authorMathew Kallada <matkallada@gmail.com>2012-12-13 20:51:15 -0500
committerGedare Bloom <gedare@rtems.org>2012-12-13 20:51:15 -0500
commita0e6c73850390b97a1f620173fa78802440d2168 (patch)
treea97f2dd238a89461175a223490b5821a92993bdc /cpukit/posix/include/mqueue.h
parentlibcsupport: Doxygen enhancement task #9 (diff)
downloadrtems-a0e6c73850390b97a1f620173fa78802440d2168.tar.bz2
posix: Doxygen enhancement task #4
http://www.google-melange.com/gci/task/view/google/gci2012/7955219
Diffstat (limited to 'cpukit/posix/include/mqueue.h')
-rw-r--r--cpukit/posix/include/mqueue.h23
1 files changed, 22 insertions, 1 deletions
diff --git a/cpukit/posix/include/mqueue.h b/cpukit/posix/include/mqueue.h
index 1472983593..56a97a0c7a 100644
--- a/cpukit/posix/include/mqueue.h
+++ b/cpukit/posix/include/mqueue.h
@@ -26,6 +26,13 @@
#include <rtems/system.h>
#include <rtems/score/object.h>
+/**
+ * @defgroup POSIX_MQUEUE Message Queues
+ *
+ * @ingroup POSIX
+ */
+/**@{*/
+
#ifdef __cplusplus
extern "C" {
#endif
@@ -72,7 +79,21 @@ int mq_close(
);
/**
+ * @brief Remove a Message Queue
+ *
* 15.2.2 Remove a Message Queue, P1003.1b-1993, p. 276
+ *
+ * NOTE: The structure of the routines is identical to that of POSIX
+ * Message_queues to leave the option of having unnamed message
+ * queues at a future date. They are currently not part of the
+ * POSIX standard but unnamed message_queues are. This is also
+ * the reason for the apparently unnecessary tracking of
+ * the process_shared attribute. [In addition to the fact that
+ * it would be trivial to add pshared to the mq_attr structure
+ * and have process private message queues.]
+ *
+ * This code ignores the O_RDONLY/O_WRONLY/O_RDWR flag at open
+ * time.
*/
int mq_unlink(
const char *name
@@ -167,6 +188,6 @@ int mq_getattr(
#endif
#endif /* _POSIX_MESSAGE_PASSING */
-
+/**@}*/
#endif
/* end of include file */