GEOS SDK TechDocs

elist ...

flagwin ...

fatalerr_auto_explain

var fatalerr_auto_explain [(0|1)]

Examples:

"var fatalerr_auto_explain 0"

Turn off automatic generation of the explanation for any fatal-error hit.

Determines if the "why" command will automatically provide you with an explanation of any fatal error you encounter. If non-zero, they will be provided whenever FatalError is hit.

• Explanations are loaded from <patient>.fei files stored in the system Tcl library directory when an error in <patient> is encountered.
• You can also obtain an explanation of an error via the "explain" command.

fetch-optr

fetch-optr <handle> <offset>

Examples:

"fetch-optr $h $o.GI_comp.CP_firstChild"

Fetch the optr from the GI_comp.CP_firstChild field of the object at ^h$h:$o.

Extracts an optr from memory, coping with the data in the block that holds the optr not having been relocated yet.

• <offset> is an actual offset, not a chunk handle, while <handle> is a handle ID, not a handle token.
• Returns a two-list {<handle> <chunk>}, where <handle> is the handle ID from the optr, and <chunk> is the chunk handle (low word) from the optr.
• We decide whether to relocate the optr ourselves based on the LMF_RELOCATED bit in the LMBH_flags field of the block's header. There are times, e.g. during the call to MSG_META_RELOCATE for an object, when this bit doesn't accurately reflect the state of the class pointer and we will return an error when we should not.

fhandle

fhandle <handle id>

Examples: "fhandle 3290h"

Print out a file handle.

• The <handle id> argument is the handle number. File handles are listed in the first column of the `fwalk' command.

See Also: fwalk.

field

field <list> <field name>

Examples:

"field [value fetch ds:si MyBox] topLeft"

return the offset of the topLeft field in MyBox

Return the value for the field's offset in the structure.

• The <list> argument is a structure-value list from the "value" command.
• The <field name> argument is the field in the structure.

See Also: value, pobject, piv.

fieldwin

fieldwin

Print the address of the target machine's current top-most field window.

find

find [-ir] <string> [<filename>]

Examples:

"find FileRead"

Find next occurrence of string "FileRead" in currently viewed file

"find FI_foo poof.goc"

find first occurrence of string "FI_foo" in file poof.goc.

"find -ir myobject"

case-insensitive reverse search for most recent occurrence of string "myobject" in currently viewed file

Finds a string in a file and brings the line with that string to the middle of Swat's source window.

• If no file argument is specified, find will find the next instance of the string in the already viewed file starting from the current file position.
• There must already be a source window displayed for find to work.
• Possible options to find are:

-r

reverse search

-i

case insensitive search

find-opcode

find-opcode <addr> <byte>+

Locates the mnemonic for an opcode and decodesit. Accepts the address from which the opcode bytes were fetched, and one or more opcode bytes as arguments. Returns a list of data from the opcode descriptor:

{name length branch-type args modrm bRead bWritten inst}

length is the length of the instruction.

branch - type is one of:

1

none (flow passes to next instruction)

j

absolute jump

b

pc-relative jump (branch)

r

near return

R

far return

i

interrupt return

I

interrupt instruction

Any argument descriptor that doesn't match is to be taken as a literal. E.g. AX as a descriptor means AX is that operand.

modrm is the modrm byte for the opcode.

bRead is the number of bytes that may be read by the instruction, if one of its operands is in memory.

bWritten is the number of bytes that may be written by the instruction, if one of its operands is in memory.

inst is the decoded form of the instruction. If not enough bytes were given to decode the instruction, inst is returned as empty.

finish

finish [<frame num>]

Examples:

"finish"

finish executing the current frame

"finish 3"

finish executing up to the third frame

Finish the execution of a frame.

• The <frame num> argument is the number of the frame to finish. If none is specified then the current frame is finished up. The number to use is the number which appears in a backtrace.
• The machine continues to run until the frame above is reached.

See Also: backtrace.

finishframe

finishframe [<frame-token>]

Examples:

"finishframe $cur"

Run the machine to continue until it has returned from a particular stack frame.

Allows the machine to continue until it has returned from a particular stack frame.

• No FULLSTOP event is dispatched when the machine actually finishes executing in the given frame. The caller must dispatch it itself, using the "event" command.
• The command returns zero if the machine finished executing in the given frame; non-zero if it was interrupted before that could happen.
• The argument is a frame token, as returned by the "frame" command.

See Also: event, frame, finish.

GEOS SDK TechDocs

elist ...

flagwin ...