RTEMS 4.8.0 On-Line Library

Fixed Block Manager get_blf - Get Fixed-Size Memory Block

RTEMS ITRON 3.0 API User's Guide

10.4.3: get_blf - Get Fixed-Size Memory Block

CALLING SEQUENCE:

ER get_blf(
  VP *p_blf,
  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.)

E_PAR - Parameter error (tmout is -2 or less)

E_DLT - The object being waited for was deleted (the specified memorypool was deleted while waiting)

E_RLWAI - WAIT state was forcibly released (rel_wai was received while waiting)

E_TMOUT - Polling failure or timeout exceeded

E_CTX - Context error (issued from task-independent portions or a task in dispatch disabled state; implementation dependent for pget_blf and tget_blf(tmout=TMO_POL))

DESCRIPTION:

A memory block is allocated from the fixed-size memorypool specified by mpfid. The start address of the memory block allocated is returned to blf. The size of the memory block allocated is specified by the blfsz parameter when the fixed-size memorypool was created. The allocated memory block is not cleared to zero. The contents of the allocated memory block are undefined. If the memory block cannot be obtained from the specified memorypool when get_blf is issued, the task issuing get_blf will be placed on the memory allocation queue of the specified memorypool, and wait until it can get the memory it requires. If the object being waited for is deleted (the specified memorypool is deleted while waiting), an E_DLT error will be returned.

NOTES:

NONE

RTEMS ITRON 3.0 API User's Guide