# Copyright (c) 2026 Peiikai (MIT; see THIRD_PARTY_NOTICES.md). """NSO loader: decompress segments, build the memory image, parse MOD0/dynamic info.""" import struct import sys from collections import Counter import lz4.block DT_NULL, DT_NEEDED, DT_PLTRELSZ, DT_HASH, DT_STRTAB, DT_SYMTAB, DT_RELA, DT_RELASZ = 0, 1, 2, 4, 5, 6, 7, 8 DT_STRSZ, DT_JMPREL, DT_RELACOUNT = 10, 23, 0x6FFFFFF9 DT_RELRSZ, DT_RELR, DT_GNU_HASH = 0x23, 0x24, 0x6FFFFEF5 R_AARCH64_ABS64, R_AARCH64_GLOB_DAT, R_AARCH64_JUMP_SLOT, R_AARCH64_RELATIVE = 257, 1025, 1026, 1027 class Nso: def __init__(self, path): raw = open(path, 'rb').read() assert raw[:4] == b'NSO0', path flags = struct.unpack_from('> 32, r_add)) # DT_RELR (1.4.3): packed RELATIVE relocations whose addend is the word in place. An even entry is an address # (relocate it, continue after it); an odd entry is a bitmap of the next 63 words. if DT_RELR in dyn: where = 0 for i in range(dyn[DT_RELRSZ] // 8): e = self.u64(dyn[DT_RELR] + i * 8) if e & 1 == 0: self.relocs.append((e, R_AARCH64_RELATIVE, 0, self.u64(e))) where = e + 8 continue for k in range(63): if e >> (k + 1) & 1: a = where + k * 8 self.relocs.append((a, R_AARCH64_RELATIVE, 0, self.u64(a))) where += 63 * 8 def symbol_count(self): """Number of .dynsym entries: DT_HASH nchain, else one past the last symbol a DT_GNU_HASH chain reaches.""" dyn = self.dyn if DT_HASH in dyn: return self.u32(dyn[DT_HASH] + 4) if DT_GNU_HASH not in dyn: return 0 h = dyn[DT_GNU_HASH] nbuckets, symoffset, bloom_size = self.u32(h), self.u32(h + 4), self.u32(h + 8) buckets = h + 16 + bloom_size * 8 last = max([self.u32(buckets + 4 * i) for i in range(nbuckets)] + [0]) if last < symoffset: return symoffset chains = buckets + 4 * nbuckets while not self.u32(chains + 4 * (last - symoffset)) & 1: last += 1 return last + 1 def cstr(self, off): end = self.image.index(b'\0', off) return self.image[off:end].decode('utf-8', 'replace') def imports(self): return [s for s in self.syms if s[0] and s[2] == 0] def exports(self): return [s for s in self.syms if s[0] and s[2] != 0] if __name__ == '__main__': for p in sys.argv[1:]: n = Nso(p) print(f'== {p} build {n.build_id[:16]} image 0x{n.size:x}') print(f' text 0x{n.text[0]:x}+0x{n.text[1]:x} ro 0x{n.rodata[0]:x}+0x{n.rodata[1]:x} ' f'data 0x{n.data[0]:x}+0x{n.data[1]:x} bss 0x{n.bss_size:x}') print(f' needed {n.needed} syms {len(n.syms)} imports {len(n.imports())} exports {len(n.exports())}') print(f' relocs {dict(Counter(r[1] for r in n.relocs))}')