2 stable releases

1.0.1 Aug 8, 2023

#147 in FFI

33 downloads per month

BSD-3-Clause

5KB

Machinecode

Execute machine code in hex form.

This repo includes both a Rust package and a utility called jitrun.

It was inspired by this post: Hello, JIT World: The Joy of Simple JITs.

This is a port of jit from Go to Rust.

Example use on x86_64

Return the number 42:

cargo run -p jitrun -- examples/42.mc

Contents of 42.mc:

// This program moves 42 into eax and returns

b8 2a 00 00 00  // mov 0x2a000000 into the eax register. b8 is the "mov eax" part. 2a is 42.
c3              // return to the caller (the return value is held in eax)

Calculate the square root of 1024:

cargo run -p jitrun -- examples/sqrt.mc

Contents of sqrt.mc:

// This program takes the square root of 1024 and returns the answer (in eax), which is 32

b8 00 04 00 00  // mov 1024 (0x0400) into eax (0x00 comes first and then 0x04, because it is little-endian)
f3 0f 2a c0     // mov eax into the xmm0 register
f3 0f 51 c0     // take the square root of the xmm0 register and place it into xmm0
f3 0f 2c c0     // move xmm0 back into eax
c3              // return to the caller (the return value is held in eax)

General info

  • Version: 0.1.0
  • License: BSD-3

Dependencies

~42KB