Mustang 是一个用于构建完全用 Rust 编写的程序的系统，这意味着它们不依赖于 libc 或 crt1.o 的任何部分，也不链接任何 C 代码。

为什么？为了好玩！并且为了锻炼一些具有其他用途的组件（例如 rustix、origin、c-scape 和 c-gull），而这些组件恰好也是 Mustang 所需要的一部分。在未来，也许还可以用于尝试新的平台 ABIs。

Mustang 目前在 Linux 上的 Rust Nightly、x86-64、x86、aarch64 和 riscv64 上运行。它旨在支持 Rust 支持的所有 Linux 版本 （尽管目前仅测试了相对较新的版本）。它已经足够完整，可以运行

• ripgrep
• coreutils，包括 "unix" 功能集
• async-std
• tokio
• bat，包括 libgit2 的 git 支持
• cargo-watch

从可预见的未来来看，Mustang 并不关乎使任何东西更安全。主要的 libc 实现已经经过极其严格的测试和成熟。就 Mustang 而言，它是实验性的，并且有很多 unsafe。

用法

要使用它，首先安装 rust-src，这是 -Z build-std 所必需的

$ rustup component add rust-src --toolchain nightly

然后，将环境变量 RUST_TARGET_PATH 设置为 mustang/target-specs 目录的路径，这样您就可以使用 --target=… 为 mustang 目标命名。例如，在 mustang 仓库内

$ export RUST_TARGET_PATH="$PWD/mustang/target-specs"

然后，在自己的 crate 中添加对 mustang 的依赖

[dependencies]
mustang = "<current version>"

并将 mustang::can_run_this!(); 添加到顶级模块中（例如 main.rs）。在非 mustang 目标构建中，这不会做任何事情，但在 mustang 目标构建中，它会安排将 mustang 的库链接进来。

mustang::can_run_this!();

然后，使用 Rust 夜间版本编译，使用 -Z build-std 和 --target=<mustang-target>。例如

$ cargo +nightly run --quiet -Z build-std --target=x86_64-mustang-linux-gnu --example hello
Hello, world!
$

这是一个完全由 Rust 构建的 Rust 程序，说“你好，世界！”！

更多细节，mustang 有一个 env_logger 功能，您可以选择启用它，并设置 RUST_LOG 以查看 mustang 的各种功能

$ RUST_LOG=trace cargo +nightly run --quiet -Z build-std --target=x86_64-mustang-linux-gnu --example hello --features log,env_logger
[2021-06-28T06:28:31Z TRACE origin::program] Program started
[2021-06-28T06:28:31Z TRACE origin::threads] Main Thread[916066] initialized
[2021-06-28T06:28:31Z TRACE origin::program] Calling `.init_array`-registered function `0x5555558fb480(1, 0x7fffffffdb98, 0x7fffffffdba8)`
[2021-06-28T06:28:31Z TRACE origin::program] Calling `main(1, 0x7fffffffdb98, 0x7fffffffdba8)`
Hello, world!
[2021-06-28T06:28:31Z TRACE origin::program] `main` returned `0`
[2021-06-28T06:28:31Z TRACE origin::program] Program exiting
$

检查 libc 函数的使用的一个简单方法是使用 nm -u，因为上述命令配置为动态链接 libc。如果 mustang 已涵盖所有内容，则不应有输出

$ nm -u target/x86_64-mustang-linux-gnu/debug/examples/hello
$

C 运行时互操作

要使用 *-mustang-* 目标编译 C 代码，您可能需要 告诉 cc crate 使用哪个 C 编译器；例如，对于 i686-mustang-linux-gnu，将环境变量 CC_i686-mustang-linux-gnu 设置为 i686-linux-gnu-gcc。