"""Minimal i860 COFF (magic 0x014d) reader: dump file header, sections, and the
symbol table (function/global names + section + value). Deterministic -- no
instruction decoding -- so it is a trustworthy reference map of the firmware
objects. Validates the format by checking the symbol names look like the known
AS860/PGI source (e.g. _createBang, _PAZsfx)."""
import sys, struct, glob, os

def rd(b, off, fmt): return struct.unpack_from(fmt, b, off)

def parse(path):
    d = open(path, 'rb').read()
    magic, nscns, timdat, symptr, nsyms, opthdr, flags = rd(d, 0, '<HHIIIHH')
    out = {'path': path, 'magic': magic, 'nscns': nscns, 'nsyms': nsyms,
           'symptr': symptr, 'opthdr': opthdr, 'flags': flags,
           'sections': [], 'syms': []}
    # section headers
    base = 20 + opthdr
    for i in range(nscns):
        o = base + i * 40
        name = d[o:o+8].split(b'\0')[0].decode('latin1')
        paddr, vaddr, size, scnptr, relptr, lnnoptr, nreloc, nlnno, sflags = \
            rd(d, o + 8, '<IIIIIIHHI')
        out['sections'].append((name, vaddr, size, scnptr, nreloc, sflags))
    # symbol table (18-byte SYMENT) + string table right after
    strbase = symptr + nsyms * 18
    def symname(o):
        z, offs = rd(d, o, '<II')
        if z == 0:  # name is an offset into the string table
            e = d.index(b'\0', strbase + offs)
            return d[strbase + offs:e].decode('latin1')
        return d[o:o+8].split(b'\0')[0].decode('latin1')
    i = 0
    while i < nsyms:
        o = symptr + i * 18
        nm = symname(o)
        value, scnum, typ, sclass, naux = rd(d, o + 8, '<iHHBB')
        out['syms'].append((nm, value, scnum, typ, sclass, naux))
        i += 1 + naux
    return out

SCLASS = {2: 'EXT', 3: 'STAT', 6: 'LABEL', 100: '.bb', 101: '.file'}

def report(o, want_funcs=True):
    print(f"\n=== {os.path.basename(o['path'])}  magic={o['magic']:#06x} "
          f"nscns={o['nscns']} nsyms={o['nsyms']} ===")
    for (name, vaddr, size, scnptr, nreloc, sf) in o['sections']:
        print(f"  sect {name:<10} vaddr={vaddr:#010x} size={size:#08x} "
              f"reloc={nreloc}")
    # external/static functions (scnum>0, class EXT/STAT), text-ish
    funcs = [(nm, v, sc) for (nm, v, sn, ty, sc, na) in o['syms']
             if sn > 0 and sc in (2, 3) and not nm.startswith('.')]
    print(f"  -- {len(funcs)} defined EXT/STAT symbols:")
    for nm, v, sc in sorted(funcs, key=lambda x: x[1]):
        print(f"     {v:#010x} {SCLASS.get(sc,sc):<5} {nm}")

if __name__ == '__main__':
    pats = sys.argv[1:] or [r'C:\VWE\TeslaRel410\sda4\DPL3\VRENDER\*.O']
    files = []
    for p in pats: files += glob.glob(p)
    for f in sorted(files):
        try:
            report(parse(f))
        except Exception as e:
            print(f"\n=== {f}: PARSE FAILED: {e} ===")