T-Kernel Specification (1.B0.02)

44 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk set rid
Set Task Resource ID
[C Language Interface]
ID oldid = tk_set_rid ( ID tskid, ID resid ) ;
[Parameters]
ID tskid Task ID
ID resid New resource ID
[Return Parameters]
ID oldid Old resource ID
or Error Code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Invalid ID number (tskid or resid is invalid or cannot be used)
Object does not exist (the task designated in tskidor resid does not exist)
[Description]
Changes the current resource group of the task designated in tskid to the resource group designated in
resid. The resource ID of the old resource group before the change is passed in a return parameter.
The invoking task can be designated by setting tskid = TSK SELF = 0. Note, however, that when a
system call is issued from a task-independent portion and tskid = TSK SELF = 0 is designated, error
code E ID is returned.
[Additional Notes]
In some cases error is not returned even if resid was previously deleted. Whether or not an error code
(E NOEXS) is returned is implementation-dependent. In principle it is the responsibility of the caller not
to designate a deleted resource group.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02