RTEMS 4.5.0 On-Line Library

Task-Dependent Synchronization Manager slp_tsk - Sleep Task Sleep Task with Timeout

RTEMS ITRON 3.0 API User's Guide

2.3.4: slp_tsk - Sleep Task Sleep Task with Timeout

CALLING SEQUENCE:

ER slp_tsk( void );

STATUS CODES:

E_OK - Normal Completion

E_PAR - Parameter error (a timeout value -2 or less was specified)

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)

DESCRIPTION:

This system call puts the issuing task (which was in RUN state) into WAIT state, causing the issuing task to sleep until wup_tsk is invoked.

NOTES:

Since the slp_tsk system call causes the issuing task to enter WAIT state, slp_tsk calls may not be nested. It is possible, however, for another task to execute a sus_tsk on a task which has put itself in WAIT state using slp_tsk. If this happens, the task will enter the combined WAIT-SUSPEND state.

No polling function for slp_tsk is provided. A similar function can be implemented if necessary using can_wup.

RTEMS ITRON 3.0 API User's Guide