Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 1.48 KB

README.md

File metadata and controls

36 lines (27 loc) · 1.48 KB

Rustc LLVM Proxy

Build Status Build status Current Version Docs

Dynamically proxy LLVM calls into Rust own shared library! 🎉

Use cases

Normally there is no much need for the crate, except a couple of exotic cases:

  • Your crate is some kind build process helper that leverages LLVM (e.g. ptx-linker),
  • Your crate needs to stay up to date with Rust LLVM version (again ptx-linker),
  • You would prefer not to have dependencies on host LLVM libs (as always ptx-linker).

Usage

First, you need to make sure no other crate links your binary against system LLVM library. In case you are using llvm-sys, this can be achieved with a special feature:

[dependencies.llvm-sys]
version = "60"
features = ["no-llvm-linking", "disable-alltargets-init"]

Then all you need to do is to include the crate into your project:

[dependencies]
rustc-llvm-proxy = "0.2"
extern crate rustc_llvm_proxy;