RTEMS 4.5.1-pre3 On-Line Library

Region Manager REGION_DELETE - Delete a region

RTEMS Ada User's Guide

14.4.3: REGION_DELETE - Delete a region

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - region deleted successfully
RTEMS.INVALID_ID - invalid region id
RTEMS.RESOURCE_IN_USE - segments still in use

DESCRIPTION:

This directive deletes the region specified by id. The region cannot be deleted if any of its segments are still allocated. The RNCB for the deleted region is reclaimed by RTEMS.

NOTES:

This directive will not cause the calling task to be preempted.

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

RTEMS Ada User's Guide