T-Kernel Specification (1.B0.02)

4.3. TASK EXCEPTION HANDLING FUNCTIONS 73
tk ras tex
Raise Task Exception
[C Language Interface]
ER ercd = tk_ras_tex ( ID tskid, INT texcd ) ;
[Parameters]
ID tskid Task ID
INT texcd Task exception code (0 to 31)
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
E PAR
E CTX
Normal completion
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist or no task exception
handler is defined)
Invalid object state (called for a task in DORMANT state)
Parameter error (texcd is invalid or cannot be used)
Context error (issued from task-independent portion or in dispatch disabled state)
[Description]
Raises the task exception designated in texcd for the task designated in tskid.
If a task exception handler is already running in the task designated in tskid, the newly raised task
exception is made pending. If an exception is pending, a break function is not executed even if the
target task is executing an extended SVC. In the case of texcd = 0, however, exceptions are not made
pending even if the target task is executing an exception handler. If the target task is running a task
exception handler for an exception of task exception codes 1 to 31, the task exception is accepted; and if
an extended SVC is executing, a break function is called. If the target task is running a task exception
handler for an exception of task exception code 0, task exceptions are ignored.
The invoking task can be designated by setting tskid = TSK SELF = 0.
If this system call is issued from a task-independent portion, error code E CTX is returned.
[Additional Notes]
If the target task is executing an extended SVC, the break handler or the extended SVC runs in the
context that called tk ras tex. In such a case tk ras tex does not return control until the break
function processing ends. Task exceptions raised in the task that called tk ras tex while the break
function is running are held until the break function ends.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02