T-Kernel Specification (1.B0.02)

4.1. TASK MANAGEMENT FUNCTIONS 45
tk get reg
Get Task Registers
[C Language Interface]
ER ercd = tk_get_reg ( ID tskid, T_REGS *pk_regs, T_EIT *pk_eit, T_CREGS *pk_cregs ) ;
[Parameters]
ID tskid Task ID
[Return Parameters]
T REGS pk regs General registers
T EIT pk eit Registers saved when EIT occurs
T CREGS pk cregs Control registers
ER ercd Error code
The contents of T REGS, T EIT, and T CREGS are defined for each CPU and implementation.
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
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)
Invalid object state (called for the invoking task)
Context error (called from task-independent portion)
[Description]
Gets the current register contents of the task designated in tskid.
If NULL is set in pk regs, pk eit, or pk cregs, the corresponding registers are not referenced.
The referenced register values are not necessarily the values at the time the task portion was executing.
If this system call is issued for the invoking task, error code E OBJ is returned.
[Additional Notes]
In principle, all registers in the task context can be referenced. This includes not only physical CPU
registers but also those treated by the OS as virtual registers.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02