libloong - Rust Bindings

Rust bindings for the libloong LoongArch emulator.

Quick Start

Add to your Cargo.toml:

[dependencies]
libloong = "0.6"

Example: Running a LoongArch ELF

use libloong::Machine;
use std::fs;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let binary = fs::read("program.elf")?;
    let mut machine = Machine::new(&binary, Default::default())?;

    Machine::setup_linux_syscalls();
    machine.setup_linux(&["program"], &[])?;

    machine.simulate(u64::MAX)?;

    println!("Exit code: {}", machine.return_value());
    Ok(())
}

Calling Guest Functions

// Call by name and get integer return value
machine.vmcall("factorial", &[5])?;
let result = machine.return_value();
println!("factorial(5) = {}", result);

// Call by address
let func_addr = machine.address_of("factorial");
machine.vmcall(func_addr, &[5])?;
let result = machine.return_value();

// For functions returning floats:
machine.vmcall("sin_approx", &[])?;
let result_f32 = machine.return_value_f32();
let result_f64 = machine.return_value_f64();

Building

Requirements:

• CMake 3.15+
• C++20 compiler (GCC 14+ or Clang 18+)
• Rust 1.70+

cargo build --release

The build script automatically builds the C++ library using CMake.

Examples

Run the examples (test programs are located in ../tests/programs/):

cargo run --example hello_world -- ../tests/programs/hello_world.elf
cargo run --example vmcall -- ../tests/programs/factorial.elf factorial 5

Building LoongArch Programs

loongarch64-linux-gnu-gcc -O2 -static \
    -Wl,-Ttext-segment=0x200000 \
    -o program.elf program.c

The -Wl,-Ttext-segment=0x200000 flag is required for the flat memory model.

Features

binary-translation (enabled by default)

Enables JIT compilation for better performance. This feature requires network access during build phase (although only once).

To disable:

[dependencies]
libloong = { version = "0.6", default-features = false }