rust/Readme.md
2020-03-12 11:19:26 +01:00

1.9 KiB

WIP Cranelift codegen backend for rust

⚠⚠⚠ Threads and certain kinds of FFI don't work yet. ⚠⚠⚠

Building

$ git clone https://github.com/bjorn3/rustc_codegen_cranelift.git
$ cd rustc_codegen_cranelift
$ ./prepare.sh # download and patch sysroot src and install hyperfine for benchmarking
$ ./test.sh --release

Usage

$cg_clif_dir is the directory you cloned this repo into in the following instruction.

Cargo

$ CHANNEL="release" $cg_clif_dir/cargo.sh run

If you compiled cg_clif in debug mode you should use CHANNEL="debug" instead or omit CHANNEL="release" completely.

Rustc

$ rustc -Cpanic=abort -Zcodegen-backend=$cg_clif_dir/target/release/librustc_codegen_cranelift.so --sysroot $cg_clif_dir/build_sysroot/sysroot my_crate.rs

Env vars

CG_CLIF_JIT
Enable JIT mode to immediately run a program instead of writing an executable file.
CG_CLIF_JIT_ARGS
When JIT mode is enable pass these arguments to the program.
CG_CLIF_INCR_CACHE_DISABLE
Don't cache object files in the incremental cache. Useful during development of cg_clif to make it possible to use incremental mode for all analyses performed by rustc without caching object files when their content should have been changed by a change to cg_clif.
CG_CLIF_DISPLAY_CG_TIME
Display the time it took to perform codegen for a crate

Not yet supported