smatch

Look for symbols of a given class by pattern. First argument <pattern> is the pattern for which to search (it's a standard Swat pattern using shell wildcard characters). Optional second argument <class> is the class of symbol for which to search and is given directly to the "symbol match" command. Defaults to "any".

sort

sort [-r] [-n] [-u] <list>

Examples:

"sort -n $ids": Sorts the list in $ids into ascending numeric order.

This sorts a list into ascending or descending order, lexicographically or numerically.

If "-r" is given, the sort will be in descending order.
If "-u" is given, duplicate elements will be eliminated.
If "-n" is given, the elements are taken to be numbers (with the usual radix specifiers possible) and are sorted accordingly.
The sorted list is returned.

See Also: map, foreach, mapconcat.

spawn

spawn <processName> [<addr>]

Set a temporary breakpoint in a not-yet-existent process/thread, waiting for a new one to be created. First argument is the permanent name of the process to watch for. Second argument is an address expression specifying where to place the breakpoint. If no second argument is present, the machine will be stopped and Swat will return to the command level when the new thread is spawned by GEOS.

This can also be used to catch the spawning of a new thread.
If the machine stops before the breakpoint can be set, you'll have to do this again.

srcwin

srcwin <numLines>

Examples:

"srcwin 6": Show 6 lines of source context around CS:IP
"srcwin 0": Show no source lines, i.e. turn the display off.

Set the number of lines of source code to be displayed when the target machine stops.

Only one source display may be active at a time.

See Also: display, regwin.

sstep

sstep [<default command>]

Examples:

"ss": enter source step mode
"sstep n": enter source step mode, <ret> does a next command

Step through the execution of the current patient by source lines. This is THE command for stepping through high-level (e.g., C) code.

The <default> command argument determines what pressing the <Return> key does. By default, <Return> executes a step command. Any other command listed below may be substituted by passing the letter of the command.
Sstep steps through the patient line by line, printing where the instruction pointer is and what line is to be executed Sstep waits for the user to type a command which it performs and then prints out again where sstep is executing.
This is a list of sstep commands:

q , < Esc >,` `: Stops sstep and returns to command level.
b: Toggles a breakpoint at the current location.
c: Stops sstep and continues execution.
n: Continues to the next source line, skipping procedure calls, repeated string instructions, and software interrupts. Only stops when the machine returns to the right context (i.e. the stack pointer and current thread are the same as they are when the `n' command was given).
l: Goes to the next library routine.
N: Like n, but stops whenever the breakpoint is hit, whether you're in the same frame or not.
M: Goes to the next message called. Doesn't work when the message is not handled anywhere.
f: Finishes out the current stack frame.
s , < Ret >: Steps one source line
S: Skips the current instruction
J: Jump on a conditional jump, even when "Will not jump" appears. This does not change the condition codes.
g: Executes the `go' command with the rest of the line as arguments.
e: Executes a Tcl command and returns to the prompt.
R: References either the function to be called or the function currently executing.
h , ?: A help message.

Emacs will load in the correct file executing and following the lines where sstep is executing if its server is started and if ewatch is on in swat. If ewatch is off emacs will not be updated.
If the current patient isn't the actual current thread, sstep waits for the patient to wake up before single-stepping it.

See Also: istep, listi.

GEOS SDK TechDocs |

showcalls ... | Next:

stdpaths ...