Skip to content

decomp-mirror/rellume

 
 

Repository files navigation

Rellume — Lifts x86-64 to LLVM IR

Rellume is a lifter for x86-64 machine code to LLVM IR with focus on the performance of the lifted code. The generated LLVM IR can be compiled and executed again, for example using LLVM's JIT compiler, ideally having the same (or even better) performance as the original code. Special care is taken to model the SSE instructions and pointers in a way that the optimizer can generate efficient code. The lifter operates on a set of specified instructions (or decodes the control flow automatically) and creates an LLVM-IR function with the same semantics. These functions operate on a generic structure containing the virtual x86-64 CPU state, but can be wrapped for an arbitrary calling convention.

Use Cases

  • Binary rewriting:
    • Performance improvement: specialization for runtime data, e.g. known parameters or memory locations. This is implemented in the LLVM back-end of DBrew.
    • Instrumentation: insert tracing and interception code in hot code paths, where high quality machine code is required.
  • Binary analysis: existing tooling for analysis of LLVM IR code can be re-used for binary code.

Example

See examples/lifter.c

Publications

  • Alexis Engelke and Josef Weidendorfer. Using LLVM for Optimized Light-Weight Binary Re-Writing at Runtime. In Proceedings of the 22nd int. Workshop on High-Level Parallel Programming Models and Supportive Environments (HIPS 2017). Orlando, US, 2017 (PDF of pre-print version)

License

LGPLv2.1+

About

Lift x86-64 to performant LLVM IR

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 95.5%
  • Python 1.8%
  • Meson 1.4%
  • C 1.3%