RTEMS 4.9.2 On-Line Library

Barrier Manager BARRIER_DELETE - Delete a barrier

RTEMS C User's Guide

20.4.3: BARRIER_DELETE - Delete a barrier

CALLING SEQUENCE:

rtems_status_code rtems_barrier_delete(
  rtems_id id
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - barrier deleted successfully
RTEMS_INVALID_ID - invalid barrier id@

DESCRIPTION:

This directive deletes the barrier specified by id. All tasks blocked waiting for the barrier to be released will be readied and returned a status code which indicates that the barrier was deleted. The BCB for this barrier is reclaimed by RTEMS.

NOTES:

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 on the barrier are remote tasks.

The calling task does not have to be the task that created the barrier. Any local task that knows the barrier id can delete the barrier.

RTEMS C User's Guide