RTEMS 4.7.99.2 On-Line Library

Region Manager REGION_IDENT - Get ID of a region

RTEMS Ada User's Guide

14.4.2: REGION_IDENT - Get ID of a region

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - region identified successfully
RTEMS.INVALID_ADDRESS - id is NULL
RTEMS.INVALID_NAME - region name not found

DESCRIPTION:

This directive obtains the region id associated with the region name to be acquired. If the region name is not unique, then the region id will match one of the regions with that name. However, this region id is not guaranteed to correspond to the desired region. The region id is used to access this region in other region manager directives.

NOTES:

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

RTEMS Ada User's Guide