mirror of
https://github.com/hrydgard/ppsspp.git
synced 2026-09-04 03:35:19 +02:00
Add memory.search and hle.data.* to the WebSocket debugger
Reverse-engineering workflows need to (1) find where an unknown value lives in memory and (2) label what's found, neither of which the debugger API could do before: - memory.search (MemorySubscriber.cpp): Cheat-Engine-style scan of a memory range for a u8/u16/u32/float value, or a byte pattern with an optional wildcard mask. - hle.data.list/add/remove/rename (HLESubscriber.cpp): manage ST_DATA symbols (structs, tables, buffers), mirroring the existing hle.func.* commands for functions. Needed a new SymbolMap::RemoveData, since only RemoveFunction existed - added following the same pattern. Verified live against a running PPSSPP instance (game.status, cpu.stepping, memory.search in u32/bytes/masked-bytes modes, and the full add/list/rename/remove data-symbol lifecycle) via Tools/wsdbg. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XDNwPPuidmNxQGRJxBuRL6
This commit is contained in:
co-authored by
Claude Opus 5
parent
3ebc9872a5
commit
074c8ac523
@@ -40,6 +40,7 @@ DebuggerSubscriber *WebSocketMemoryInit(DebuggerEventHandlerMap &map) {
|
||||
map["memory.write_u16"] = &WebSocketMemoryWriteU16;
|
||||
map["memory.write_u32"] = &WebSocketMemoryWriteU32;
|
||||
map["memory.write"] = &WebSocketMemoryWrite;
|
||||
map["memory.search"] = &WebSocketMemorySearch;
|
||||
|
||||
return nullptr;
|
||||
}
|
||||
@@ -403,3 +404,142 @@ void WebSocketMemoryWrite(DebuggerRequest &req) {
|
||||
Reporting::NotifyDebugger();
|
||||
req.Respond();
|
||||
}
|
||||
|
||||
// Search memory for a value or byte pattern (memory.search)
|
||||
//
|
||||
// Useful for reverse engineering - e.g. narrowing down where a known value (health,
|
||||
// ammo, a position) lives, or finding a byte signature.
|
||||
//
|
||||
// Parameters:
|
||||
// - address: unsigned integer address for the start of the range to search.
|
||||
// - size: unsigned integer size in bytes of the range to search.
|
||||
// - type: string, one of 'u8', 'u16', 'u32', 'float', or 'bytes'.
|
||||
// - value: for 'u8'/'u16'/'u32', an unsigned integer to match exactly.
|
||||
// For 'float', a JSON string (e.g. "1.5") - use a string so integers aren't confused
|
||||
// with floats, same convention as cpu.setReg.
|
||||
// - base64: for 'bytes', the byte pattern to match, base64 encoded.
|
||||
// - maskBase64: optional for 'bytes', base64 encoded, same length as 'base64'. A 0x00
|
||||
// byte means "don't care" at that position, any other byte value means "must match
|
||||
// exactly" at that position. Defaults to matching every byte of 'base64' exactly.
|
||||
// - align: optional unsigned integer, only check offsets from 'address' that are a
|
||||
// multiple of this many bytes. Defaults to the size of 'type' in bytes (or 1 for
|
||||
// 'bytes'.)
|
||||
// - maxResults: optional unsigned integer, stop after this many matches (default 1000,
|
||||
// hard cap 100000.)
|
||||
//
|
||||
// Response (same event name):
|
||||
// - matches: array of unsigned integer addresses where a match was found.
|
||||
// - truncated: boolean, true if 'maxResults' was hit before the whole range was searched.
|
||||
void WebSocketMemorySearch(DebuggerRequest &req) {
|
||||
uint32_t addr;
|
||||
if (!req.ParamU32("address", &addr))
|
||||
return;
|
||||
uint32_t size;
|
||||
if (!req.ParamU32("size", &size))
|
||||
return;
|
||||
std::string type;
|
||||
if (!req.ParamString("type", &type))
|
||||
return;
|
||||
|
||||
auto memLock = LockMemoryAndCPU(addr, true);
|
||||
if (!currentDebugMIPS->isAlive() || !Memory::IsActive())
|
||||
return req.Fail("CPU not started");
|
||||
if (!Memory::IsValidAddress(addr))
|
||||
return req.Fail("Invalid address");
|
||||
else if (!Memory::IsValidRange(addr, size))
|
||||
return req.Fail("Invalid size");
|
||||
|
||||
uint32_t align = 1;
|
||||
uint32_t needleSize = 0;
|
||||
uint32_t needleValue = 0;
|
||||
std::vector<uint8_t> needleBytes;
|
||||
std::vector<uint8_t> maskBytes;
|
||||
|
||||
if (type == "u8" || type == "u16" || type == "u32") {
|
||||
needleSize = type == "u8" ? 1 : type == "u16" ? 2 : 4;
|
||||
align = needleSize;
|
||||
if (!req.ParamU32("value", &needleValue, false))
|
||||
return;
|
||||
} else if (type == "float") {
|
||||
needleSize = 4;
|
||||
align = 4;
|
||||
// allowFloatBits: accepts a string like "1.5" and gives us its raw bit pattern.
|
||||
if (!req.ParamU32("value", &needleValue, true))
|
||||
return;
|
||||
} else if (type == "bytes") {
|
||||
std::string encoded;
|
||||
if (!req.ParamString("base64", &encoded))
|
||||
return;
|
||||
needleBytes = Base64Decode(&encoded[0], encoded.size());
|
||||
if (needleBytes.empty())
|
||||
return req.Fail("'base64' must decode to at least one byte");
|
||||
needleSize = (uint32_t)needleBytes.size();
|
||||
align = 1;
|
||||
|
||||
if (req.HasParam("maskBase64")) {
|
||||
std::string maskEncoded;
|
||||
if (!req.ParamString("maskBase64", &maskEncoded))
|
||||
return;
|
||||
maskBytes = Base64Decode(&maskEncoded[0], maskEncoded.size());
|
||||
if (maskBytes.size() != needleBytes.size())
|
||||
return req.Fail("'maskBase64' must decode to the same length as 'base64'");
|
||||
}
|
||||
} else {
|
||||
return req.Fail("Invalid 'type', must be u8, u16, u32, float, or bytes");
|
||||
}
|
||||
|
||||
if (needleSize > size)
|
||||
return req.Fail("'size' is smaller than the pattern/value being searched for");
|
||||
|
||||
if (!req.ParamU32("align", &align, false, DebuggerParamType::OPTIONAL))
|
||||
return;
|
||||
if (align == 0)
|
||||
return req.Fail("'align' must not be zero");
|
||||
|
||||
uint32_t maxResults = 1000;
|
||||
if (!req.ParamU32("maxResults", &maxResults, false, DebuggerParamType::OPTIONAL))
|
||||
return;
|
||||
if (maxResults == 0)
|
||||
maxResults = 1000;
|
||||
else if (maxResults > 100000)
|
||||
maxResults = 100000;
|
||||
|
||||
const uint8_t *base = Memory::GetPointerUnchecked(addr);
|
||||
std::vector<uint32_t> matches;
|
||||
bool truncated = false;
|
||||
for (uint32_t offset = 0; offset + needleSize <= size; offset += align) {
|
||||
bool match;
|
||||
if (!needleBytes.empty()) {
|
||||
match = true;
|
||||
for (uint32_t i = 0; i < needleSize; ++i) {
|
||||
uint8_t mask = maskBytes.empty() ? 0xFF : maskBytes[i];
|
||||
if ((base[offset + i] & mask) != (needleBytes[i] & mask)) {
|
||||
match = false;
|
||||
break;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
uint32_t actual = base[offset];
|
||||
if (needleSize >= 2)
|
||||
actual |= base[offset + 1] << 8;
|
||||
if (needleSize >= 4)
|
||||
actual |= (base[offset + 2] << 16) | (base[offset + 3] << 24);
|
||||
match = actual == needleValue;
|
||||
}
|
||||
|
||||
if (match) {
|
||||
if (matches.size() >= maxResults) {
|
||||
truncated = true;
|
||||
break;
|
||||
}
|
||||
matches.push_back(addr + offset);
|
||||
}
|
||||
}
|
||||
|
||||
JsonWriter &json = req.Respond();
|
||||
json.pushArray("matches");
|
||||
for (uint32_t m : matches)
|
||||
json.writeUint(m);
|
||||
json.pop();
|
||||
json.writeBool("truncated", truncated);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user