pSOSystem System Calls - Read

pSOS+ System Calls t_create
t_create Creates a task.
#include
unsigned long t_create(
char name[4], /* task name */
unsigned long prio, /* task priority */
unsigned long sstack, /* task supervisor stack size */
unsigned long ustack, /* task user stack size */
unsigned long flags, /* task attributes */
unsigned long *tid /* task identifier */
)
Description
Arguments
This service call enables a task to create a new task. t_create() allocates to the
new task a Task Control Block (TCB) and a memory segment for its stack(s). The
task stack sizes and scheduling priority are established with this call. t_create()
leaves the new task in a dormant state; the t_start() call must be used to place
the task into the ready state for execution.
name Specifies the user-assigned name of the task.
prio Specifies the task's initial priority within the range 1 - 239, with 239
the highest and 1 the lowest.
Priority level 0 is reserved for the pSOS+ daemon task IDLE. Priority
levels 240 - 255 are reserved for a variety of high priority pSOSystem
daemon tasks. While t_create() will allow creation of a task at
these priorities, there should never be a need to do so.
sstack Specifies the task's supervisor stack size in bytes (see “Supervisor
Stack Size” under “Target.”) t_create() internally calls
rn_getseg() to allocate a segment from Region 0 to hold the task’s
stack and the user stack, if any.
ustack Specifies the task's user stack. ustack may be 0 if the task executes
only in supervisor mode (see “Using sstack and ustack” under
“Target”).
pSOSystem System Calls 1-133
1