varwin

varwin <num-lines> <var-name>

view

view [<args>]

Examples:

"view foo.goc": Bring up foo.goc in the source window.

View a file in Swat.

See Also: view-default, srcwin.

view-default

view-default [patient]

Examples:

"view-default spool": sets the default view to the spool patient.
"view-default": turns off the view default.

If the view-default is set the view command will automatically look for source files from that patient. If it's not set then the view command will look for files from the current patient.

See Also: view, srcwin.

vistree

vistree [<address>] [<instance field>]

Examples:

"vistree": print the visual tree starting at *DS:SI
"vistree -i": print the visual tree under the mouse
"vistree @23 VI_optFlags": print the visual tree with opt flags
"vistree *uiSystemObj": starts the visual tree at the root of the system.

Print out a visual 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 VisInstance 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: vup, gentree, impliedgrab, pobject.

vup

vup [<address>] [<instance field>]

Examples:

"vup": print the visual object at *DS:SI and its ancestors
"vup @23 VI_optFlags": print the states of object @23 and its ancestors
"vup -i": print the visual object under the mouse and the object's ancestors

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

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 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: vistree, gup, gentree, impliedgrab, pobject.

wait

wait

Examples:

"wait": Wait for the target PC to halt.

This is used after the machine has been continued with "continue-patient" to wait for the machine to stop again. Its use is usually hidden by calling "cont" or "next".

This returns 0 if the patient halted naturally (because it hit a breakpoint), and 1 if it was interrupted (by the user typing Ctrl+C to Swat).
Most procedures won't need to use this function.

See Also: brk, ibrk.

waitForPatient

var waitForPatient [(1|0)]

Examples:

"var waitForPatient 0": Tells Swat to return to the command prompt after continuing the machine.

Determines whether the command-level patient-continuation commands (step, next, and cont, for example) will wait for the machine to stop before returning.

The effect of this is to return to the command prompt immediately after having issued the command. This allows you to periodically examine the state of the machine without actually halting it.
The output when the machine does stop (e.g. when it hits a breakpoint) can be somewhat confusing. Furthermore, this isn't fully tested, so it should probably be set to 0 only in somewhat odd circumstances.

See Also: step, next, cont, int.

wakeup

Wait for a given patient/thread to wake up. WHO is of the same form as the argument to the "switch" command, ("help switch" to find out more). Leaves you stopped in the kernel in the desired thread's context unless something else causes the machine to stop before the patient/thread wakes up. WHO defaults to the current thread.

wakeup-thread

Subroutine to actually wake up a thread. Argument WHO is as for the "switch"command. Returns non-zero if the wakeup was successful and zero if the machine stopped for some other reason.

GEOS SDK TechDocs |

twalk ... | Next:

wclear ...