Skip to content

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 auto detects it after PE and ELF and before freeze files, which keeps upstream's order for every format capa knows; -f macho forces it. Thin and fat binaries are supported; --arch selects 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: arm and arch: mips (both byte orders). See Decompiler for the supported profiles.
  • .NET: a CLR PE is auto-detected and routed to the .NET backend. -f pe forces the native x86 path, -f dotnet forces .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.