RTEMS 4.5.1-pre3 On-Line Library

Memory Pool Manager del_mpl - Delete Variable-Size Memorypool

RTEMS ITRON 3.0 API User's Guide

9.4.2: del_mpl - Delete Variable-Size Memorypool

CALLING SEQUENCE:

ER del_mpl(
  ID mplid
);

STATUS CODES:

E_OK - Normal Completion

E_ID - Invalid ID number (mplid was invalid or could not be used)

E_NOEXS - Object does not exist (the memorypool specified by mplid does not exist)

E_OACV - Object access violation (A mplid less than -4 was specified from a user task. This is implementation dependent.)

DESCRIPTION:

This system call deletes the variable-size memorypool specified by mplid. No check or error report is performed even if there are tasks using memory from the memorypool to be deleted. This system call completes normally even if some of the memory blocks are not returned. Issuing this system call causes memory used for the control block of the associated memorypool and the memory area making up the memorypool itself to be released. After this system call is invoked, another memorypool having the same ID number can be created.

NOTES:

When a memorypool being waited for by more than one tasks is deleted, the order of tasks on the ready queue after the WAIT state is cleared is implementation dependent in the case of tasks having the same priority.

RTEMS ITRON 3.0 API User's Guide