getenv

getenv <NAME>

Examples:

"getenv PTTY": Fetches the value of the host machine's PTTY environment variable.

Returns the value for a variable defined in Swat's environment.

If the variable isn't defined, this returns the empty string.

See Also: var, string.

get-key-binding

get-key-binding <char>

Examples:

"get-key-binding c": Gets key binding for the character c.
"get-key-binding \045": Gets key binding for the % key.

Gets key binding for given key.

See Also: alias, bind-key, unbind-key.

getvalue

getvalue <expr>

Examples:

"getvalue MSG_META_DETACH ": Returns the integer value of the symbol MSG_META_DETACH.

This is a front-end to the "addr-parse" command that allows you to easily obtain the integer value of any expression. It's most useful for converting something the user might have given you to a decimal integer for further processing.

If the expression you give does not evaluate to an address (whose offset will be returned) or an integer, the results of this function are undefined.

See Also: addr-parse, addr-preprocess.

go

go [<address expressions>]

Examples:

"go": "go drawLeftLine"

Go until an address is reached.

The <address expressions> argument is as many address expressions as desired for breakpoints. Execution is continued until a breakpoint is reached. These breakpoints are then removed when the machine stops and are only active for the current patient.

See Also: break, continue, detach, quit.

gup

gup [<address>] [<instance field>]

Examples:

"gup": print the generic object at *DS:SI and its ancestors
"gup @23 GI_states": print the states of object @23 and its ancestors
"gup -i": print the generic object under the mouse and the object's ancestors

Print a list of the object and all of its generic ancestors.

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.

See Also: gentree, vup, vistree, impliedgrab.

handles

handles [<flags>] [<patient>]

Examples: "handles"
"handles -f"
"handles ui"

Print all handles in-use.

The flags argument is a collection of flags, beginning with `-', from the following set:

s: print summary only.
e: events only.
p: don't print prevPtr and nextPtr.
f: fast print-out - this doesn't try to figure out the block type.
r: reverse, i.e. starts at the end of the handle table.
u: print only those handles that are in-use.

The patient argument is a patient whose blocks are to be selectively printed (either a name or a core-block's handle ID). The default is to print all the blocks on the heap.
The following columns can appear in a listing:

HANDLE: The handle of the block
ADDR: The segment address of the block
SIZE: Size of the block in bytes
PREV: The previous block handle (appears with the p flag)
NEXT: The next block handle (appears with the p flag)
FLAGS The following letters appears in the FLAGS column:: s sharable,
S swapable,
D discardable,
L contains local memory heap,
d discarded
(by LMem module: discarded blocks don't appear here),
a attached (notice given to swat whenever state changes)
LOCK: Number of times the block is locked or n/a if FIXED.
OWNER: The process which owns the block
IDLE: The time since the block has been accessed in minutes:seconds
OINFO: The otherInfo field of the handle (block type dependent)
TYPE: Type of the block, for example: R#1 (dgroup) resource number one

This only prints those handles in memory while `handles' prints all handles used.
The handles may be printed with lhwalk and phandle.

See Also: lhwalk, phandle, hgwalk.

GEOS SDK TechDocs |

func ... | Next:

handsum ...