Document -Z codegen-backend in the unstable book

This commit is contained in:
Erin Power 2020-10-14 14:34:47 +02:00
parent 5565241f65
commit c50a04bba3
1 changed files with 28 additions and 0 deletions

View File

@ -0,0 +1,28 @@
# `codegen-backend`
The tracking issue for this feature is: [#77933](https://github.com/rust-lang/rust/issues/77933).
------------------------
This feature allows you to specify a path to a dynamic library to use as rustc's
code generation backend at runtime.
Set the `-Zcodegen-backend=<path>` compiler flag to specify the location of the
backend. The library must contain a function named `__rustc_codegen_backend`
with a signature of `fn() -> Box<dyn rustc_codegen_ssa::traits::CodegenBackend>`.
## Example
```rust
use rustc_codegen_ssa::traits::CodegenBackend;
struct MyBackend;
impl CodegenBackend for MyBackend {
// Implement codegen methods
}
#[no_mangle]
pub fn __rustc_codegen_backend() -> Box<dyn CodegenBackend> {
Box::new(MyBackend)
}
```