Assembler toolkit based on AsmJit.
- Official Repository (asmjit/asmtk)
- Official Blog (asmbits)
- Official Chat (gitter)
- Permissive ZLIB license
AsmTK is a sister project of AsmJit library, which provides concepts that are useful mostly in AOT code-generation.
- Both X86 and X64 modes are supported and can be selected at runtime (i.e. they not depend on how your application is compiled).
- Asm parser can parse everything that AsmJit provides (i.e. supports all instruction sets, named labels, etc...).
- Asm parser can also parse instruction aliases defined by AsmTK (like
movsb,cmpsb,sal, ...). AsmJit provides just genericmovs,cmps, etc... so these are extras that are handled and recognized by AsmTK. - Assembles to any
BaseEmitter, which means that you can choose betweenAssemblerandBaseBuilderat runtime, and that the result can be post-processed as well - More to be added...
- More aliases to some SIMD instructions (to be added).
- Implement asmtk::Linker that will add the possibility to write shared libraries and executables.
Assembler parsing is provided by AsmParser class, which emits to BaseEmitter:
#include <asmtk/asmtk.h> using namespace asmjit; using namespace asmtk; // Used to print binary code as hex. static void dumpCode(const uint8_t* buf, size_t size) { constexpr uint32_t kCharsPerLine = 39; char hex[kCharsPerLine * 2 + 1]; size_t i = 0; while (i < size) { size_t j = 0; size_t end = size - i < kCharsPerLine ? size - i : size_t(kCharsPerLine); end += i; while (i < end) { uint8_t b0 = buf[i] >> 4; uint8_t b1 = buf[i] & 15; hex[j++] = b0 < 10 ? '0' + b0 : 'A' + b0 - 10; hex[j++] = b1 < 10 ? '0' + b1 : 'A' + b1 - 10; i++; } hex[j] = '\0'; puts(hex); } } int main(int argc, char* argv[]) { // Setup CodeHolder for X64. Environment env(Arch::kX64); CodeHolder code; code.init(env); // Attach x86::Assembler to `code`. x86::Assembler a(&code); // Create AsmParser that will emit to x86::Assembler. AsmParser p(&a); // Parse some assembly. Error err = p.parse( "mov rax, rbx\n" "vaddpd zmm0, zmm1, [rax + 128]\n"); // Error handling (use asmjit::ErrorHandler for more robust error handling). if (err) { printf("ERROR: %08x (%s)\n", err, DebugUtils::errorAsString(err)); return 1; } // Now you can print the code, which is stored in the first section (.text). CodeBuffer& buffer = code.sectionById(0)->buffer(); dumpCode(buffer.data(), buffer.size()); return 0; }You should check out the test directory to see how AsmTK integrates with AsmJit.
- Petr Kobalicek kobalicek.petr@gmail.com