[PATCH rtems-docs 1/2] c-user/message/operations.rst: Don't claim atomic

Martin Erik Werner martinerikwerner at gmail.com
Sat Feb 11 16:27:23 UTC 2023


rtems_message_queue_broadcast() is not atomic, since it unblocks each
task after copying the message into their message buffer. So remove the
wording indicating that it is atomic.

Also reword the overall description slightly with "each" instead of
"every", and add "until no more tasks remain", in order to further hint
at the non-atomicity of the operation.

Update #4804.
---
 c-user/message/operations.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/c-user/message/operations.rst b/c-
user/message/operations.rst
index 4d34661..46081a3 100644
--- a/c-user/message/operations.rst
+++ b/c-user/message/operations.rst
@@ -70,8 +70,8 @@ queue which has a full queue of pending messages.
 Broadcasting a Message
 ----------------------
 
-The ``rtems_message_queue_broadcast`` directive sends the same message
to every
-task waiting on the specified message queue as an atomic operation. 
The
+The ``rtems_message_queue_broadcast`` directive sends the same message
to each
+task waiting on the specified message queue until no more tasks
remain.  The
 message is copied to each waiting task's message buffer and each task
is
 unblocked.  The number of tasks which were unblocked is returned to
the caller.
 
-- 
2.30.2




More information about the devel mailing list