RTEMS ITRON 3.0 API User's Guide
ER ercd =pget_blf( VP *p_blf, ID mpfid );
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))
The pget_blf system call has the same function as get_blf except for the waiting feature. Pget_blf polls whether or not the task should wait if get_blf is executed. The meaning of parameters to pget_blf are the same with get_blf. The specific operations by pget_blf are as follows.
- If there is a free memory block available, processing is the same as get_blf: that is, the requested memory is allocated and the system call completes normally.
- If there is no free memory block, an E_TMOUT error is returned to indicate polling failed and the system call finishes. Unlike get_blf, the issuing task does not wait in this case. Also, the issuing task does not get any memory.
NONE
RTEMS ITRON 3.0 API User's Guide
Copyright © 1988-2007OAR Corporation