GEOS SDK TechDocs

fpstack ...

getenv ...

func

func [<func name>]

Examples:

"func"

return the current function.

"func ObjMessage"

set the frame to the first frame for ObjMessage.

Get the current function or set the frame to the given function.

• The <func name> argument is the name of a function in the stack frame of the current patient. The frame is set to the first occurrence of the function from the top of the stack.
• If no <func name> argument is given then `func' returns the current function.

See Also: backtrace, up, down, finish.

fvardata

fvardata <token> [<address>]

Examples:

"fvardata ATTR_VIS_TEXT_STYLE_ARRAY *ds:si"

Locates and returns the value list for the data stored under the given token in the vardata of the given object.

• If the data are found, returns a list {<token> <data>}, where <data> is a standard value list for the type of data associated with the specified token.
• Returns an empty list if the object has no vardata entry of the given type.
• If no <address> is given, the default is *ds:si.

fwalk

fwalk [<patient>]

Examples:

"fwalk"

list all open files.

"fwalk geos"

list all open files owned by the GEOS patient.

Print the list of files open anywhere in the system.

• The patient argument may be used to restrict the list to a particular patient. The patient may be specified either as the patient name or as the patient's handle.
• fwalk differs from sysfiles and geosfiles in that it deals primarily with GEOS data structures.
• The `Other' column shows if there is a VM handle bound to the file.
• The letters in the `Flags' column mean the following:

RW

deny RW

R

deny R

W

deny W

N

deny none

rw

access RW

r

access R

w

access RW

O

override, used to override normal exclusion normally used by FileEnum() to check out file headers.

E

exclusive, used to prevent override. This is used by swap.geo

See Also: fhandle, geosfiles, sysfiles.

gc

gc [(off|register|<extensive-heap-checking-flag>]

Implements a simple garbage collector to scavenge unreferenced symbols and types. If given an argument other than "off" or "register," it turns on extensive heap checking, which slows things down enormously but ensures the heap is in good shape. The "gc register" command can be use to register a type created by "type make"as something that is being used for an extended period at the Tcl level, preventing the thing from being garbage-collected.

gentree

gentree [<address>] [<instance field>]

Examples:

"gentree"

print the generic tree starting at *DS:SI

"gentree -i"

print the generic tree under the mouse

"gentree [systemobj]"

print the generic tree starting at the system's root

"gentree @23 GI_states"

print the generic tree with generic states

"gentree *uiSystemObj"

start the generic tree at the root of the system

Print a generic tree.

• The <address> argument is the address to an object in the generic tree. This defaults to *DS:SI. The `-i' flag for an implied grab may be used.
• The special object flags may be used to specify <object>. For a list of these flags, see pobject.
• The <instance field> argument is the offset to any instance data within the GenInstance which should be printed out.
• The variable "printNamesInObjTrees" can be used to print out the actual app-defined labels for the objects, instead of the class, where available. This variable defaults to false.

See Also: gup, vistree, impliedgrab, systemobj, pobject.

geosfiles

geosfiles

Examples: "geosfiles"

Print out all the files for which I/O is currently pending in GEOS.

• This looks at the same dos structure as sysfiles but this prints only those files also listed in GEOS' job file table.

See Also: sysfiles, sftwalk, fwalk.

geos-release

This variable contains the major number of the version of GEOS running on the target PC.

geowatch

geowatch [<object>]

Examples:

"geowatch *MyObj"

Display geometry calls that have reached the object MyObj

"geowatch"

Display geometry calls that have reached *ds:si (asm) or oself (goc)

This displays geometry calls that have reached a particular object. Only one object at a time can be watched in this way.

• Two conditional breakpoints are used by this function (see cbrk). The tokens for these breakpoints are returned.
• The special object flags may be used to specify object . For a list of these flags, see pobject.

See Also: objwatch, mwatch, cbrk, pobject.

get-address

Used by the various memory-access commands. Takes one argument, ADDR, being the address argument for the command. Typically, the command is declared as

[defcmd cmd {{addr nil}} ... ]

allowing the address to be unspecified. This function will return the given address if it was, else it will return the last-accessed address (stored in the global lastAddr variable as a 3-tuple from addr-parse) in the form of an address expression. If no address is recorded ( lastAddr is nil), the default-addr argument is used. If it is not specified then CS:IP will be used.

getcc

getcc <flag>

Examples:

"getcc c"

Get the carry flag.

Get a flag from the target machine.

• The first argument is the first letter of the flag to get. The following is a list of the flags:

t

trap

i

interrupt enable

d

direction

o

overflow

s

sign

z

zero

a

auxiliary carry

p

parity

c

carry

• This command is handy to run with a breakpoint to stop if a flag is set.

See Also: setcc, clrcc, compcc.

GEOS SDK TechDocs

fpstack ...

getenv ...