OAR

RTEMS 4.0.0 On-Line Library


Region Manager REGION_EXTEND - Add memory to a region

PREV UP NEXT Bookshelf RTEMS C User's Guide

13.4.4: REGION_EXTEND - Add memory to a region

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - region extended successfully
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.


PREV UP NEXT Bookshelf RTEMS C User's Guide

Copyright © 1988-1998 OAR Corporation