Tornado

5
Shell
! WARNING: Most of the shell commands correspond to similar routines that can be
linked into VxWorks for use with the target-resident version of the shell (VxWorks
Programmer’s Guide: Target Shell). However, the target-resident routines differ in
some details.For reference information on a shell command, be sure to consult the
windsh entry in D. Tornado Tools Reference or use the HTML help for the command.
Although there is usually an entry with the same name in the VxWorks Reference
Manual, it describes a related target routine, not the shell command.
5
Task Management
Table 5-2 summarizes the WindSh commands that manage VxWorks tasks.
Table 5-2
WindSh Commands for Task Management
Call
sp( )
sps()
tr( )
ts()
td( )
period()
repeat( )
taskIdDefault( )
Description
Spawn a task with default parameters.
Spawn a task, but leave it suspended.
Resume a suspended task.
Suspend a task.
Delete a task.
Spawn a task to call a function periodically.
Spawn a task to call a function repeatedly.
Set or report the default (current) task ID (see 5.3.5 The “Current” Task
and Address, p.181 for a discussion of how the current task is established
and used).
The repeat( ) and period( ) commands spawn tasks whose entry points are
_repeatHost and _periodHost. The shell downloads these support routines when
you call repeat( ) or period( ). (With remote target servers, that download
sometimes fails; for a discussion of when this is possible, and what you can do
about it, see 5.6 Object Module Load Path, p.196.) These tasks may be controlled like
any other tasks on the target; for example, you can suspend or delete them with
ts( ) or td( ) respectively.
157