在预设的情况下,Rust 程序都会与标准函数库和 C 函数库作链接,所以我们可以轻易地让 Rust 程序能够使用操作系统所提供的线程、文件、网络等等的功能。但是这样就会有个问题,那就是我们的程序会变得必须依赖于运行在某些特定的操作系统上,而无法独立运作在无操作系统的环境中。

不使用标准函数库的 Rust 函数库

将一个 Rust 函数库设置为不使用标准函数库的方式很简单,只要在 Cargo 函数库程序项目根目录下的 src/lib.rs 文件中,加上 #![no_std] 属性即可。

例如:

#![no_std]

pub fn add_two(n: i32) -> i32 {
    n + 2
}

加上 #![no_std] 属性的 Rust 函数库内就无法去使用 std 这个 crate 下的所有功能,其中包括方便的 format!、println! 等宏,甚至连 String、Vec 等用到堆积空间的结构体都会没办法使用。

alloc

alloc 是 Rust 1.36 后正式开放的内置 crate,可以用来替代原本标准函数库内提供的用来操作堆积空间相关的结构。例如 Box、String、Vec、BTreeMap 等。

例如:

#![no_std]

pub fn separate_chars(s: String) -> Vec<char> {
    s.chars().collect()
}

以上程序会无法编译,因为现在的程序 scope 中并没有引用 String 和 Vec 结构体。

但是我们可以用 alloc 来解决这个问题,如下:

#![no_std]

extern crate alloc;

use alloc::string::String;
use alloc::vec::Vec;

pub fn separate_chars(s: String) -> Vec<char> {
    s.chars().collect()
}

alloc 也有提供 vec!、format! 宏,可以透过在 extern crate 关键字的左方或上方加上 #[macro_use] 属性,或是直接使用路径来调用。

例如:

#![no_std]

#[macro_use]
extern crate alloc;

use alloc::string::String;
use alloc::vec::Vec;


pub fn get_greeting_strings(target: &str) -> Vec<String> {
    vec![alloc::format!("Hello, {}!", target), format!("Hi, {}!", target)]
}

把 no_std 作为可选的特色

如果我们想要让我们的 Rust 函数库可以在使用标准函数库的时候提供完整功能,而在不使用标准函数库的情况下也可以提供部份功能的话,可以在 Cargo.toml 设置档中加入 [features] 区块,加入一个 no_std 设置项目(特色名称其实可以随意,但通常会取名叫 no_std)。如下:

[features]
no_std = []

接着将原先写在 src/lib.rs 内的 #![no_std] 属性改为 #![cfg_attr(feature = "no_std", no_std)] 属性,如下:

#![cfg_attr(feature = "no_std", no_std)]

pub fn add_two(n: i32) -> i32 {
    n + 2
}

至于如果有用到 alloc 这个 crate 的话,不需要像以下这样把 alloc 相关的项目也加上 #[cfg(feature = "no_std")] 属性,因为 std 其实也是去使用 alloc。像是 std::vec::Vec 和 alloc::vec::Vec 就是同样的结构体。

#![cfg_attr(feature = "no_std", no_std)]

#[cfg(feature = "no_std")]
extern crate alloc;

#[cfg(feature = "no_std")]
use alloc::string::String;
#[cfg(feature = "no_std")]
use alloc::vec::Vec;


pub fn separate_chars(s: String) -> Vec<char> {
    s.chars().collect()
}

不使用标准函数库的 Rust 应用程序

虽然 Rust 的函数库可以轻易地不去使用标准函数库,但是 Rust 的可运行应用程序就没有那么容易了。

举例来说,我们可以用以下指令创建一个项目名称叫 hello 的 Cargo 应用程序新项目:

cargo new --bin hello

然后直接使用 cargo build 指令编译出应用程序可执行文件:

cargo build

接着用 ldd 指令查看可执行文件动态链接的函数库:

ldd target/debug/hello

以 ldd 查看 Hello World 动态链接的函数库

我们可以看到,就连最简单的「Hello World」程序也用到了很多操作系统提供的函数库。

为了使 Rust 的应用程序能不相依于标准函数库,我们必须做以下几件事。

在 src/main.rs 文件中加上 #![no_std] 属性

我们也可以在 src/main.rs 文件中加上 #![no_std] 属性,让该 Rust 应用程序不去使用标准函数库。例如把刚才创建出来的 hello 应用程序项目中的 src/main.rs 文件,修改成:

#![no_std]

fn main() {
    println!("Hello, world!");
}

然后尝试使用 cargo build 指令编译出应用程序可执行文件:

cargo build

加上 no_std 后找不到 println! 宏

会发现程序项目无法成功编译了!其中一个原因是 println! 这个宏并没有被定义,因为它原本就是属于标准函数库的功能,而我们的 Rust 程序却已经声明不使用标准函数库了,自然就无法找到 println! 宏。我们可以先尝试把 println! 这个宏的程序叙述移除,只留下空的 main 函数,

#![no_std]

fn main() {
}

再次使用 cargo build 指令:

cargo build

缺少 panic_handler 与 eh_personality 的错误

会发现程序项目还是无法成功编译,这是因为 Rust 的可执行文件还会自动用到「panic」等程序运行失败时的处理机制。而 Rust 的「panic」机制属于「可插件化」(pluggable)的功能,称为「language item」,简称为「lang items」,中译为「语言项目」。语言项目提供了界面,能把一些功能从 Rust 编程语言中切割出来,在函数库内完成实作,有许多 Rust 的内置功能都是在标准函数库中实作出来的。所以当我们禁用标准函数库的时候,存在于标准函数库内的「panic」等相关实作就无法被使用了。不过通常我们不会自己去实作语言项目,因为语言项目的界面大部份不稳定(需用 #[lang = "item_name"] 属性来实作的语言项目是不稳定的,而且要用 Rust Nightly 版本才能编译),编译器甚至不会对它做类型检查。

那我们不自行实作「panic」相关的语言项目的话,还有什么方式可以让这个程序正常编译呢?

关闭堆栈解开(Stack Unwinding)

先前介绍过 Rust 错误处理的方式,在预设的情况下,当 Rust 程序发生 panic 时,会对那个时间点的堆栈数据进行「解开」的动作,这个动作会需要 eh_personality 这个语言项目的支持。因此为了要让 Rust 程序在 panic 时不「解开」堆栈,我们可以在 Cargo.toml 设置档中,加入 [profile.dev] 和 [profile.release] 区块,并将 panic 设置项目的值设为 abort。如下:

[profile.dev]
panic = "abort"

[profile.release]
panic = "abort"

如此一来不论有没有使用「release」模式来编译程序项目,程序在 panic 时都不会去「解开」堆栈。

实作 Panic

其实我们还是得实作「panic」相关的语言项目,不过还好除去堆栈解开的功能,剩下来的部份已经有稳定的界面了。将某个参数只有一个 &PanicInfo 的函数加上 #[panic_handler] 属性,可以用来实作 panic_impl 这个语言项目。这个函数即为程序在 panic 时会运行的函数。

如下:

#![no_std]

use core::panic::PanicInfo;

#[panic_handler]
fn panic(_info: &PanicInfo) -> ! {
    loop {}
}

fn main() {
}

以上程序,我们让程序在 panic 时进入无穷循环。

此时再尝试使用 cargo build 指令编译出应用程序可执行文件:

cargo build

需要 start 语言项目的错误

会发现程序项目还是无法成功编译,编译器提示需要使用 start 这个语言项目。

start 语言项目

在介绍 Rust 编程语言时,总会提到它几乎没有 Runtime 或是拥有非常小的 Runtime,这个是在指什么?其实就是 start 语言项目啦!当 Rust 程序被操作系统运行的时候,会先去启动「crt0」(C Runtime zero),这个是初始化 C 语言应用程序运行环境(如创建堆栈和初始化寄存器)的程序,当运行环境创建好后就会去启动 Rust 的 Runtime(start 语言项目),Rust 的 Runtime 会保护堆栈有无溢出、命令参数的保存以及 panic 时堆栈的「解开」功能。当一切该初始化的东西都初始化完后,Rust 的 Runtime 就会去调用 main 函数,也就是一般我们在撰写 Rust 应用程序时的程序进入点。

由于我们在代码加上了 #![no_std] 属性,因此 Rust 编译器并不会使用标准函数库中的 start 语言项目的实作。不过 start 语言项目并没有稳定的实作界面,所以我们在此就不去实作 start 语言项目了。

为了要让 Rust 应用程序在没有 start 语言项目的情况下也能够被运行,我们必须要自行决定 Rust 程序的程序进入点,所以要先在代码另外加上 #![no_main] 属性,让 Rust 编译器不要替程序产生一般的 main 进入点(「crt0」则要另外在链接时禁用,后面会提到)。如下:

#![no_std]
#![no_main]

use core::panic::PanicInfo;

#[panic_handler]
fn panic(_info: &PanicInfo) -> ! {
    loop {}
}

fn main() {
}

实作程序进入点

不同的操作系统在运行程序的时候,所使用的程序进入点并不一定相同。好比说 Linux 操作系统在运行程序的时候,会先去调用程序的 _start 函数。我们可以将程序修改如下:

#![no_std]
#![no_main]

use core::panic::PanicInfo;

#[panic_handler]
fn panic(_info: &PanicInfo) -> ! {
    loop {}
}

#[no_mangle]
pub extern fn _start() -> ! {
    loop {}
}

以上程序第 11 行到第 14 行,我们替 Rust 程序加上 Linux 操作系统的程序进入点,运行结果就是卡在一个无穷循环里。加上 pub extern 关键字和 #[no_mangle] 属性是为了要保留函数名称,确保操作系统可以调用得到。

编译可执行文件

尝试使用 cargo build 指令编译出应用程序可执行文件:

cargo build

因 crt0 而链接失败的错误

会发现程序项目还是无法成功编译,这是因为 Rust 的编译器预设会去使用「crt0」(C runtime zero)作为程序进入点,但我们在代码内使用 #![no_std] 属性,因此程序无法跟 C 语言的函数库成功作链接(link)。为了让 Rust 的编译器不使用「crt0」,在编译的时候就不能用 cargo build 来编译,而是要改用 cargo rustc 来调用并调整 Rust 编译器(也就是 rustc)在链接阶段所使用的参数。指令如下:

cargo rustc -- -C link-arg=-nostartfiles

以上指令,利用了 rustc 的 -C 参数来将链接参数 link-arg 设置为 -nostartfiles,也就是告诉 Rust 编译器不要去使用「crt0」。

如此一来就能够成功编译了!

加上 -nostartfiles 后成功编译