machina 0.5.0

Manage and execute assembly at runtime.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# machina [![crates.io](https://img.shields.io/crates/v/machina.svg)](https://crates.io/crates/machina) [![docs.rs](https://docs.rs/machina/badge.svg)](https://docs.rs/machina)  

Manage and execute assembly at runtime.

## Crossplatform?

Yap.

## Why?

Emulators, JIT, dynarec, etc.

## Example

```rust
extern crate machina;
#[macro_use]

extern crate sam; // just to keep it simple

use machina::cache::{Cache, STUB};
use machina::memory::Memory;

fn main() {
    let asm = format!("mov rax, {}", STUB); // fill in a dummy address
    let dummy = 64;
    let address = &dummy as *const _; // address of dummy

    let cache = Cache::new(true); // optimize?
    let memory = Memory::new(1); // 1 page = 4096 bytes
    cache.insert("mov_rax_x".to_string(), sam!(x64 => &asm)); // create the bytes at compile time via sam

    memory.emit_bytes(cache.get_stub("mov_rax_x", address as u64)) // get "mov_rax_x" and fill in a dynamic address
    let rax = memory.execute(); // returns rax
}
```