assign

assign <addr> <value>

Examples:

"assign ip ip+2": Add 2 to the value of IP in the current frame.
"assign {word ds:si} 63h": Store 63h in the word at ds:si

Performs an assignment to a patient variable or register (but not to an element of the value history). The first argument is the variable or register to be assigned and the second argument is the value to assign to it (which may be a regular address expression). If the first expression doesn't indicate a type, "word" is assumed. Only byte , word or dword types are supported.

When assigning to an sptr, the value assigned will be the segment of the block indicated by the <value>, unless <value> is an absolute address (or just a number), in which case the low 16 bits of the offset will be used instead.
Similar behavior occurs when assigning to an fptr, except if the <value> is an absolute address, in which case the linear address in the offset portion of the <value> will be decomposed into a segment and an offset.

See Also: imem, value.

att

att [<args>]

Examples:

"att": attach Swat to GEOS.

The args argument can be one of the following:

-s: reboot GEOS with error checking, attach, and stop
-sn: reboot GEOS without error checking, attach, and stop
-f: restart GEOS with error checking and attach after a pause
-r: restart GEOS with error checking and attach
-rn: restart GEOS without error checking and attach

See Also: detach, quit.

attach

attach [<boot>]

Examples:

"attach": attach to the target PC

Attach swat to the target PC.

The boot argument is "-b" to bootstrap and "+b" to not. Normally, Swat will try to read symbolic information about all running geodes; bootstrapping specifies that Swat should only read symbolic information for these geodes when it must.
If you give no <boot> argument, swat will use the most-recent one.
By default, swat will locate the symbols for all geodes and threads active on the PC when it attaches.
If any geode has changed since you detached from the PC, its symbols are re-read.

See Also: att, detach, quit.

autoload

autoload <function> <flags> <file> [<class> <docstring>]

Examples:

"autoload cycles 1 timing": load the file "timing.tcl" when the cycles command is first executed. The user must type the command completely.
"autoload print 2 print": load the file "print.tcl" when the print command is first executed. The user may abbreviate the command and the Tcl interpreter will not evaluate its arguments.

This command allows the first invocation of a command to automatically force the transparent reading of a file of Tcl commands.

autoload takes 3 or 5 arguments: the command, an integer with bit flags telling how the interpreter should invoke the command, the file that should be read to define the command (this may be absolute or on load-path) and an optional help class and string for the command.
The help class and string need only be given if the file to be loaded isn't part of the system library (doesn't have its help strings extracted when Swat is built).
The <flags> argument has the following bit-flags:

0: User must type the command's name exactly. The command will be defined by "defsubr" or "defdsubr" when <file> is loaded.
1: The interpreter will not evaluate arguments passed to the command. All arguments will be merged into a single string and passed to the command as one argument. The command will use the special "noeval" argument when it is defined.

See Also: defsubr, defcommand, proc.

backtrace

backtrace [-r<reg>* ][<frames to list>]

Examples:

"backtrace": print all the frames in the patient
"backtrace -rax": print all the frames and the contents of AX in each one.
"where 5": print the last five frames
"w 5": print the last five frames

Print all the active stack frames for the patient.

The <frames to list> argument is the number of frames to print. If not specified, then all are printed.
If a numeric argument is not passed to backtrace then it attempts to display method calls in the form:

        MSG_NAME(cx, dx, bp) => className (^l####h:####h)

Here <cx>, <dx>, and <bp> are the values passed in these registers. <className> is the name of the class which handled the message. ^l####h:####h is the address of the object (block, chunk handle) handling the message.

If a numeric argument is passed to backtrace then the attempt to decode the message is not done and the single line above expands into:

	 far ProcCallModuleRoutine(), geodesResource.asm:476
	 near ObjCallMethodTable(), objectClass.asm:1224

This is generally less useful, but sometimes it's what you need.

See Also: up, down, func.

bin

bin <number> [<field-width>]

Examples:

"bin 5": returns "0101" (five in binary)
"bin 10h": returns "0001 0000"
"bin 10h 3": returns "0000 0001 0000"

Prints numbers in binary.

The field width is in nibbles.
The default field width is the minium number of nibbles to display the number.

bindings

bindings

Shows all current key bindings

bind-key

bind-key <ascii_value> <function>

Examples:

"bind-key \321 scroll_srcwin_down": Binds scroll-down key to the scroll_srcwin_down Tcl routine.

Binds an ASCII value to a function.

See Also: alias, unbind-key.

GEOS SDK TechDocs |

alias ... | Next:

bits ...