From ad16b373f31778c013bfea860ba8ac3a8936292e Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Tue, 27 Apr 2021 07:36:24 +0200 Subject: 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. -- cgit v1.2.3