1 # WIP Cranelift codegen backend for rust
3 > ⚠⚠⚠ Certain kinds of FFI don't work yet. ⚠⚠⚠
8 $ git clone https://github.com/bjorn3/rustc_codegen_cranelift.git
9 $ cd rustc_codegen_cranelift
10 $ ./prepare.sh # download and patch sysroot src and install hyperfine for benchmarking
16 `$cg_clif_dir` is the directory you cloned this repo into in the following instruction.
21 $ CHANNEL="release" $cg_clif_dir/cargo.sh run
24 If you compiled cg_clif in debug mode you should use `CHANNEL="debug"` instead or omit `CHANNEL="release"` completely.
29 $ rustc -Cpanic=abort -Zcodegen-backend=$cg_clif_dir/target/release/librustc_codegen_cranelift.so --sysroot $cg_clif_dir/build_sysroot/sysroot my_crate.rs
36 <dd>Enable JIT mode to immediately run a program instead of writing an executable file.</dd>
37 <dt>CG_CLIF_JIT_ARGS</dt>
38 <dd>When JIT mode is enable pass these arguments to the program.</dd>
39 <dt>CG_CLIF_INCR_CACHE_DISABLED</dt>
40 <dd>Don't cache object files in the incremental cache. Useful during development of cg_clif
41 to make it possible to use incremental mode for all analyses performed by rustc without caching
42 object files when their content should have been changed by a change to cg_clif.</dd>
43 <dt>CG_CLIF_DISPLAY_CG_TIME</dt>
44 <dd>Display the time it took to perform codegen for a crate</dd>
49 * Good non-rust abi support ([several problems](https://github.com/bjorn3/rustc_codegen_cranelift/issues/10))
50 * Checked binops ([some missing instructions in cranelift](https://github.com/CraneStation/cranelift/issues/460))
51 * Inline assembly ([no cranelift support](https://github.com/CraneStation/cranelift/issues/444), not coming soon)
52 * SIMD ([tracked here](https://github.com/bjorn3/rustc_codegen_cranelift/issues/171), some basic things work)