RTEMS 4.8.0 On-Line Library

Barrier Manager BARRIER_DELETE - Delete a barrier

RTEMS Ada User's Guide

20.4.3: BARRIER_DELETE - Delete a barrier

CALLING SEQUENCE:

procedure Barrier_Delete (
   ID     : in     RTEMS.ID;
   Result :    out RTEMS.Status_Codes
);

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 Ada User's Guide