RTEMS 4.8.0 On-Line Library

Region Manager REGION_EXTEND - Add memory to a region

RTEMS C User's Guide

14.4.4: REGION_EXTEND - Add memory to a region

CALLING SEQUENCE:

rtems_status_code rtems_region_extend(
  rtems_id  id,
  void     *starting_address,
  uint32_t  length
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - region extended successfully
RTEMS_INVALID_ADDRESS - starting_address is NULL
RTEMS_INVALID_ID - invalid region id
RTEMS_INVALID_ADDRESS - invalid address of area to add

DESCRIPTION:

This directive adds the memory which starts at starting_address for length bytes to the region specified by id.

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 extend the region.

RTEMS C User's Guide