在預設的情況下,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 後成功編譯