T-Kernel Specification (1.B0.02)

4.1. TASK MANAGEMENT FUNCTIONS 31
tk del tsk
Delete Task
[C Language Interface]
ER ercd = tk_del_tsk ( ID tskid ) ;
[Parameters]
ID tskid Task ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
Normal completion
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist)
Invalid object state (the task is not in DORMANT state)
[Description]
Deletes the task designated in tskid.
This system call changes the state of the task designated in tskid from DORMANT state to NON-
EXISTENT state (no longer exists in the system), releasing the TCB and stack area that were assigned
to the task. The task ID number is also released. When this system call is issued for a task not in
DORMANT state, error code E OBJ is returned.
This system call cannot designate the invoking task. If the invoking task is designated, error code E OBJ
is returned since the invoking task is not in DORMANT state. The invoking task is deleted not by this
system call but by the tk exd tsk system call.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02