Files
reverse-engineering-anything/src/domain/elfRelocation.ts
T

67 lines
2.1 KiB
TypeScript

import { err, ok, type Result } from "./result.js";
interface ElfRelocationEntry {
readonly offset: bigint;
readonly type: number;
readonly symbolIndex: number;
}
interface ElfRelaEntry extends ElfRelocationEntry {
readonly addend: bigint;
}
interface ElfRelocationFailure {
readonly kind: "malformed";
readonly message: string;
}
/** The class-specific r_info split, shared by fixed and Android packed records. */
export const decodeElfRelocationInfo = (info: bigint, bits: 32 | 64) => ({
type: Number(info & (bits === 64 ? 0xffffffffn : 0xffn)),
symbolIndex: Number(info >> (bits === 64 ? 32n : 8n)),
});
export function readElfRelocationEntry(
bytes: Uint8Array,
bits: 32 | 64,
littleEndian: boolean,
encoding: "rel",
): Result<ElfRelocationEntry, ElfRelocationFailure>;
export function readElfRelocationEntry(
bytes: Uint8Array,
bits: 32 | 64,
littleEndian: boolean,
encoding: "rela",
): Result<ElfRelaEntry, ElfRelocationFailure>;
/** Decode standard REL/RELA fields; architecture-specific application remains with consumers. */
export function readElfRelocationEntry(
bytes: Uint8Array,
bits: 32 | 64,
littleEndian: boolean,
encoding: "rel" | "rela",
): Result<ElfRelocationEntry | ElfRelaEntry, ElfRelocationFailure> {
const wordBytes = bits === 64 ? 8 : 4;
if (bytes.byteLength < wordBytes * (encoding === "rela" ? 3 : 2))
return err({
kind: "malformed",
message: "ELF relocation entry is truncated",
});
const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
const offset =
bits === 64
? view.getBigUint64(0, littleEndian)
: BigInt(view.getUint32(0, littleEndian));
const info =
bits === 64
? view.getBigUint64(wordBytes, littleEndian)
: BigInt(view.getUint32(wordBytes, littleEndian));
const entry = {
offset,
...decodeElfRelocationInfo(info, bits),
};
if (encoding === "rel") return ok(entry);
const addend =
bits === 64
? view.getBigInt64(wordBytes * 2, littleEndian)
: BigInt(view.getInt32(wordBytes * 2, littleEndian));
return ok({ ...entry, addend });
}