RTEMS 4.8.0 On-Line Library

Region Manager REGION_IDENT - Get ID of a region

RTEMS C User's Guide

14.4.2: REGION_IDENT - Get ID of a region

CALLING SEQUENCE:

rtems_status_code rtems_region_ident(
  rtems_name  name,
  rtems_id   *id
);

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