x86_64-unknown-linux-gnuasan

Tier: 2

Target mirroring x86_64-unknown-linux-gnu with AddressSanitizer enabled by default. The goal of this target is to allow shipping ASAN-instrumented standard libraries through rustup, enabling a fully instrumented binary without requiring nightly features (build-std). Once build-std stabilizes, this target is no longer needed and will be removed.

Target maintainers

• @jakos-sec
• @1c3t3a
• [@rust-lang/project-exploit-mitigations][project-exploit-mitigations]

Requirements

The target is for cross-compilation only. Host tools are not supported, since there is no need to have the host tools instrumented with ASAN. std is fully supported.

In all other aspects the target is equivalent to x86_64-unknown-linux-gnu.

Building the target

The target can be built by enabling it for a rustc build:

[build]
target = ["x86_64-unknown-linux-gnuasan"]

Building Rust programs

Rust programs can be compiled by adding this target via rustup:

$ rustup target add x86_64-unknown-linux-gnuasan

and then compiling with the target:

$ rustc foo.rs --target x86_64-unknown-linux-gnuasan

Testing

Created binaries will run on Linux without any external requirements.

Cross-compilation toolchains and C code

The target supports C code and should use the same toolchain target as x86_64-unknown-linux-gnu.