feat(extractor): events per script type through the type's vftable
type_events reads getBehavioursList from each type's own vftable, so unnamed classes (FILTER, FIFO/LIFO, MOVIE) get their events and INTEGER/STRING/... resolve to CMC_Variable's list without guessing. The slot is voted by same-class overrides because the folded base body carries unrelated labels. Type vftables are recorded for every engine. Schema 6. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
f85e2a14ef
commit
cb03de47ac
@@ -692,7 +692,6 @@ def extract_events(program):
|
||||
each class's list is self-contained (no inheritance chain, unlike methods). Each literal is
|
||||
loaded twice per entry (strlen + memcpy), so consecutive duplicates are collapsed."""
|
||||
fm = program.getFunctionManager()
|
||||
listing = program.getListing()
|
||||
events = []
|
||||
it = fm.getFunctions(True)
|
||||
while it.hasNext():
|
||||
@@ -701,16 +700,23 @@ def extract_events(program):
|
||||
continue
|
||||
ns = f.getParentNamespace()
|
||||
owner = ns.getName() if ns is not None else "?"
|
||||
order = 0
|
||||
for order, name in enumerate(_event_literals(program, f)):
|
||||
events.append({"owner": owner, "name": name, "order": order})
|
||||
return events
|
||||
|
||||
|
||||
def _event_literals(program, func):
|
||||
"""Ordered event names a getBehavioursList body builds; each literal is loaded twice per
|
||||
entry (strlen + memcpy), so consecutive duplicates collapse."""
|
||||
names = []
|
||||
last = None
|
||||
ins = listing.getInstructions(resolve_thunk(f).getBody(), True)
|
||||
ins = program.getListing().getInstructions(resolve_thunk(func).getBody(), True)
|
||||
while ins.hasNext():
|
||||
s = _imm_string(program, ins.next())
|
||||
if s is not None and _is_method_name(s) and s != last:
|
||||
events.append({"owner": owner, "name": s, "order": order})
|
||||
order += 1
|
||||
names.append(s)
|
||||
last = s
|
||||
return events
|
||||
return names
|
||||
|
||||
|
||||
def _is_cmc_ctor(func):
|
||||
@@ -1768,6 +1774,54 @@ def annotate_type_vftables(program, types, method_dispatch):
|
||||
row["per_type"][name] = "trivial_virtual"
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------- type events
|
||||
|
||||
def _virtual_slot(program, member):
|
||||
"""vtable offset of virtual `member`, voted by classes that override it in their own
|
||||
namespace. A base body folded with unrelated trivial ones (ICF) carries many labels and
|
||||
shows up in other slots too, so only same-class overrides vote."""
|
||||
votes = {}
|
||||
it = program.getSymbolTable().getAllSymbols(True)
|
||||
while it.hasNext():
|
||||
s = it.next()
|
||||
ns = s.getParentNamespace()
|
||||
if "vftable" not in s.getName() or ns is None or not ns.getName().startswith(CMC_PREFIX):
|
||||
continue
|
||||
for i in range(_MAX_VTABLE_SLOTS):
|
||||
target = _read_ptr(program, s.getAddress().add(i * 4))
|
||||
if target is None or not _executable(program, target):
|
||||
break
|
||||
if (ns.getName(), member) in _labels(program, target):
|
||||
votes[i * 4] = votes.get(i * 4, 0) + 1
|
||||
return max(votes, key=lambda k: votes[k]) if votes else None
|
||||
|
||||
|
||||
def extract_type_events(program, types):
|
||||
"""Per script type, the events its own vftable's getBehavioursList returns. Reaches the
|
||||
unnamed classes (FILTER, FIFO/LIFO, MOVIE, ...) and resolves inheritance (INTEGER uses
|
||||
CMC_Variable's list) without guessing. Needs `types[].vftable`; the lists are
|
||||
self-contained (each repeats ONINIT/ONDONE/ONSIGNAL)."""
|
||||
slot = _virtual_slot(program, "getBehavioursList")
|
||||
if slot is None:
|
||||
return []
|
||||
out = []
|
||||
seen = set()
|
||||
for t in types:
|
||||
if not t.get("vftable") or t["script_name"] in seen:
|
||||
continue
|
||||
seen.add(t["script_name"])
|
||||
target = _read_ptr(program, _addr(program, int(t["vftable"], 16)).add(slot))
|
||||
func = _ensure_function(program, target)
|
||||
if func is None:
|
||||
continue
|
||||
owners = sorted(set(ns for ns, name in _labels(program, target) if name == "getBehavioursList"))
|
||||
for order, name in enumerate(_event_literals(program, func)):
|
||||
out.append({"type": t["script_name"], "name": name, "order": order,
|
||||
"list_addr": _hex(resolve_thunk(func).getEntryPoint()),
|
||||
"list_owner": owners[0] if len(owners) == 1 else None})
|
||||
return out
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------- metadata
|
||||
|
||||
def detect_engine(factory):
|
||||
@@ -1841,9 +1895,10 @@ def run():
|
||||
if runner_map and "by_type_id" in runner_map:
|
||||
annotate_method_facts(program, method_dispatch, run_addrs, runner_map, types)
|
||||
annotate_type_vftables(program, types, method_dispatch)
|
||||
type_events = extract_type_events(program, types)
|
||||
|
||||
snapshot = {
|
||||
"schema_version": 5,
|
||||
"schema_version": 6,
|
||||
"binary": {
|
||||
"name": program.getName(),
|
||||
"sha256": sha256_of(program),
|
||||
@@ -1860,6 +1915,7 @@ def run():
|
||||
"struct_layout": struct_layout,
|
||||
"method_dispatch": method_dispatch,
|
||||
"runner_map": runner_map,
|
||||
"type_events": type_events,
|
||||
}
|
||||
|
||||
args = getScriptArgs()
|
||||
@@ -1870,9 +1926,9 @@ def run():
|
||||
finally:
|
||||
fh.close()
|
||||
|
||||
print("[+] %s [%s/%s]: %d types, %d methods, %d events, %d fields (%d layout, %d dispatch, %d runners) -> %s" % (
|
||||
print("[+] %s [%s/%s]: %d types, %d methods, %d events (%d per type), %d fields (%d layout, %d dispatch, %d runners) -> %s" % (
|
||||
program.getName(), engine, compiler, len(types), len(methods),
|
||||
len(events), len(fields), len(struct_layout), len(method_dispatch),
|
||||
len(events), len(type_events), len(fields), len(struct_layout), len(method_dispatch),
|
||||
len((runner_map or {}).get("runners", [])), out_path))
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user