x86-zig

A library for assembling x86 instructions written in zig.

Example

const warn = @import("std").debug.warn;

const x86 = @import("src/x86.zig");

pub fn main() anyerror!void {
    const machine64 = x86.Machine.init(.x64);

    // MOV RAX, R15
    {
        const op1 = x86.Operand.register(.RAX);
        const op2 = x86.Operand.register(.R15);
        const instr = try machine64.build2(.MOV, op1, op2);
        warn("{x}\t\t\tMOV\t\t{}, {}\n", .{instr.asSlice(), op1, op2});
    }

    // LOCK MOV DWORD PTR FS:[8*ECX + EBX + 0x33221100], EAX
    {
        const op1 = x86.Operand.memorySib(.FS, .DWORD, 8, .ECX, .EBX, 0x33221100);
        const op2 = x86.Operand.register(.EAX);
        const instr = try machine64.build2_pre(.Lock, .MOV, op1, op2);
        warn("{x}\tLOCK MOV\t{}, {}\n", .{instr.asSlice(), op1, op2});
    }

    // JMP -20
    {
        const op1 = x86.Operand.immediateSigned(-20);
        const instr = try machine64.build1(.JMP, op1);
        warn("{x}\t\t\tJMP\t\t{}\n", .{instr.asSlice(), op1});
    }
}

Building examples

example-hello

Assembles, loads to RAM, and executes a simple hello world program (Linux-x64).

zig build example-hello

License

Licensed under either of

• Public domain (UNLICENSE or https://unlicense.org/)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.