Tornado

Tornado 2.0
User’s Guide
w() – print a summary of each task’s pending information, task by task (*)
wdShow( ) – show information about a watchdog
SYNOPSIS
DESCRIPTION
C Interpreter
Tcl Interpreter
Built-in Routines
windsh [-c.plus C++_library] [-e.xecute expression] [-h.elp]
[-n.oinit] [-p.oll value] [-q.uiet] [-s.tartup file]
[-T.clmode] [-v.ersion] serverIdentifier
WindSh is the Tornado shell. The shell provides remote interactive access to the target
run-time system through both a C interpreter and a Tcl interpreter.
The shell attaches to the target server specified by serverIdentifier (see tgtsvr).
To execute a list of commands when the shell starts, collect these commands in a file
(startup script) and identify the file with the -s option.
The shell has vi-like editing capabilities and a history mechanism. The ESC key acts as a
toggle between input mode and edit mode. History and editing capabilities are available
regardless of which interpreter is in use.
The shell’s C interpreter (prompt: > ) can execute almost any expression using C
operators, and can invoke compiled C functions on the target. Symbols are created as
needed for shell expressions, and are added incrementally to the target symbol table.
Interactive sessions use the C interpreter by default.
The shell’s Tcl interpreter (prompt: tcl> ) executes Tcl functions, including both functions
based on the WTX protocol and user-provided Tcl procedures. To enter the Tcl interpreter
directly for an interactive session, start windsh with the option -T.
The Tcl interpreter can also call C functions in the target; however, to establish the proper
C environment for such calls you must use the shParse Tcl command. For example:
tcl> shParse sysClkRateGet()
60
When the Tcl interpreter does not recognize a command, it passes it to the UNIX shell or
the Windows command processor.
The Tornado shell includes a set of built-in routines. These routines are executed on the
host, not in the context of the remote run-time. They are available from both the C
interpreter and the Tcl interpreter. The most important built-in routines are i( ), ti( ), d( ),
l(), ts(), tr( ), td( ), ld( ). In Tcl mode, type:
tcl> set shellProcList
to get the complete list of built-in functions.
Non-interactive Sessions
windsh can be used in non-interactive sessions, by simply providing input on its standard
input stream. For example:
370