[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