RTEMS 4.6.0pre5 On-Line Library

Fixed Block Manager del_mpf - Delete Fixed-Size Memorypool

RTEMS ITRON 3.0 API User's Guide

10.4.2: del_mpf - Delete Fixed-Size Memorypool

CALLING SEQUENCE:

ER del_mpf(
  ID mpfid
);

STATUS CODES:

E_OK - Normal Completion

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

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

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

DESCRIPTION:

This system call deletes the fixed-size memorypool specified by mpfid. 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. This system call will complete normally even if there are tasks waiting to get memory blocks from the memorypool. In that case, an E_DLT error will be returned to each waiting task.

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