ret

ret [<function name>]

Examples: "ret"
"ret ObjMessage"

Return from a function and stop.

The <function name> argument is the name of a function in the patient's stack after which swat should stop. If none is specified then Swat returns from the current function.
The function returned from is the first frame from the top of the stack which calls the function (like the "finish" command).
This command does not force a return. The machine continues until it reaches the frame above the function.

See Also: finish, backtrace.

return-to-top-level

return-to-top-level

Examples:

"return-to-top-level": Returns to the top-level interpreter.

Forces execution to return to the top-level interpreter loop, unwinding intermediate calls (protected commands still have their protected clauses executed, but nothing else is).

See Also: top-level, protect.

rs

rs

Examples:

"rs": restart GEOS without attaching

Restart GEOS without attaching.

See Also: att, attach.

run

run [<patient-name>]

Examples:

"run uki": Run the application with patient name "uki".
"run -e uki": run EC Uki
"run -n uki": run non-EC Uki
"run -p games\ukiec.geo ": run games\ukiec.geo
"run": run the default patient, as specified by the patient-default command.

"Runs" an application by loading it via a call to UserLoadApplication() and stopping when the app reaches the GenProcess handler for MSG_META_ATTACH . Return patient created, if any (In the examples shown, this would be "uki").

May be used even if stopped inside the loader, in which case GEOS will be allowed to continue starting up, and the specified app run after GEOS is Idle.
If the machine stops for any other reason other than the call's completion, you are left wherever the machine stopped.

See Also: patient-default, send, spawn, switch.

rwatch

rwatch [(on|off)]

Examples:

"rwatch on": Watch text-recalculation as it happens
"rwatch off": Turn output off
"rwatch": See what the status is

Displays information about text recalculation. Specifically designed for tracking bugs in the rippling code.

See Also: ptext.

save

save (<#lines>|<filename>)

Examples:

"save 500": Save the last 500 lines that scroll off the screen.
"save /dumps/puffball": Save the contents of the entire scroll buffer to the file "puffball".

Controls the scrollback buffer Swat maintains for its main command window.

If the argument is numeric, it sets the number of lines to save (the default is 1,000).
If the argument is anything else, it's taken to be the name of a file in which the current buffer contents (including the command window) should be saved. If the <filename> is relative, it is taken relative to the directory in which the executable for the patient to which the current stack frame's function belongs is located. If the file already exists, it is overwritten.

save-state

save-state

Examples:

"save-state": Push the current register state onto the thread's state stack.

Records the state of the current thread (all its registers) for later restoration by "restore-state".

Swat maintains an internal state stack for each thread it knows, so calling this has no effect on the target PC.
This won't save any memory contents, just the state of the thread's registers.

See Also: restore-state, discard-state.

sbwalk

sbwalk [<patient>]

Examples:

"sbwalk": list the saved blocks of the current patient.
"sbwalk geos": list the saved blocks of the GEOS patient.

List all the saved blocks in a patient.

The <patient> argument is any GEOS patient. If none is specified then the current patient is used.

GEOS SDK TechDocs |

read-reg ... | Next:

scope ...