02.03.2014 Views

Tornado

Tornado

Tornado

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

7<br />

Debugger<br />

■<br />

Shell Commands<br />

You can run any of the WindSh primitive facilities described in 5.2.3 Invoking<br />

Built-In Shell Routines, p.156 in the command panel, by inserting the prefix<br />

“wind-” before the shell command name. For example, to run the shell td( )<br />

command from the debugger, enter wind-td in the command panel.<br />

Because of GDB naming conventions, mixed-case command names cannot be<br />

used; if the shell command you need has upper case characters, use lower case<br />

and insert a hyphen before the capital letter. For example, to run the<br />

semShow( ) command, enter wind-sem-show.<br />

7<br />

! CAUTION: The debugger does not include the shell’s C interpreter; thus, the<br />

“wind-” commands are interfaces only to the underlying Tcl implementations<br />

of the shell primitives. For shell primitives that take no arguments, this makes<br />

no difference; but for shell primitives that require an argument, you must use<br />

the shell Tcl command shSymAddr to translate C symbols to the Tcl form. For<br />

example, to call the shell built-in show()on a semaphore ID mySemID, use the<br />

following:<br />

(gdb) wind-show [shSymAddr mySemId]<br />

■<br />

Server Protocol Requests<br />

The <strong>Tornado</strong> tools use a protocol called WTX to communicate with the target<br />

server. You can send WTX protocol requests directly from the GDB command<br />

area as well, by using a family of commands beginning with the prefix “wtx-”.<br />

See <strong>Tornado</strong> API Guide: WTX Protocol for descriptions of WTX protocol<br />

requests. Convert protocol message names to lower case, and use hyphens in<br />

place of underbars; for example, issue the message WTX_CONSOLE_CREATE<br />

as the command wtx-console-create.<br />

Extended Debugger Variables<br />

You can change many details of the debugger’s behavior by using the set<br />

command to establish alternative values for internal parameters. (The show<br />

command displays these values; you can list the full set interactively with help<br />

set.)<br />

The following additional set/show parameters are available in CrossWind beyond<br />

those described in GDB User’s Guide:<br />

259

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!