write_x86_64

Crates.iowrite_x86_64
lib.rswrite_x86_64
version0.2.0
sourcesrc
created_at2022-10-20 11:41:00.963998
updated_at2022-11-22 08:39:35.074819
descriptionCrate to help you write x86_64 assembly code
homepage
repositoryhttps://github.com/samsa1/write_x86_64
max_upload_size
id692395
size171,375
(samsa1)

documentation

README

write_x86_64 rust crate

Objective

This crate is written in the purpose of helping people implement a x86_64 assembly backend for a compiler in rust. Thus, this crate implements data structures to write simple x86_64 instructions but also type check those instructions.

Usage

Generate a Hello World program for x86_64 macOS (also works on Linux)

use write_x86_64::*;

fn main() {
    let file_name = "asm_file.s";

    let text_ss = Segment::label(new_label("main"))
        + pushq(reg!(RBP))
        + leaq(lab!(new_label("my_string")), RDI)
        + call(reg::Label::printf())
        + leaq(lab!(new_label("my_string2")), RDI)
        + call(reg::Label::printf())
        + xorq(reg!(RAX), reg!(RAX))
        + popq(RBP)
        + ret();

    let data_ss = Data::label(new_label("my_string"))
        + data::dasciz("Hello".to_string())
        + Data::label(new_label("my_string2"))
        + data::dasciz(" World\\n".to_string());

    let file = file::File {
        globl: Some(new_label("main")),
        text_ss,
        data_ss,
    };

    file.print_in(file_name).unwrap();
}

Contributing

Contribution are welcomed, you can also ask to add some instructions if you are using this crate and would want more instructions available.

Future work

We are currently trying to implement DWARF debug symbols. Any contribution, testing, comment are welcomed.

Project using this crate:

Commit count: 31

cargo fmt