GEOS SDK TechDocs

ptext ...

read-reg ...

pvismon

pvismon [<address>] [<text only>]

Examples:

"pvismon"

print the moniker at *DS:SI

"pvismon -i 1"

print a short description of the implied grab object.

Print a visual moniker structure at an absolute address.

• The <address> argument is the address to an object in the visual tree. This defaults to *DS:SI. The `-i' flag for an implied grab may be used.
• The <text only> argument returns a shortened description of the structure. Pass a non-zero value to turn on this flag.
• The special object flags may be used to specify <object>. For a list of these flags, see pobject.

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

pvmb

Prints out the VMBlockHandle for a VM block given the file handle H and the VM block handle B .

pvmt

pvmt [-p] [-a] [-s] [-c] (<handle> | <segment>)

Examples:

"pvmt bx"

Print out all used blocks for the open VM file whose file handle is in BX.

"pvmt -as ds"

Print out all blocks for the open VM file the segment of whose header block is in DS.

Prints out a map of the VM block handles for a VM file.

• The -p flag will only print out blocks that have the Preserve flag set. Useful for examining object blocks in GeoCalc files, for example.
• The -a flag causes pvmt to print out all block handles, not just those that have been allocated. The other two types of block handles are "assigned" (meaning they're available for use, but currently are tracking unused space in the file) and "unassigned" (they're available for use).
• The -s indicates the final argument is a segment, not a file handle. This is used only if you're inside the VM subsystem of the kernel.
• The -c flag requests a count of the different types of blocks at the end of the printout.
• The blocks are printed in a table with the following columns:

han

VM block handle (in hex)

flags D if the block is dirty,

C if the block is clean,
- if the block is non-resident,
L if the block is LMem,
B if the block has a backup,
P if the preserve handle bit is set for the block,
! if the block is locked

memhan

Associated memory handle. Followed by "(d)" if the memory for the block was discarded but the handle retained. Followed by (s) if the memory has been swapped out.

block type

The type of block:

VMBT_USED a normal in-use block,

VMBT_DUP an in-use block that has been backed up or allocated since the last call to VMSave()

VMBT_BACKUP a place-holder to keep track of the previous version of a VMBT_DUP block. The uid is the VM block handle to which the file space used to belong.

VMBT_ZOMBIE a block that has been freed since the last VMSave() . The handle is preserved in case of a VMRevert() (a VMBT_BACKUP block retains the file space).

uid

The "used ID" bound to the block.

size

Number of bytes allocated for the block in the file.

pos

The position of those bytes in the file.

See Also: pgs.

pvsize

pvsize [<object>]

Examples:

"pvsize"

print the dimensions of the visual object at *ds:si.

Print out the dimensions of a visual object.

• The object argument is the address to the object to print out. It defaults to *ds:si and is optional. 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.

pwd

pwd

Examples: "pwd"

Prints the current working directory for the current thread.

See Also: dirs, stdpaths.

quit

quit [<options>]

Examples:

"quit cont"

continue GEOS and quit swat

"quit det"

detach from the PC and quit swat.

Stop the debugger and exit.

• The <option> argument may be one of the following:
  continue : continue GEOS and exit swat;
  leave : keep GEOS stopped and exit swat.
• Anything else causes swat to detach and exit.

See Also: detach.

read-char

read-char [<echo>]

Examples:

"read-char 0"

Read a single character from the user and don't echo it.

Reads a character from the user.

If <echo> is non-zero or absent, the character typed will be echoed.

See Also: read-line.

read-line

read-line [<isTcl> [<initial input> [<special chars>]]]

Examples:

"read-line"

reads a single line of text.

"read-line 1"

reads a Tcl command.

"read-line 1 {go}"

reads a Tcl command that starts with "go "

"read-line 1 {} {\e\4}"

reads a Tcl command, considering escape and control-d cause for immediate return, regardless of whether braces and brackets are balanced

Reads a single line of input from the user. If optional argument is non-zero, the line is interpreted as a Tcl command and will not be returned until all braces/brackets are balanced. The final newline is stripped. Optional second argument is input to be placed in the buffer first. This input must also be on-screen following the prompt, else it will be lost.

• If <isTcl> is non-zero, the input may span multiple lines, as read-line will not return until all braces and brackets are properly balanced, according to the rules of Tcl. This behavior may be overridden by the <special chars> argument.
• If <initial input> is given and non-empty, it is taken to be the initial contents of the input line and may be edited by the user just as if s/he had typed it in. The string is not automatically displayed; that is up to the caller.
• <special chars> is an optional string of characters that will cause this routine to return immediately. The character that caused the immediate return is left as the last character of the string returned. You may use standard backslash escapes to specify the characters. This will return even if the user is entering a multi-line Tcl command whose braces and brackets are not yet balanced.
• The user's input is returned as a single string with the final newline stripped off.

GEOS SDK TechDocs

ptext ...

read-reg ...