Document architecture checkpoint and restore original task callback order
This commit is contained in:
1 parent
69d0187a21
commit
531883aaac
45 files changed
+2935
-43
No files matched your search
@@ -0,0 +1,60 @@
|
||||
"""Original-data evidence for task ordering and separate transition state."""
|
||||
import importlib.util
|
||||
from pathlib import Path
|
||||
import unittest
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
SPEC = importlib.util.spec_from_file_location(
|
||||
"checkpoint_script_state", ROOT / "tools/binary/checkpoint_script_state.py")
|
||||
evidence = importlib.util.module_from_spec(SPEC)
|
||||
SPEC.loader.exec_module(evidence)
|
||||
|
||||
|
||||
class ScriptStateEvidenceTests(unittest.TestCase):
|
||||
@classmethod
|
||||
def setUpClass(cls):
|
||||
cls.original = ROOT.parent / "Original"
|
||||
cls.report = evidence.collect(cls.original)
|
||||
|
||||
def test_binary_identity_sites_and_virtual_call_provenance(self):
|
||||
self.assertTrue(self.report["known_binary"])
|
||||
for site in self.report["sites"] + self.report["vtables"]:
|
||||
with self.subTest(site=site["name"]):
|
||||
self.assertTrue(site["matches"], site)
|
||||
|
||||
def test_objective_record_and_actor_call_order(self):
|
||||
sites = {s["name"]: s for s in self.report["sites"]}
|
||||
names = ["task_objective_before_records", "task_record_mutation", "task_entity_callback"]
|
||||
self.assertEqual([int(sites[n]["va"], 16) for n in names], [0x45FB5B, 0x45FB7F, 0x45FBD9])
|
||||
self.assertEqual(sites[names[0]]["direct_call_target"], "0x406f50")
|
||||
self.assertEqual(sites["carl_query_scene"]["direct_call_target"], "0x45fea0")
|
||||
self.assertEqual(sites["carl_generic_callback"]["direct_call_target"], "0x40e340")
|
||||
|
||||
def test_tsk_rebroadcast_and_deferred_load(self):
|
||||
sites = {s["name"]: s for s in self.report["sites"]}
|
||||
self.assertEqual(sites["tsk_setter_call"]["direct_call_target"], "0x45f990")
|
||||
self.assertEqual(sites["load_update_reader"]["direct_call_target"], "0x4603f0")
|
||||
# Slot420 is not Jimmy's placement PostLoad: its actual target matters.
|
||||
slots = {s["name"]: s["target"] for s in self.report["vtables"]}
|
||||
self.assertEqual(slots["Jimmy game post-task hook"], "0x472970")
|
||||
|
||||
def test_route_keeps_return_distinct_from_outside(self):
|
||||
lab, tutorial = self.report["route"]
|
||||
self.assertEqual((lab["code"], tutorial["code"]), ("LV1B", "VR04"))
|
||||
exits = [e["fields"] for e in lab["entities"] if e["kind"] == "LOAD"]
|
||||
self.assertTrue(any(e.get("LevelName", "").casefold() == "level1.gam"
|
||||
and e.get("StartPoint", "").casefold() == "level1"
|
||||
and e.get("RequiredLevel") == 60 for e in exits))
|
||||
self.assertTrue(any(e["fields"].get("LevelName", "").casefold() == "return"
|
||||
for e in tutorial["entities"]))
|
||||
|
||||
def test_non_call_and_negative_read_rejected(self):
|
||||
pe = evidence.PE(evidence.find_case(self.original, "neutron.exe"))
|
||||
with self.assertRaises(ValueError):
|
||||
evidence.rel_call_target(pe, 0x45FB7F)
|
||||
with self.assertRaises(ValueError):
|
||||
evidence.read_va(pe, 0x45FB7F, -1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Reference in new issue
Block a user