GEOS SDK TechDocs

car ...

dbrk ...

continue-patient

continue-patient

Examples:

"continue-patient"

Allow the target machine to continue executing GEOS.

Tell the Swat stub to let the target machine continue where it left off.

This command does not wait for the machine to stop again before it returns; once the machine is running, you're free to do whatever you want, whether it's calling "wait" or examining memory periodically.

See Also: step-patient.

cup

cup <class>
cup <object>
cup <flags>

Examples:

"cup ui::GenDocumentControlClass"

Print class hierarchy of named class

"cup ^l2850h:0034h"

Print class hierarchy of object

"cup -f"

Print class hierarchy of focus object

"cup -p"

Print class hierarchy of process

Walks up the class hierarchy, starting at a given class, printing each class encountered. May be passed an object, in which case the class of the object will be used as a starting place.

current-level

current-level

Examples:

"var l [current-level]"

Store the current interpreter nesting level in $l.

Returns the number of invocations of "top-level" (i.e. the main command input loop) currently active.

• This is currently used only to modify the command prompt to indicate the current nesting level.
• The top-most command loop is level one.

See Also: top-level.

current-registers

current-registers

Examples:

"current-registers"

Returns a list of the current registers for the current thread.

Returns all the registers for the current thread as a list of decimal numbers.

• The mapping from element number to register name is contained in the global variable "regnums", which is an assoc-list whose elements contain the name of the register, then the element number.
• For your own consumption, the list is ordered ax, cx, dx, bx, sp, bp, si, di, es, cs, ss, ds, ip, flags. You should use the "regnums" variable when programming, however, as this may change at some point (e.g. to accommodate the additional registers in the 386).

cvtrecord

cvtrecord <type> <number>

Examples:

"cvtrecord [symbol find type HeapFlags] 36"

Return a value list for the number 36 cast to a HeapFlags record.

Creates a value list for a record from a number, for use in printing out the number as a particular record using fmtval.

• <type> is a type token for a record (or a structure made up exclusively of bitfields).
• <number> must be an actual number suitable for the "expr" command. It cannot be a register or variable or some such. Use "getvalue" to obtain an integer from such an expression.
• Returns a value list suitable for "value store" or for "fmtval".

See Also: value, fmtval, expr, getvalue.

cycles

Count instruction cycles from now until the given address is reached. Prints out each instruction as it is executed, along with the cycles it took. If no address is given, executes until a breakpoint is hit. Takes the following (optional) flags:

-r

Print routines called, the total cycles for each routine, and a running total, not the cycles for each instruction.

-i

Same as -r, but indents to show calling level. Not recommended for counting cycles over deeply nested routines.

-I

Same as -i, except uses (#) to indicate call level

-f

Stop counting when this routine finishes

-n

Does not whine about interrupts being off

-x < routine >

Step over calls to <routine>

-x < routine >=< val >

Step over calls to <routine> and assume that the call takes <val> cycles for timing purposes

See Also: timingProcessor.

GEOS SDK TechDocs

car ...

dbrk ...