Tornado Reference : Tornado Tools
crosswind - invoke the CrossWind executable, after establishing environment (UNIX)
crosswind [-t architecture] [-l] [gdb_options] [X toolkit options]...
CrossWind is a graphical presentation of the GDB debugger designed for use with the Tornado environment. It can be started from the Tornado launcher; when this is done, CrossWind automatically connects to the selected target and waits for debugging commands. When started at the command line, you must issue a "target wtx" command to connect the debugger to a particular Tornado target.
- Download...
- Presents a file selection dialog. The selected file is downloaded to the target.
- Quit
- Exits the debugger.
- Attach Task...
- Presents a dialog of tasks that can be attached to. This can be used any time after a target is attached. The selected task will be interrupted, and the stopping point will be displayed in the source window.
- Detach Task:
- Detaches the attached task.
- Kill Task:
- Kills the attached task.
The Targets menu also contains a list of the target servers that were running at the time CrossWind was stared. These can be used to conveniently select a target to attach to.
- C
- Requests that code be displayed in C source form when target execution stops, if possible.
- Assembly
- Requests that pure assembly code be displayed when target execution stops.
- Mixed
- Requests that an interleaved display of C source and assembly instructions be shown when the program stops.
- Reread Home
- Rereads the user's home-directory Tcl configuration file (~/.wind/crosswind.tcl).
- Reread All
- Rereads both the system Tcl initialization file ($WIND_BASE/host/resource/tcl/CrossWind.tcl) and the user's home directory configuration file.
- Registers
- Displays a window containing the contents of the processor registers. This window is updated each time execution stops and GDB is ready to execute another command.
- Backtrace
- Displays a window showing the call stack. Clicking on a level in the call stack will display the source (or assembly, depending on the display mode) associated with that level of execution.
- Tornado
- Displays a window displaying Tornado version information.
- On CrossWind
- Displays on-line hypertext help for CrossWind.
- Manuals
- Displays on-line hypertext Tornado reference manuals.
- GDB Online
- An interface to GDB's native help facility. A dialog appears asking for a topic; clicking on OK will present a window with GDB's on line help text.
CrossWind accepts the X Toolkit Intrinsics standard command-line parameters such -display or -iconic plus the following dedicated options:
- -t arch
- specify the architecture to debug. Valid values are m68k, sparc, i86, i960, simso, hppa, ppc, mips', mipsle, and arm.
- -l
- run the debugger in line-oriented mode rather than with the X GUI.
- gdb_options
- any GDB options (use the options -l --help to see a list).
- -T | -Tclmode
- Run a Tcl interpreter on standard input. This is useful for adding and debugging new features.
- -v | -version
- Print the current version of the Tornado development environment.
- -h | -help
- Print the help message.
- WIND_BASE
- the root location of the Tornado tree.
- WIND_REGISTRY
- the host on which the Tornado Registry daemon runs (see wtxregd).
The following resource files are required by CrossWind:
- $WIND_BASE/host/resource/tcl/CrossWind.tcl
- Tcl implementation of the debugger's interface.
- $WIND_BASE/host/resource/tcl/app-config/CrossWind/*.tcl
- Tcl implementation of the debugger's additional features.
- $WIND_BASE/host/resource/tcl/app-config/all/host.tcl
- Tcl implementation of the host dependencies.
- $WIND_BASE/host/resource/tcl/app-config/all/host_type.tcl
- Tcl implementation of the host specifics.
The following resource file is applied if present:
- $HOME/.wind/crosswind.tcl
- Tcl user initialization file.
crosswind, wtxregd, tgtsvr, launch, Tornado User's Guide