pSOSystem System Calls - Read

pSOS+ System Calls t_getreg
t_getreg Gets a task’s notepad register.
#include
unsigned long t_getreg(
unsigned long tid, /* task identifier */
unsigned long regnum, /* register number */
unsigned long *reg_value /* register contents */
)
Description
Arguments
Return Value
Error Codes
This system call enables the caller to obtain the contents of a task's notepad
register. Each task has 16 such software registers, held in the task's TCB. The
purpose of these registers is to furnish every task with a set of named, permanent
variables. Eight of these registers are reserved for system use. Eight are free to be
used for application specific purposes.
tid Specifies the task ID of the task whose notepad register will
be read. If tid equals 0, then the calling task reads its own
notepad register.
regnum Specifies the register number. Registers numbered 0
through 7 are for application use, and registers 8 through 15
are reserved for system purposes.
reg_value Points to the variable where t_getreg() stores the
register’s contents.
This system call returns 0 on success, or an error code on failure.
Hex Mnemonic Description
0x05 ERR_OBJDEL Task has been deleted.
0x06 ERR_OBJID tid is incorrect; failed validity check.
pSOSystem System Calls 1-141
1