GEOS SDK TechDocs

pvismon ...

ret ...

read-reg

read-reg <register>

Examples:

"read-reg ax"

return the value of AX

"read-reg CC"

return the value of the conditional flags

Return the value of a register in decimal.

• The <register> argument is the two letter name of a register in either upper or lower case.

See Also: frame, assign, setcc, clrcc.

regs

regs

Print the current registers, flags, and instruction.

See Also: assign, setcc, clrcc, read-reg.

regwin

regwin [off]

Examples: "regwin"
"regwin off"

Turn the continuous display of registers on or off.

• If you give the optional argument "off", you will turn off any active register display.
• If you give no argument, the display will be turned on.
• Only one register display may be active at a time.

See Also: display.

repeatCommand

var repeatCommand <string>

Examples:

"var repeatCommand [list foo nil]"

Execute the command "foo nil" if the user just hits <Enter> at the next command prompt.

This variable holds the command Swat should execute if the user enters an empty command. It is used by all the memory-referencing commands to display the next chunk of memory, and can be used for other purposes as well.

• repeatCommand is emptied just before top-level-read returns the command the interpreter should execute and must be reset by the repeated command if it wishes to continue to be executed when the user just hits <Enter>.
• The text of the current command is stored in lastCommand , should you wish to use it when setting up repeatCommand .

See Also: target, focus, mouse, keyboard.

require

require <name> [<file>]

Examples:

"require fmtval print"

Ensure the procedure "fmtval" is defined, loading the file "print.tcl" if it is not.

This ensures that a particular function, not normally invoked by the user but present in some file in the system library, is actually loaded.

If no <file> is given, a file with the same name (possibly suffixed ".tcl") as the function is assumed.

See Also: autoload.

resize

resize <window> <numLines>

Examples:

"resize varwin 5"

Resizes the varwin to 5 lines.

"resize va 5"

Resizes the varwin to 5 lines.

Resizes the source window or a varwin or localwin.

• The window argument is the name of the window to be resized, or a unique abbreviation of that name. Possible names are: "varwin", "localwin", "view", "doc", and "srcwin"; the last three all refer to the source window.
• The numLines argument is the desired window size.
• This command will not resize a flagwin, regwin, or framewin, as the optimal size of those windows does not vary.

restore-state

restore-state

Examples:

"restore-state"

Set all registers for the current thread to the values saved by the most recent save-state.

Pops all the registers for a thread from the internal state stack.

• This is the companion to the "save-state" command.
• All the thread's registers are affected by this command.

See Also: save-state.

GEOS SDK TechDocs

pvismon ...

ret ...