* fix(ghidra): inspect carved MIPS ABI declarations without missing sections * test: share filesystem fixtures and cleanup assertions
93 lines
4.2 KiB
TypeScript
93 lines
4.2 KiB
TypeScript
import type { BinaryTarget } from "../domain/binaryTargetTypes.js";
|
|
import type { JsonValue } from "../domain/jsonValue.js";
|
|
|
|
/** Keep family recognition separate from the deliberately bounded Ghidra lane. */
|
|
export const ghidraMipsUnsupportedReason = (
|
|
target: BinaryTarget,
|
|
): string | null => {
|
|
if (target.kind !== "executable" || target.architecture !== "mips")
|
|
return null;
|
|
const metadata = target.mips;
|
|
if (target.format !== "elf" || metadata === undefined)
|
|
return "MIPS analysis requires ELF header metadata; a family name alone does not select an ISA or ABI.";
|
|
if (metadata.elfClass !== 32)
|
|
return "This Ghidra MIPS lane supports ELF32 only; MIPS64 and n64 remain unsupported.";
|
|
if (metadata.type !== 2)
|
|
return "This Ghidra MIPS lane supports ET_EXEC only; relocatable objects, shared images and PSP PRX need separate load verification.";
|
|
if ((metadata.flags & 0x0f000000) !== 0)
|
|
return "MIPS16, microMIPS and other ASE encodings are outside this standard-instruction MIPS lane.";
|
|
if ((metadata.flags & 0x00ff0000) !== 0)
|
|
return "Machine-specific MIPS variants, including PSP Allegrex, need a separately supported processor profile.";
|
|
if ((metadata.flags & 0xf0000000) !== 0x70000000)
|
|
return "This Ghidra MIPS lane requires EF_MIPS_ARCH_32R2; other ISA revisions need separate verification.";
|
|
if (
|
|
(metadata.flags & 0x0000f000) !== 0x00001000 ||
|
|
(metadata.flags & 0x20) !== 0
|
|
)
|
|
return "This Ghidra MIPS lane requires an explicit o32 ABI; unspecified, n32 and EABI targets remain unsupported.";
|
|
if ((metadata.flags & 0x00000200) !== 0)
|
|
return "EF_MIPS_FP64 requires separate verification of 64-bit floating-point register semantics in this Ghidra lane.";
|
|
if ((metadata.flags & 0x00000400) !== 0)
|
|
return "EF_MIPS_NAN2008 requires separate verification of NaN encoding semantics in this Ghidra lane.";
|
|
const abi = metadata.abiFlags;
|
|
if (abi === undefined || abi === null)
|
|
return [
|
|
"This Ghidra MIPS lane requires an inspected ABI flags record; header flags alone do not establish the floating-point ABI.",
|
|
...(metadata.limitations ?? []),
|
|
].join(" ");
|
|
if (abi.version !== 0)
|
|
return "This Ghidra MIPS lane requires ABI flags version 0; newer record semantics are unsupported.";
|
|
if (abi.isaLevel !== 32 || abi.isaRevision !== 2)
|
|
return "MIPS ABI flags must agree with the declared MIPS32r2 ISA.";
|
|
if (abi.gprSize !== 1 || abi.cpr1Size !== 1 || abi.cpr2Size !== 0)
|
|
return "This Ghidra MIPS lane requires 32-bit GPR/CPR1 and no CPR2; other register modes need separate verification.";
|
|
if (abi.fpAbi !== 1 && abi.fpAbi !== 5)
|
|
return "This Ghidra MIPS lane admits double-precision or FPXX ABI declarations only; soft-float, FP64 and unspecified modes need separate verification.";
|
|
if (abi.isaExtension !== 0 || abi.ases !== 0)
|
|
return "MIPS ABI flags declare an ISA extension or ASE outside this standard-instruction lane.";
|
|
if ((abi.flags1 & ~1) !== 0 || abi.flags2 !== 0)
|
|
return "MIPS ABI flags contain unsupported general flags.";
|
|
return null;
|
|
};
|
|
|
|
/** Commit source ELF interpretation without confusing target ISA with host CPU. */
|
|
export const ghidraMipsProfileParameters = (
|
|
target: BinaryTarget,
|
|
): Readonly<Record<string, JsonValue>> => {
|
|
if (
|
|
target.kind !== "executable" ||
|
|
target.architecture !== "mips" ||
|
|
target.mips === undefined
|
|
)
|
|
return {};
|
|
const abi = target.mips.abiFlags;
|
|
return {
|
|
mips_elf: {
|
|
elf_class: target.mips.elfClass,
|
|
byte_order: target.mips.byteOrder,
|
|
type: target.mips.type,
|
|
flags: target.mips.flags,
|
|
...(target.mips.limitations === undefined
|
|
? {}
|
|
: { abi_flags_limitations: [...target.mips.limitations] }),
|
|
abi_flags:
|
|
abi === undefined || abi === null
|
|
? null
|
|
: {
|
|
version: abi.version,
|
|
isa_level: abi.isaLevel,
|
|
isa_revision: abi.isaRevision,
|
|
gpr_size: abi.gprSize,
|
|
cpr1_size: abi.cpr1Size,
|
|
cpr2_size: abi.cpr2Size,
|
|
fp_abi: abi.fpAbi,
|
|
isa_extension: abi.isaExtension,
|
|
ases: abi.ases,
|
|
flags1: abi.flags1,
|
|
flags2: abi.flags2,
|
|
},
|
|
},
|
|
mips_support_lane: "elf32-exec-o32-arch32r2-standard-v3",
|
|
};
|
|
};
|