S - Search Memory for Data

Search a memory range for occurrences of a list of bytes.

Syntax:

                                       ┌──────────────────┐
                                       │                  │
                                                         │
──── S ──────── addr ────  Ln  ────────┬──  value   ──┬─┴─────
                                         └── "string" ──┘

Parameters:

addr

The address of the memory location to be searched.
Ln
The number (n) of bytes to search.
value
A numerical byte value to be searched into memory. One or more values may be specified separated commas or blanks. These may be mixed with "string" values.
string
A character string enclosed in single or double quotes. Each character is treated as a list byte values to search memory, no terminating 0x00 value is stored. No folding of characters to upper or lower case occurs. One or more strings may be specified separated by commas or blanks. These may be mixed with numerical values.

Results & Notes:

The list of values and strings is used as a combined search argument. Only precise matches against the entire search argument are reported. The search is repeated for every byte location in the range specified. If no matches are found then nothing is displayed. Where matches are found the Search command displays a list of storage addresses. For example:

----------------------------------------------------------------------##s ptda_start l1000 "TD"
0030:0000fffe
ln 30:fffe
0030:0000fffe os2krnl:TASKAREA:ptda_signature
----------------------------------------------------------------------

If memory is present the storage is updated otherwise an Invalid Address message is generated. If this should happen, valid storage may be paged into memory by means of the .I command..

---

[Back: R - Set or Display Current CPU Registers]
[Next: T - Trace Instruction Execution]