RTEMS 4.7.2 On-Line Library

Region Manager REGION_DELETE - Delete a region

RTEMS C User's Guide

14.4.3: REGION_DELETE - Delete a region

CALLING SEQUENCE:

rtems_status_code rtems_region_delete(
  rtems_id id
);

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