mirror of
https://git.rtems.org/rtems-docs/
synced 2025-06-03 17:10:35 +08:00
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:
parent
a517a09856
commit
1f8301a972
@ -218,7 +218,8 @@ DESCRIPTION:
|
|||||||
the tasks waiting at the barrier unblocked.
|
the tasks waiting at the barrier unblocked.
|
||||||
|
|
||||||
NOTES:
|
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:
|
The following barrier attribute constants are defined by RTEMS:
|
||||||
|
|
||||||
@ -309,6 +310,9 @@ DESCRIPTION:
|
|||||||
barrier is reclaimed by RTEMS.
|
barrier is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
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.
|
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
|
The calling task will NOT be preempted if all of the tasks that are waiting
|
||||||
|
@ -142,11 +142,12 @@ DESCRIPTION:
|
|||||||
is not used to store the DPCB.
|
is not used to store the DPCB.
|
||||||
|
|
||||||
NOTES:
|
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
|
The internal_address and external_address parameters must be on a four byte
|
||||||
boundary.
|
boundary.
|
||||||
|
|
||||||
This directive will not cause the calling task to be preempted.
|
|
||||||
|
|
||||||
.. raw:: latex
|
.. raw:: latex
|
||||||
|
|
||||||
\clearpage
|
\clearpage
|
||||||
@ -222,7 +223,8 @@ DESCRIPTION:
|
|||||||
DPCB for the deleted dual-ported memory area is reclaimed by RTEMS.
|
DPCB for the deleted dual-ported memory area is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
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.
|
local task that knows the port id can delete the port.
|
||||||
|
@ -273,7 +273,8 @@ DESCRIPTION:
|
|||||||
specified, waiting tasks are serviced in First In-First Out order.
|
specified, waiting tasks are serviced in First In-First Out order.
|
||||||
|
|
||||||
NOTES:
|
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:
|
The following message queue attribute constants are defined by RTEMS:
|
||||||
|
|
||||||
@ -396,6 +397,9 @@ DESCRIPTION:
|
|||||||
message buffers is reclaimed by RTEMS.
|
message buffers is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
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
|
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
|
waiting on the deleted queue. The calling task will NOT be preempted if
|
||||||
|
@ -192,7 +192,8 @@ DESCRIPTION:
|
|||||||
local PTCB free pool and initializes it.
|
local PTCB free pool and initializes it.
|
||||||
|
|
||||||
NOTES:
|
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
|
The partition buffer area specified by the ``starting_address`` must be
|
||||||
properly aligned. It must be possible to directly store target
|
properly aligned. It must be possible to directly store target
|
||||||
@ -360,7 +361,8 @@ DESCRIPTION:
|
|||||||
deleted partition is reclaimed by RTEMS.
|
deleted partition is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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.
|
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.
|
Any local task that knows the partition id can delete the partition.
|
||||||
|
@ -666,7 +666,8 @@ DESCRIPTION:
|
|||||||
pool and initializes it.
|
pool and initializes it.
|
||||||
|
|
||||||
NOTES:
|
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
|
.. raw:: latex
|
||||||
|
|
||||||
@ -785,7 +786,8 @@ DESCRIPTION:
|
|||||||
period is reclaimed by RTEMS.
|
period is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
A rate monotonic period can be deleted by a task other than the task which
|
||||||
created the period.
|
created the period.
|
||||||
|
@ -376,7 +376,8 @@ DESCRIPTION:
|
|||||||
are serviced in First In-First Out order.
|
are serviced in First In-First Out order.
|
||||||
|
|
||||||
NOTES:
|
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
|
The priority inheritance and priority ceiling algorithms are only supported
|
||||||
for local, binary semaphores that use the priority task wait queue blocking
|
for local, binary semaphores that use the priority task wait queue blocking
|
||||||
@ -523,6 +524,9 @@ DESCRIPTION:
|
|||||||
this semaphore is reclaimed by RTEMS.
|
this semaphore is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
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.
|
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
|
The calling task will NOT be preempted if all of the tasks that are waiting
|
||||||
|
@ -487,8 +487,8 @@ DESCRIPTION:
|
|||||||
specified by :c:data:`table` is copied to the ESCB.
|
specified by :c:data:`table` is copied to the ESCB.
|
||||||
|
|
||||||
NOTES:
|
NOTES:
|
||||||
|
This directive may cause the calling task to be preempted due to an
|
||||||
This directive will not cause the calling task to be preempted.
|
obtain and release of the object allocator mutex.
|
||||||
|
|
||||||
.. raw:: latex
|
.. raw:: latex
|
||||||
|
|
||||||
@ -566,7 +566,8 @@ DESCRIPTION:
|
|||||||
deleted extension set is reclaimed by RTEMS.
|
deleted extension set is reclaimed by RTEMS.
|
||||||
|
|
||||||
NOTES:
|
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
|
A extension set can be deleted by a task other than the task which created
|
||||||
the extension set.
|
the extension set.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user