[rtems-docs commit] c-user: Clarify constraints

Sebastian Huber sebh at rtems.org
Wed Apr 28 07:04:06 UTC 2021


Module:    rtems-docs
Branch:    master
Commit:    ad16b373f31778c013bfea860ba8ac3a8936292e
Changeset: http://git.rtems.org/rtems-docs/commit/?id=ad16b373f31778c013bfea860ba8ac3a8936292e

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue Apr 27 07:36:24 2021 +0200

c-user: Clarify constraints

---

 c-user/barrier/directives.rst         |  3 ++-
 c-user/clock/directives.rst           |  7 ++++---
 c-user/event/directives.rst           |  3 ++-
 c-user/message/directives.rst         |  9 ++++++---
 c-user/multiprocessing/directives.rst |  3 ++-
 c-user/semaphore/directives.rst       | 10 ++++++----
 6 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/c-user/barrier/directives.rst b/c-user/barrier/directives.rst
index 84dacc4..ec40844 100644
--- a/c-user/barrier/directives.rst
+++ b/c-user/barrier/directives.rst
@@ -410,4 +410,5 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
diff --git a/c-user/clock/directives.rst b/c-user/clock/directives.rst
index a13b5ef..4ed1c58 100644
--- a/c-user/clock/directives.rst
+++ b/c-user/clock/directives.rst
@@ -96,10 +96,11 @@ The following constraints apply to this directive:
 
 * The directive may be called from within any runtime context.
 
-* The directive may change the priority of another task which may preempt the
-  calling task.
+* The directive may change the priority of a task.  This may cause the calling
+  task to be preempted.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 .. Generated from spec:/rtems/clock/if/get-tod
 
diff --git a/c-user/event/directives.rst b/c-user/event/directives.rst
index 9d9bfe4..bf8f74c 100644
--- a/c-user/event/directives.rst
+++ b/c-user/event/directives.rst
@@ -115,7 +115,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 .. Generated from spec:/rtems/event/if/receive
 
diff --git a/c-user/message/directives.rst b/c-user/message/directives.rst
index 1634f09..c154a3b 100644
--- a/c-user/message/directives.rst
+++ b/c-user/message/directives.rst
@@ -589,7 +589,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within interrupt context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 * When the directive operates on a remote object, the directive sends a message
   to the remote node and waits for a reply.  This will preempt the calling
@@ -671,7 +672,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within interrupt context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 * When the directive operates on a remote object, the directive sends a message
   to the remote node and waits for a reply.  This will preempt the calling
@@ -764,7 +766,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within interrupt context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 * When the directive operates on a remote object, the directive sends a message
   to the remote node and waits for a reply.  This will preempt the calling
diff --git a/c-user/multiprocessing/directives.rst b/c-user/multiprocessing/directives.rst
index ad7c6e2..fc10640 100644
--- a/c-user/multiprocessing/directives.rst
+++ b/c-user/multiprocessing/directives.rst
@@ -71,4 +71,5 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
diff --git a/c-user/semaphore/directives.rst b/c-user/semaphore/directives.rst
index ce5deb0..45ed8c1 100644
--- a/c-user/semaphore/directives.rst
+++ b/c-user/semaphore/directives.rst
@@ -694,7 +694,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 * When the directive operates on a remote object, the directive sends a message
   to the remote node and waits for a reply.  This will preempt the calling
@@ -813,7 +814,8 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may unblock another task which may preempt the calling task.
+* The directive may unblock a task.  This may cause the calling task to be
+  preempted.
 
 * When the directive operates on a remote object, the directive sends a message
   to the remote node and waits for a reply.  This will preempt the calling
@@ -1017,5 +1019,5 @@ The following constraints apply to this directive:
 
 * The directive may be called from within task context.
 
-* The directive may change the priority of another task which may preempt the
-  calling task.
+* The directive may change the priority of a task.  This may cause the calling
+  task to be preempted.



More information about the vc mailing list