docs: runner_map and method facts; tools/ghidra_probe.py for fast iteration
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
11f4b6fc37
commit
f8178a08f3
@@ -104,8 +104,9 @@ potem zaimportuj go przez `python -m ams.api.importer …`.
|
||||
## Zasada ekstrakcji
|
||||
|
||||
Ekstrakcja stoi na **kotwicach semantycznych** (cele wywołań, referowane literały
|
||||
stringów, immediaty `PUSH`), a **nie** na tekście dekompilatu. Dzięki temu jeden skrypt
|
||||
działa na MSVC6 (Piklib) i MSVC8 (BlooMoo) mimo różnego kodu wynikowego.
|
||||
stringów, immediaty `PUSH`, sloty vtable), a **nie** na tekście dekompilatu. Dzięki temu jeden
|
||||
skrypt działa na MSVC6 (Piklib) i MSVC8 (BlooMoo) mimo różnego kodu wynikowego. Nazwy funkcji
|
||||
bywają aliasami (ICF skleja identyczne ciała), więc liczy się adres i każda etykieta pod nim.
|
||||
|
||||
| Co | Kotwica w Ghidrze | Status |
|
||||
|----|-------------------|--------|
|
||||
@@ -114,7 +115,9 @@ działa na MSVC6 (Piklib) i MSVC8 (BlooMoo) mimo różnego kodu wynikowego.
|
||||
| Eventy | `CMC_*::getBehavioursList`: lista literałów `CXString` | ✅ (lista per klasa, bez dziedziczenia) |
|
||||
| Pola (skryptowe) | ctory `CMC_*`: literały czytane przez `CMElement::getProperty<T>Value` → nazwa + typ pola (FPS, PRELOAD, VISIBLE…) | ✅ (+ `field_inheritance`) |
|
||||
| Layout C++ (bonus) | ctory `CMC_*`: store'y `this+offset` przez P-code (rozmyte, `is_vtable`) | ✅ pod `struct_layout` |
|
||||
| Ciała metod | `CMC_*_Runner::run`: `switch(id)` (vtable slot 17) → per case kotwice CALL (`Klasa::metoda` / `vtbl+0xNN`), rozwinięcie wrapperów | ✅ pod `method_dispatch` (id→`impl_addr`+`calls`) |
|
||||
| Ciała metod | `CMC_*_Runner::run`: `switch(id)` → per case kotwice CALL (`Klasa::metoda` / `vtbl+0xNN`), rozwinięcie wrapperów | ✅ pod `method_dispatch` (id→`impl_addr`+`calls`) |
|
||||
| Typ → runner | 7.1+/BlooMoo: emulacja `CMC_RunnerFactory::getRunner(typeId)`, `typeId` z konstruktora typu, vtable runnerów z `RunnerFactory::initialize` (także runnery bez symboli: VECTOR, FILTER, PATH, FIFO/LIFO, MOVIE, instrukcje `@`). 6.1: konstruktor klasy tworzący runner | ✅ pod `runner_map` |
|
||||
| Sygnatury, ważność per typ | P-code case'ów i pomocników: `CMC_Runner::getParameter*` (typy argumentów), `CMC_VariableFactory::alloc*` (wynik), wirtualne obiektu, gałęzie na `obj.getType()` | ✅ w `method_dispatch` (`params`/`returns`/`per_type`) |
|
||||
|
||||
## Uruchomienie ekstraktora
|
||||
|
||||
@@ -122,6 +125,9 @@ działa na MSVC6 (Piklib) i MSVC8 (BlooMoo) mimo różnego kodu wynikowego.
|
||||
do swojego katalogu skryptów (Script Manager → *Manage Script Directories*), otwórz program,
|
||||
uruchom skrypt. Wynik trafi do `<NazwaProgramu>.snapshot.json` w katalogu roboczym Ghidry.
|
||||
|
||||
**Szybka pętla** (projekt przeanalizowany raz, kolejne uruchomienia w sekundach):
|
||||
`tools/ghidra_probe.py --project DIR DLL --extract out.json` albo `--snippet probe.py`.
|
||||
|
||||
**Headless** (tryb docelowy):
|
||||
```bash
|
||||
analyzeHeadless <projDir> <projName> -process PIKLIB8.dll \
|
||||
@@ -270,3 +276,5 @@ A/B i odpalający porównanie).
|
||||
|
||||
`schema_version`, `binary{name,sha256,engine,compiler,factory_addr}`, oraz listy
|
||||
`types` / `methods` / `events` / `fields`. Diff = operacje na zbiorach dwóch snapshotów.
|
||||
Od wersji 5: `runner_map` (`by_type_id` / `by_class`, sloty `CMC_Runner`), `types[].type_id`
|
||||
i `vftable`, a w `method_dispatch` fakty z ciała metody.
|
||||
|
||||
Reference in New Issue
Block a user