asmjit/asmtk

Assembler toolkit based on AsmJit

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

Contributing

• See CONTRIBUTING page for more details

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 Gitter 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

Ports

• 32-bit ARM/Thumb port (work in progress)
• RISC-V port (not in progress, help welcome)

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]

asmtk's Issues

assembler.call(x86::ptr(x86::esp, x86::eax)); Not Working

Please help me..

this code compile 'call [esp+eax]', but not execute and does not work.

Can it be increased for use in the kernel?

Can it be increased for use in the kernel?

String instructions not supported (including rep prefix)

failed to generate valid assembly for instruction

failed to generate valid assembly for instruction:
fstp qword ptr fs:[rcx], st0

movdqa xmm0, xmmword ptr [ebx]

README.md(AsmParser Usage Guide) does not compile.

CodeHolder code(ci); does not work well with ASMJIT_API CodeHolder() noexcept; .

how to use "mov eax, fs:[reg+ value]"?

how to use "mov eax, fs:[reg+ value]" using x86::Assembler?

Request for AArch64 support

It seems that AArch64 is not supported yet?

Short jump command with an out of range address isn't rejected

For example, if EIP is 0x1000, and I assemble jmp short 0x2000, the command should be rejected, because the displacement is larger than ±0x7F.
I assume that the relevant code is around here:

asmtk/src/asmtk/asmparser.cpp

Lines 708 to 711 in 4fc1568

	if (option == X86Inst::kOptionShortForm) {
	options |= option;
	return kErrorOk;
	}

Does it support Anonymous local labels (@@)

Multiple Label bug

asmjit/asmjit#206 (comment)

Syntax is not fully compatible

"push [ecx]" needs to be changed to "push dword [ecx]" to be compiled,

In addition, if "AsmParser:: parse" has errors in multiple lines of code, you need to delete them one line at a time to eliminate the errors. No line number or error location is returned.

Add comments starting with "//"

Some assemblers have comments beginning with "//". To increase compatibility, consider supporting this syntax

The "loop" instruction is not supported

Labels problem

int main( int argc , char** argv )
{
	CodeInfo ci( ArchInfo::kTypeX64 );
	CodeHolder code;
	code.init( ci );

	X86Assembler a( &code );
	AsmParser p( &a );

	Error err = p.parse(
		"call label0\n" // label god
		"nop\n"
		"ret\n"
		"label0:\n"
		"call label1\n" // label error
		"nop\n"
		"ret\n"
		"label1:\n"
		"nop\n"
		"ret\n"
	);

	if ( err )
	{
		printf( "ERROR: %08x (%s)\n" , err , DebugUtils::errorAsString( err ) );
		getchar();
		return 0;
	}

	code.sync();

	CodeBuffer& buffer = code.getSectionEntry( 0 )->getBuffer();
	dumpCode( buffer.getData() , buffer.getLength() );

	printf( "code: %p\n" , buffer.getData() );
	printf( "getLabelsCount: %i\n" , code.getLabelsCount() );
}

output:
E80200000090C3E80404040490C390C3
getCodeSize: 16
getLabelsCount: 3

000002E950F0E9A0     | E8 02 00 00 00                          | call 2E950F0E9A7                             |
000002E950F0E9A5     | 90                                      | nop                                          |
000002E950F0E9A6     | C3                                      | ret                                          |
000002E950F0E9A7     | E8 04 04 04 04                          | call 2E954F4EDB0                             |
000002E950F0E9AC     | 90                                      | nop                                          |
000002E950F0E9AD     | C3                                      | ret                                          |
000002E950F0E9AE     | 90                                      | nop                                          |
000002E950F0E9AF     | C3                                      | ret                                          |

如何增加对自定义未知指令的识别能力

能否给个例子

比如我想 ret c3 变成 0F 0F 75 c3 为 ret

X64 MOV RSP,8 why mov esp,8

x64dbg
// XED
00007FFC9220063A | 48:C7C4 08000000 | mov rsp,8 |
//ASMJIT
00007FFC92200641 | BC 08000000 | mov esp,8 |

push register not working!

sentences like push eax , or pushad not parse but push 0x11111111 works fine.
it say "Invalid instruction" error.
can someone help me??

MSVC compiler warnings

Getting the following warnings when building on 64 bit MSVC:

asmtk\asmparser.cpp(1075,9): warning C4267: 'argument': conversion from 'size_t' to 'uint32_t', possible loss of data
asmtk\asmparser.cpp(1152,39): warning C4267: 'initializing': conversion from 'size_t' to 'uint32_t', possible loss of data

That's these 2 lines:

asmtk/src/asmtk/asmparser.cpp

Line 1075 in 6930021

ASMJIT_PROPAGATE(_emitter->embed(db.data(), db.size()));

asmtk/src/asmtk/asmparser.cpp

Line 1152 in 6930021

uint32_t size = tmp.size;

Can this be published to VCPKG as well?

"db" instruction: 0000001b (InvalidInstruction)

Hi, there is an error when using the "db" command. How do I use the "db" command correctly, thank you

This is my code:

#include <iostream>
#include <asmjit/asmjit.h>
#include <asmtk/asmtk.h>

using namespace asmjit;
using namespace asmtk;

int main(int argc, char* argv[]) {
  Environment env = hostEnvironment();
  CodeHolder code;
  code.init(env);

  x86::Assembler a(&code);
  AsmParser p(&a);

  Error err = p.parse(
    "main:\n"
    "db 0x90 0x90 0x90 0x90 0x90\n"
  );

  if (err) {
    printf("ERROR: %08x (%s)\n", err, DebugUtils::errorAsString(err));
    return 1;
  }

  printf("%p\n", a.bufferData());
  getchar();
  return 0;
}

Waiting for vcpkg support

coz i dont understand how to build & use to my project
im waiting for vcpkg support thanks

wrong assembly for: enter 0, 9

See x64dbg/x64dbg#1682 for details...

Tested on the latest master for both asmtk and asmjit.

AsmTK only allows lowercase instruction names, keywords, and registers

It should accept also uppercased and mixedcased names except labels and symbols.

assembler.sub(x86::ptr(x86::esp, 3), 0x4444); Not Compile!

assembler.sub(x86::ptr(x86::esp, 3), 0x4444);

this instruction not compile and return nothing!