RTEMS 4.8.0 On-Line Library

Fixed Block Manager tget_blf - Get Fixed-Size Memory Block with Timeout

RTEMS ITRON 3.0 API User's Guide

10.4.5: tget_blf - Get Fixed-Size Memory Block with Timeout

CALLING SEQUENCE:

ER ercd =tget_blf(
  VP *p_blf,
  ID mpfid,
  TMO tmout
);

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:

The tget_blf system call has the same function as get_blf with an additional timeout feature. A maximum wait time (timeout value) can be specified using the parameter tmout. When a timeout is specified, a timeout error, E_TMOUT, will result and the system call will finish if the period specified by tmout elapses without conditions for releasing wait being satisfied (i.e. without free memory becoming available).

NOTES:

NONE

RTEMS ITRON 3.0 API User's Guide