Files
Neutron/tools/binary/jimmy_special_contact.py

36 lines
2.3 KiB
Python

#!/usr/bin/env python3
"""Read-only Jimmy material-contact evidence and isolated dispatcher probe."""
import argparse,hashlib,json,struct
from pathlib import Path
from checkpoint_script_state import EXE_SHA256,find_case,read_va
from pe_inspect import PE
RANGES=((0x43aa40,0x43afe3),(0x42a7e0,0x42a86c),(0x42a8d0,0x42a918),(0x43a900,0x43aa40),(0x43aff0,0x43b5a0))
BINDINGS=((0x4a3bdc,0x160,0x42a7e0),(0x4a3bdc,0x164,0x42a8d0),(0x4a373c,0x374,0x42a660),(0x4af6c4,0x374,0x43aa40))
def collect(original):
pe=PE(find_case(Path(original),'Neutron.exe'))
if hashlib.sha256(pe.data).hexdigest()!=EXE_SHA256:raise ValueError('Unexpected original EXE identity')
for table,slot,target in BINDINGS:
if struct.unpack('<I',read_va(pe,table+slot,4))[0]!=target:raise ValueError('Changed contact binding')
return dict(source_sha256=EXE_SHA256,ranges=[dict(va=hex(a),file_offset=hex(pe.offset(a-pe.base)),length=b-a,sha256=hashlib.sha256(read_va(pe,a,b-a)).hexdigest()) for a,b in RANGES],bindings=[dict(table=hex(t),slot=hex(s),target=hex(a)) for t,s,a in BINDINGS])
def classify(material,elapsed,mode):
if elapsed<=3:return 'none'
if material is None:return 'none'
if 120<=material<=129:return 'damage160'
if 110<=material<=119:return 'damage164'
if mode!=0:return 'none'
if 60<=material<=69:return 'fence_candidate'
if material==180:return 'ladder_candidate'
return 'none'
def generate(original,output):
original=Path(original).resolve();output=Path(output).resolve()
if output.is_relative_to(original) or original.is_relative_to(output):raise ValueError('Separate output required')
if output.exists() and any(p.is_symlink() for p in output.rglob('*')):raise ValueError('Generated output contains symlinks')
report=collect(original);output.mkdir(parents=True,exist_ok=True)
source=Path(__file__).with_name('jimmy_special_contact_probe.c').read_text()
(output/'jimmy_special_contact_probe.c').write_text(source)
(output/'source.json').write_text(json.dumps(report,indent=2)+'\n');return report
if __name__=='__main__':
p=argparse.ArgumentParser();p.add_argument('original',type=Path);p.add_argument('--generate-probe',type=Path);a=p.parse_args()
print(json.dumps(generate(a.original,a.generate_probe) if a.generate_probe else collect(a.original),indent=2))