T-Kernel Specification (1.B0.02)

4.2. TASK-DEPENDENT SYNCHRONIZATION FUNCTIONS 63
tk dly tsk
Delay Task
[C Language Interface]
ER ercd = tk_dly_tsk ( RELTIM dlytim ) ;
[Parameters]
RELTIM dlytim Delay time
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E NOMEM
E PAR
E CTX
E RLWAI
E DISWAI
Normal completion
Insufficient memory
Parameter error (dlytim is invalid)
Context error (issued from task-independent portion or in dispatch disabled state)
Wait state released (tk rel wai received in wait state)
Wait released by wait disabled state
[Description]
Temporarily stops execution of the invoking task and waits for time dlytim to elapse. The state while
the task waits for the delay time to elapse is a WAIT state and is subject to release by tk rel wai.
If the task issuing this system call goes to SUSPEND state or WAIT-SUSPEND state while it is waiting
for the delay time to elapse, the time continues to be counted in the SUSPEND state.
The time base for dlytim (time unit) is the same as that for system time (= 1 ms).
[Additional Notes]
This system call differs from tk slp tsk in that normal completion, not an error code, is returned when
the delay time elapses and tk dly tsk terminates. Moreover, the wait is not released even if tk wup tsk
is executed during the delay time. The only way to terminate tk dly tsk before the delay time elapses
is by calling tk ter tsk or tk rel wai.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02