c-user: Mention possible preemptions

Mention that object create/delete may case the calling task to be
preempted due to the object allocator mutex.
This commit is contained in:
Sebastian Huber 2020-06-15 14:13:48 +02:00
parent a517a09856
commit 1f8301a972
7 changed files with 32 additions and 13 deletions

View File

@ -218,7 +218,8 @@ DESCRIPTION:
the tasks waiting at the barrier unblocked.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The following barrier attribute constants are defined by RTEMS:
@ -309,6 +310,9 @@ DESCRIPTION:
barrier is reclaimed by RTEMS.
NOTES:
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The calling task will be preempted if it is enabled by the task's execution
mode and a higher priority local task is waiting on the deleted barrier.
The calling task will NOT be preempted if all of the tasks that are waiting

View File

@ -142,11 +142,12 @@ DESCRIPTION:
is not used to store the DPCB.
NOTES:
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The internal_address and external_address parameters must be on a four byte
boundary.
This directive will not cause the calling task to be preempted.
.. raw:: latex
\clearpage
@ -222,7 +223,8 @@ DESCRIPTION:
DPCB for the deleted dual-ported memory area is reclaimed by RTEMS.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The calling task does not have to be the task that created the port. Any
local task that knows the port id can delete the port.

View File

@ -273,7 +273,8 @@ DESCRIPTION:
specified, waiting tasks are serviced in First In-First Out order.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The following message queue attribute constants are defined by RTEMS:
@ -396,6 +397,9 @@ DESCRIPTION:
message buffers is reclaimed by RTEMS.
NOTES:
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The calling task will be preempted if its preemption mode is enabled and
one or more local tasks with a higher priority than the calling task are
waiting on the deleted queue. The calling task will NOT be preempted if

View File

@ -192,7 +192,8 @@ DESCRIPTION:
local PTCB free pool and initializes it.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The partition buffer area specified by the ``starting_address`` must be
properly aligned. It must be possible to directly store target
@ -360,7 +361,8 @@ DESCRIPTION:
deleted partition is reclaimed by RTEMS.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The calling task does not have to be the task that created the partition.
Any local task that knows the partition id can delete the partition.

View File

@ -666,7 +666,8 @@ DESCRIPTION:
pool and initializes it.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
.. raw:: latex
@ -785,7 +786,8 @@ DESCRIPTION:
period is reclaimed by RTEMS.
NOTES:
This directive will not cause the running task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
A rate monotonic period can be deleted by a task other than the task which
created the period.

View File

@ -376,7 +376,8 @@ DESCRIPTION:
are serviced in First In-First Out order.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The priority inheritance and priority ceiling algorithms are only supported
for local, binary semaphores that use the priority task wait queue blocking
@ -523,6 +524,9 @@ DESCRIPTION:
this semaphore is reclaimed by RTEMS.
NOTES:
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
The calling task will be preempted if it is enabled by the task's execution
mode and a higher priority local task is waiting on the deleted semaphore.
The calling task will NOT be preempted if all of the tasks that are waiting

View File

@ -487,8 +487,8 @@ DESCRIPTION:
specified by :c:data:`table` is copied to the ESCB.
NOTES:
This directive will not cause the calling task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
.. raw:: latex
@ -566,7 +566,8 @@ DESCRIPTION:
deleted extension set is reclaimed by RTEMS.
NOTES:
This directive will not cause the running task to be preempted.
This directive may cause the calling task to be preempted due to an
obtain and release of the object allocator mutex.
A extension set can be deleted by a task other than the task which created
the extension set.