AsmJit

AsmJit is a lightweight library for machine code generation written in C++ language.

• Official Home Page (asmjit.com)


• Official Repository (asmjit/asmjit)


• Public Chat Channel


• Zlib License

See asmjit.com page for more details, examples, and documentation.

Documentation

• Documentation Index


• Build Instructions

Breaking Changes

Breaking the API is sometimes inevitable, what to do?

• See Breaking Changes Guide, which is now part of AsmJit documentation.


• See asmjit tests, they always compile and provide implementation of many use-cases:
  
  
  • asmjit_test_emitters.cpp - Tests that demonstrate the purpose of emitters.
  
  
  • asmjit_test_assembler_x86.cpp - Tests targeting AsmJit's Assembler (x86/x64).
  
  
  • asmjit_test_compiler_x86.cpp - Tests targeting AsmJit's Compiler (x86/x64).
  
  
  • asmjit_test_instinfo.cpp - Tests that query instruction information.
  
  
  • asmjit_test_x86_sections.cpp - Multiple sections test.
  
  
  
  


• Visit our Official Chat if you need a quick help.

Project Organization

• / - Project root.
  
  
  • src - Source code.
  
  
  • asmjit - Source code and headers (always point include path in here).
    
    
    • core - Core API, backend independent except relocations.
    
    
    • arm - ARM specific API, used only by ARM and AArch64 backends.
    
    
    • x86 - X86 specific API, used only by X86 and X64 backends.
    
    
    
    
  
  
  • test - Unit and integration tests (don't embed in your project).
  
  
  • tools - Tools used for configuring, documenting, and generating files.
  
  
  
  

TODO

• [ ] Core:
  
  
  • [ ] Add support for user external buffers in CodeBuffer / CodeHolder.
  
  
  • [ ] Register allocator doesn't understand register pairs, affected instructions:
  
  
  • [ ] v4fmaddps, v4fmaddss, v4fnmaddps, v4fnmaddss
  
  
  • [ ] vp4dpwssd, vp4dpwssds
  
  
  • [ ] vp2intersectd, vp2intersectq
  
  
  
  


• [ ] Ports:
  
  
  • [ ] ARM/Thumb/AArch64 support.
  
  
  
  

Support

• AsmJit project has both community and commercial support, see AsmJit's Support Page


• You can help the development and maintenance through Petr Kobalicek's GitHub sponsors Profile

Notable Donors List:

• ZehMatt

Authors & Maintainers

• Petr Kobalicek [email protected]