pSOSystem System Calls - Read

pSOS+ System Calls t_restart
t_restart Forces a task to start over regardless of its current state.
#include
unsigned long t_restart(
unsigned long tid, /* task identifier */
unsigned long targs[4] /* startup arguments */
)
Description
Arguments
This system call forces a task to resume execution at its original start address
regardless of its current state or place of execution. If the task was blocked, the
pSOS+ kernel forcibly unblocks it. The task's priority and stacks are set to the
original values that t_create() specified. Its start address and execution mode are
reset to the original values established by t_start(). Any pending events, signals,
or armed timers are cleared.
The t_restart() call accepts a new set of up to four arguments, which, among
other things, can be used by the task to distinguish between the initial startup and
subsequent restarts.
Because it can unconditionally unblock a task and alter its flow of execution,
t_restart() is useful for forcing a task to execute cleanup code on its own behalf
after which the task can delete itself by executing t_delete().
The calling task does not have to be the creator (or parent) of the task it restarts.
However, a task must be restarted from the node on which it was created.
tid Specifies the task to restart. When tid equals 0, the calling
task restarts itself.
targs Specifies up to four long words of input that are passed to
the restarted task.
pSOSystem System Calls 1-149
1