mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-05-02 19:31:06 -04:00
8c87469263
The old traceTASK_NOTIFY_WAIT hook was always called (no matter the success or failure of the action) and did not hygienically expose enough information for the tracer to determine the state of the task notification after it has been taken. The new traceTASK_NOTIFY_WAIT_EXT hook is called only if the notification was taken successfully and hygienically expose ulBitsToClearOnExit. The new traceTASK_NOTIFY_WAIT_FAILED hook is called if the notification could not be taken. This matches how the tracing hooks for all other APIs that attempt to receive/take a resource and my block function: First, if the task blocks, a BLOCK or BLOCKING trace hook is called. Then, either a normal or FAILED trace hook is called, indicating if the operation timed out or succeeded. Both hooks fall back on the old traceTASK_NOTIFY_WAIT, preserving its functionality for backwards compatibility. Not that there is a very slight breaking change in this commit: traceTASK_NOTIFY_WAIT is now called after the out-var pulNotificationValue is set. Because this pointer was in an unknown/user-set state when the tracing hook was previously called, it is highly unlikely that there are any tracers that rely on this. |
||
|---|---|---|
| .. | ||
| atomic.h | ||
| CMakeLists.txt | ||
| croutine.h | ||
| deprecated_definitions.h | ||
| event_groups.h | ||
| FreeRTOS.h | ||
| list.h | ||
| message_buffer.h | ||
| mpu_prototypes.h | ||
| mpu_syscall_numbers.h | ||
| mpu_wrappers.h | ||
| newlib-freertos.h | ||
| picolibc-freertos.h | ||
| portable.h | ||
| projdefs.h | ||
| queue.h | ||
| semphr.h | ||
| stack_macros.h | ||
| StackMacros.h | ||
| stdint.readme | ||
| stream_buffer.h | ||
| task.h | ||
| timers.h | ||