From a0e6c73850390b97a1f620173fa78802440d2168 Mon Sep 17 00:00:00 2001 From: Mathew Kallada Date: Thu, 13 Dec 2012 20:51:15 -0500 Subject: posix: Doxygen enhancement task #4 http://www.google-melange.com/gci/task/view/google/gci2012/7955219 --- cpukit/posix/include/mqueue.h | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) (limited to 'cpukit/posix/include/mqueue.h') 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 #include +/** + * @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 */ -- cgit v1.2.3