summaryrefslogtreecommitdiffstats
path: root/doc/posix_users
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2000-01-13 19:20:17 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2000-01-13 19:20:17 +0000
commit2cef9771fba2775c07adea5c7544509e7736b8c0 (patch)
treea6b0037b00e88f657fb5c6df925eb20980e054be /doc/posix_users
parent+ Added comments (diff)
downloadrtems-2cef9771fba2775c07adea5c7544509e7736b8c0.tar.bz2
Added POSIX interpretation subsection and updated status.
The message queue manager chapter needs to be updated to reflect completion of the implementation.
Diffstat (limited to 'doc/posix_users')
-rw-r--r--doc/posix_users/message.t15
-rw-r--r--doc/posix_users/status.t5
2 files changed, 16 insertions, 4 deletions
diff --git a/doc/posix_users/message.t b/doc/posix_users/message.t
index 78261f978c..5c0b6aed8c 100644
--- a/doc/posix_users/message.t
+++ b/doc/posix_users/message.t
@@ -123,6 +123,21 @@ by passing a NULL to mq_notify, this removes any notification request
attached to the queue. Whenever the message queue is closed, all
notification attachments are removed.
+@subsection POSIX Interpretation Issues
+
+There is one significant point of interpretation related to
+the RTEMS implementation of POSIX message queues:
+
+@cite{What happens to threads already blocked on a message queue when the
+mode of that same message queue is changed from blocking to non-blocking?}
+
+
+The RTEMS POSIX implementation decided to unblock all waiting tasks
+with an @code{EAGAIN} status just as if a non-blocking version of
+the same operation had returned unsatisfied. This case is not
+discussed in the POSIX standard and other implementations may have
+chosen alternative behaviors.
+
@section Operations
@subsection Opening or Creating a Message Queue
diff --git a/doc/posix_users/status.t b/doc/posix_users/status.t
index 873ab54547..00b6d12c80 100644
--- a/doc/posix_users/status.t
+++ b/doc/posix_users/status.t
@@ -26,7 +26,6 @@ when porting existing code from UNIX to RTEMS.
@item The current implementation of @code{dup()} is insufficient.
@item FIFOs @code{mkfifo()} are not currently implemented.
@item Asynchronous IO is not implemented.
-@item Blocking Send for Message Queues is not implemented
@item The @code{flockfile()} family is not implemented
@item getc/putc unlocked family is not implemented
@item Shared Memory is not implemented
@@ -41,8 +40,6 @@ level of support is appropriate and possible for RTEMS.
@item Functional Testing
@itemize @bullet
-@item Named Semaphores are untested.
-@item There is currently no Message Queue test.
@item Tests for unimplemented services
@end itemize
@@ -53,7 +50,7 @@ level of support is appropriate and possible for RTEMS.
@item Documentation
@itemize @bullet
-@item Many of the service description pages are completed in this
+@item Many of the service description pages are not complete in this
manual. These need to be completed and information added to the
background and operations sections.
@item Example programs (not just tests) would be very nice.