Compatibility¶
Python capa 10.0.0 is the behavioral reference (see PINNED.md). binfera is a native backend, not a replacement for every capa input format. Each input below carries a different kind of claim; do not read one row's evidence into another.
Inputs¶
| Input | Status | Oracle |
|---|---|---|
| PE x86/x64 | Supported | Python capa 10.0.0 (Vivisect) |
| ELF x86/x64 | Supported | Python capa 10.0.0 (Vivisect) |
| Raw shellcode, 32/64-bit | Supported | Python capa 10.0.0 (sc32/sc64) |
| .NET / CLR managed PE | Supported | Python capa 10.0.0 (dnfile) |
| capa freeze files | Supported | Python capa 10.0.0 |
| ELF AArch64 | Supported | Pinned Ghidra BinExport2 fixtures (no raw-AArch64 Python oracle) |
| PE AArch64 | Extension | None |
| Mach-O x86_64 / arm64 / arm64e | Extension | None |
| ARM32/Thumb (PE, ELF), MIPS32 (ELF) | Extension | None (source-built fixtures) |
| External disassembler databases and BinExport | Non-goal | n/a |
Unsupported inputs are rejected with context, never silently accepted or partially analyzed.
Claim classes¶
| Class | Members | Evidence |
|---|---|---|
| Upstream parity | PE, ELF, shellcode, .NET | Direct comparison with Python capa (benchmarks) |
| Cross-backend parity | AArch64 ELF | Feature- and rule-level comparison with Ghidra BinExport2 (benchmarks) |
| binfera extension | Mach-O, AArch64 PE, ARM32/Thumb, MIPS32 | Hand-built or source-built fixtures; never claimed as upstream parity |
| Not covered | Evidence-tree identity, ISAs not listed above, dynamic extractors | n/a |
Format notes¶
- Mach-O is not accepted by pinned capa at all, so it is an extension.
-f autodetects it after PE and ELF and before freeze files, which keeps upstream's order for every format capa knows;-f machoforces it. Thin and fat binaries are supported;--archselects a slice, otherwise the first supported slice in fat-header order is used. - AArch64 decoding, recovery, and extraction (
disarm64, no external disassembler) are shared by ELF, Mach-O, and PE. Only ELF has an oracle. - ARM32/Thumb and MIPS32 use Capstone for decoding. Rules accept
arch: armandarch: mips(both byte orders). See Decompiler for the supported profiles. - .NET: a CLR PE is auto-detected and routed to the .NET backend.
-f peforces the native x86 path,-f dotnetforces .NET. Mixed-mode assemblies are analyzed for managed methods only, as in upstream, and carry the "mixed mode" characteristic feature.
Measurements (accuracy, performance, reproduction) are in benchmarks.md.
binfera follows upstream capa on a best-effort basis; each supported version is re-verified with the full differential suite before the pin moves.